prometheus

The Prometheus monitoring server

Flags

FlagDescriptionDefault
-h, --helpShow context-sensitive help (also try --help-long and --help-man).
--versionShow application version.
--config.filePrometheus configuration file path.prometheus.yml
--config.auto-reload-intervalSpecifies the interval for checking and automatically reloading the Prometheus configuration file upon detecting changes.30s
--web.listen-address ...Address to listen on for UI, API, and telemetry. Can be repeated.0.0.0.0:9090
--auto-gomaxprocsAutomatically set GOMAXPROCS to match Linux container CPU quotatrue
--auto-gomemlimitAutomatically set GOMEMLIMIT to match Linux container or system memory limittrue
--auto-gomemlimit.ratioThe ratio of reserved GOMEMLIMIT memory to the detected maximum container or system memory0.9
--web.config.file[EXPERIMENTAL] Path to configuration file that can enable TLS or authentication.
--web.read-timeoutMaximum duration before timing out read of the request, and closing idle connections.5m
--web.max-connectionsMaximum number of simultaneous connections across all listeners.512
--web.max-notifications-subscribersLimits the maximum number of subscribers that can concurrently receive live notifications. If the limit is reached, new subscription requests will be denied until existing connections close.16
--web.external-urlThe URL under which Prometheus is externally reachable (for example, if Prometheus is served via a reverse proxy). Used for generating relative and absolute links back to Prometheus itself. If the URL has a path portion, it will be used to prefix all HTTP endpoints served by Prometheus. If omitted, relevant URL components will be derived automatically.
--web.route-prefixPrefix for the internal routes of web endpoints. Defaults to path of --web.external-url.
--web.user-assetsPath to static asset directory, available at /user.
--web.enable-lifecycleEnable shutdown and reload via HTTP request.false
--web.enable-admin-apiEnable API endpoints for admin control actions.false
--web.enable-remote-write-receiverEnable API endpoint accepting remote write requests.false
--web.remote-write-receiver.accepted-protobuf-messagesList of the remote write protobuf messages to accept when receiving the remote writes. Supported values: prometheus.WriteRequest, io.prometheus.write.v2.Requestprometheus.WriteRequest
--web.enable-otlp-receiverEnable API endpoint accepting OTLP write requests.false
--web.console.templatesPath to the console template directory, available at /consoles.consoles
--web.console.librariesPath to the console library directory.console_libraries
--web.page-titleDocument title of Prometheus instance.Prometheus Time Series Collection and Processing Server
--web.cors.originRegex for CORS origin. It is fully anchored. Example: 'https?://(domain1|domain2).com'.*
--storage.tsdb.pathBase path for metrics storage. Use with server mode only.data/
--storage.tsdb.retention.timeHow long to retain samples in storage. If neither this flag nor "storage.tsdb.retention.size" is set, the retention time defaults to 15d. Units Supported: y, w, d, h, m, s, ms. Use with server mode only.
--storage.tsdb.retention.sizeMaximum number of bytes that can be stored for blocks. A unit is required, supported units: B, KB, MB, GB, TB, PB, EB. Ex: "512MB". Based on powers-of-2, so 1KB is 1024B. Use with server mode only.
--storage.tsdb.no-lockfileDo not create lockfile in data directory. Use with server mode only.false
--storage.tsdb.head-chunks-write-queue-sizeSize of the queue through which head chunks are written to the disk to be m-mapped, 0 disables the queue completely. Experimental. Use with server mode only.0
--storage.agent.pathBase path for metrics storage. Use with agent mode only.data-agent/
--storage.agent.wal-compressionCompress the agent WAL. If false, the --storage.agent.wal-compression-type flag is ignored. Use with agent mode only.true
--storage.agent.retention.min-timeMinimum age samples may be before being considered for deletion when the WAL is truncated Use with agent mode only.
--storage.agent.retention.max-timeMaximum age samples may be before being forcibly deleted when the WAL is truncated Use with agent mode only.
--storage.agent.no-lockfileDo not create lockfile in data directory. Use with agent mode only.false
--storage.remote.flush-deadlineHow long to wait flushing sample on shutdown or config reload.1m
--storage.remote.read-sample-limitMaximum overall number of samples to return via the remote read interface, in a single query. 0 means no limit. This limit is ignored for streamed response types. Use with server mode only.5e7
--storage.remote.read-concurrent-limitMaximum number of concurrent remote read calls. 0 means no limit. Use with server mode only.10
--storage.remote.read-max-bytes-in-frameMaximum number of bytes in a single frame for streaming remote read response types before marshalling. Note that client might have limit on frame size as well. 1MB as recommended by protobuf by default. Use with server mode only.1048576
--rules.alert.for-outage-toleranceMax time to tolerate prometheus outage for restoring "for" state of alert. Use with server mode only.1h
--rules.alert.for-grace-periodMinimum duration between alert and restored "for" state. This is maintained only for alerts with configured "for" time greater than grace period. Use with server mode only.10m
--rules.alert.resend-delayMinimum amount of time to wait before resending an alert to Alertmanager. Use with server mode only.1m
--rules.max-concurrent-evalsGlobal concurrency limit for independent rules that can run concurrently. When set, "query.max-concurrency" may need to be adjusted accordingly. Use with server mode only.4
--alertmanager.notification-queue-capacityThe capacity of the queue for pending Alertmanager notifications. Use with server mode only.10000
--alertmanager.notification-batch-sizeThe maximum number of notifications per batch to send to the Alertmanager. Use with server mode only.256
--alertmanager.drain-notification-queue-on-shutdownSend any outstanding Alertmanager notifications when shutting down. If false, any outstanding Alertmanager notifications will be dropped when shutting down. Use with server mode only.true
--query.lookback-deltaThe maximum lookback duration for retrieving metrics during expression evaluations and federation. Use with server mode only.5m
--query.timeoutMaximum time a query may take before being aborted. Use with server mode only.2m
--query.max-concurrencyMaximum number of queries executed concurrently. Use with server mode only.20
--query.max-samplesMaximum number of samples a single query can load into memory. Note that queries will fail if they try to load more samples than this into memory, so this also limits the number of samples a query can return. Use with server mode only.50000000
--enable-feature ...Comma separated feature names to enable. Valid options: exemplar-storage, expand-external-labels, memory-snapshot-on-shutdown, promql-per-step-stats, promql-experimental-functions, extra-scrape-metrics, auto-gomaxprocs, native-histograms, created-timestamp-zero-ingestion, concurrent-rule-eval, delayed-compaction, old-ui, otlp-deltatocumulative, promql-duration-expr. See https://prometheus.io/docs/prometheus/latest/feature_flags/ for more details.
--agentRun Prometheus in 'Agent mode'.
--log.levelOnly log messages with the given severity or above. One of: [debug, info, warn, error]info
--log.formatOutput format of log messages. One of: [logfmt, json]logfmt

On this page