.TH prometheus 1 prometheus, version 2.7.1+ds (branch: debian/sid, revision: 2.7.1+ds-3+b11) .SH "NAME" prometheus - The Prometheus monitoring server .SH "SYNOPSIS" .TP \fBprometheus []\fR .SH "DESCRIPTION" The Prometheus monitoring server .SH "OPTIONS" .TP \fB-h, --help\fR Show context-sensitive help (also try --help-long and --help-man). .TP \fB--version\fR Show application version. .TP \fB--config.file="/etc/prometheus/prometheus.yml"\fR Prometheus configuration file path. .TP \fB--web.listen-address="0.0.0.0:9090"\fR Address to listen on for UI, API, and telemetry. .TP \fB--web.read-timeout=5m\fR Maximum duration before timing out read of the request, and closing idle connections. .TP \fB--web.max-connections=512\fR Maximum number of simultaneous connections. .TP \fB--web.external-url=\fR The 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. .TP \fB--web.route-prefix=\fR Prefix for the internal routes of web endpoints. Defaults to path of --web.external-url. .TP \fB--web.local-assets="/usr/share/prometheus/web/"\fR Path to static asset/templates directory. .TP \fB--web.user-assets=\fR Path to user asset directory, available at /user. .TP \fB--web.enable-lifecycle\fR Enable shutdown and reload via HTTP request. .TP \fB--web.enable-admin-api\fR Enable API endpoints for admin control actions. .TP \fB--web.console.templates="/etc/prometheus/consoles"\fR Path to the console template directory, available at /consoles. .TP \fB--web.console.libraries="/etc/prometheus/console_libraries"\fR Path to the console library directory. .TP \fB--web.page-title="Prometheus Time Series Collection and Processing Server"\fR Document title of Prometheus instance. .TP \fB--storage.tsdb.path="/var/lib/prometheus/metrics2/"\fR Base path for metrics storage. .TP \fB--storage.tsdb.retention=15d\fR [DEPRECATED] How long to retain samples in storage. This flag has been deprecated, use "storage.tsdb.retention.time" instead .TP \fB--storage.tsdb.retention.time=15d\fR How long to retain samples in storage. Overrides "storage.tsdb.retention" if this flag is set to anything other than default. .TP \fB--storage.tsdb.retention.size=0\fR [EXPERIMENTAL] Maximum number of bytes that can be stored for blocks. Units supported: KB, MB, GB, TB, PB. This flag is experimental and can be changed in future releases. .TP \fB--storage.tsdb.use-lockfile\fR Create a lockfile in data directory. .TP \fB--storage.remote.flush-deadline=\fR How long to wait flushing sample on shutdown or config reload. .TP \fB--storage.remote.read-sample-limit=5e7\fR Maximum overall number of samples to return via the remote read interface, in a single query. 0 means no limit. .TP \fB--storage.remote.read-concurrent-limit=10\fR Maximum number of concurrent remote read calls. 0 means no limit. .TP \fB--rules.alert.for-outage-tolerance=1h\fR Max time to tolerate prometheus outage for restoring 'for' state of alert. .TP \fB--rules.alert.for-grace-period=10m\fR Minimum duration between alert and restored 'for' state. This is maintained only for alerts with configured 'for' time greater than grace period. .TP \fB--rules.alert.resend-delay=1m\fR Minimum amount of time to wait before resending an alert to Alertmanager. .TP \fB--alertmanager.notification-queue-capacity=10000\fR The capacity of the queue for pending Alertmanager notifications. .TP \fB--alertmanager.timeout=10s\fR Timeout for sending alerts to Alertmanager. .TP \fB--query.lookback-delta=5m\fR The delta difference allowed for retrieving metrics during expression evaluations. .TP \fB--query.timeout=2m\fR Maximum time a query may take before being aborted. .TP \fB--query.max-concurrency=20\fR Maximum number of queries executed concurrently. .TP \fB--query.max-samples=50000000\fR Maximum number of samples a single query can load into memory. Note that queries will fail if they would load more samples than this into memory, so this also limits the number of samples a query can return. .TP \fB--web.cors.origin=".*"\fR Regex for CORS origin. It is fully anchored. Eg. 'https?://(domain1|domain2)\.com' .TP \fB--log.level=info\fR Only log messages with the given severity or above. One of: [debug, info, warn, error] .TP \fB--log.format=logfmt\fR Output format of log messages. One of: [logfmt, json]