参数

说明

--config.file="prometheus.yml"

指定主配置文件路径，默认为 prometheus.yml，包含 scrape 配置、rule files、alerting 等。

--config.auto-reload-interval=30s

自动检测配置文件变化并热重载的间隔时间（需配合 --web.enable-lifecycle 使用）。

参数

说明

--web.listen-address=0.0.0.0:9090

Web UI、API 和指标暴露的监听地址和端口。可重复设置多个监听地址。

--web.read-timeout=5m

HTTP 请求读取超时时间，防止连接长时间空闲。

--web.max-connections=512

允许的最大并发连接数。

--web.max-notifications-subscribers=16

实时通知订阅者最大数量（如 Alertmanager 通知流）。

参数

说明

--web.external-url=<URL>

当 Prometheus 被反向代理时，用于生成正确的外部访问链接（如 https://prom.example.com/metrics）。

--web.route-prefix=<path>

内部路由前缀，默认取自 --web.external-url 的路径部分。

--web.user-assets=<path>

用户自定义静态资源目录，可通过 /user/ 访问。

参数

说明

--web.enable-lifecycle

启用通过 HTTP 请求进行热重载或关闭服务（如 POST /-/reload）。

--web.enable-admin-api

启用管理 API（如删除时间序列、清理数据等），生产环境慎用。

--web.enable-remote-write-receiver

开启接收远程写入（Remote Write）的 API 端点（/api/v1/write），常用于联邦或 Agent 模式。

--web.remote-write-receiver.accepted-protobuf-messages=...

指定支持的 Protobuf 消息格式（兼容新旧版本）。

--web.enable-otlp-receiver

实验性功能：开启 OTLP（OpenTelemetry Protocol）写入接口。

参数

说明

--web.console.templates="consoles"

控制台模板目录路径，用于自定义图形化展示页面。

--web.console.libraries="console_libraries"

控制台依赖的 JS/CSS 库路径。

--web.page-title="..."

浏览器页面标题。

--web.cors.origin=".*"

CORS 跨域策略正则表达式，默认允许所有来源。建议生产环境限制。

参数

说明

--storage.tsdb.path="data/"

本地 TSDB 数据存储路径。

--storage.tsdb.retention.time=15d

数据保留时间（默认 15 天），单位支持 y/w/d/h/m/s/ms。

--storage.tsdb.retention.size="..."

数据最大磁盘占用（如 50GB），基于 2 的幂（1KB=1024B）。两者可同时设置，任一条件满足即触发清理。

--storage.tsdb.no-lockfile

不在数据目录创建锁文件（多实例写同一目录时禁用此选项）。

参数

说明

--storage.tsdb.head-chunks-write-queue-size=0

Head 区块写入磁盘队列大小，0 表示关闭队列（实验性）。

参数

说明

--storage.agent.path="data-agent/"

Agent 模式下的 WAL 存储路径。

--storage.agent.wal-compression

是否压缩 WAL 日志。

--storage.agent.retention.min-time

WAL 截断时保留的最短样本时间。

--storage.agent.retention.max-time

强制删除超过该时间的样本。

--storage.agent.no-lockfile

Agent 模式下不创建锁文件。

参数

说明

--storage.remote.flush-deadline=<duration>

关闭或重载配置前等待远程存储刷盘的最大时间。

--storage.remote.read-sample-limit=5e7

单次远程读取返回的最大样本数（0 表示无限制）。

--storage.remote.read-concurrent-limit=10

最大并发远程读请求数。

--storage.remote.read-max-bytes-in-frame=1048576

流式响应中单个 Protobuf 帧的最大字节数（默认 1MB）。

参数

说明

--rules.alert.for-outage-tolerance=1h

宕机恢复后，容忍多长时间内“for”状态不清零（避免短暂重启导致误报）。

--rules.alert.for-grace-period=10m

“for”状态恢复后的最小等待时间（仅对 for > grace period 的告警有效）。

--rules.alert.resend-delay=1m

向 Alertmanager 重发通知的最小间隔。

--rules.max-concurrent-evals=4

规则评估的最大并发数（影响性能）。

参数

说明

--alertmanager.notification-queue-capacity=10000

发送给 Alertmanager 的通知队列容量。

--alertmanager.notification-batch-size=256

每批发送给 Alertmanager 的最大通知数。

--alertmanager.drain-notification-queue-on-shutdown

关闭时是否发送完剩余告警（否则丢弃）。

参数

说明

--query.lookback-delta=5m

查询时回溯时间窗口（解决时钟不同步问题）。

--query.timeout=2m

查询最大执行时间，超时则中断。

--query.max-concurrency=20

最大并发查询数。

--query.max-samples=50000000

单个查询最多加载到内存的样本数，防止 OOM。

参数

说明

--agent

以 Agent 模式运行（仅采集 + remote_write，无本地查询、无告警）。

--enable-feature=...

启用实验性或高级功能，常见选项包括：<br>• native-histograms: 支持原生直方图<br>• exemplar-storage: 存储示例（exemplars）<br>• auto-gomaxprocs: 自动设置 GOMAXPROCS<br>• memory-snapshot-on-shutdown: 关机时保存内存快照<br>• concurrent-rule-eval: 并发执行规则

参数

说明

--auto-gomaxprocs

自动设置 Go 的 GOMAXPROCS 为容器 CPU 配额（推荐容器中启用）。

--auto-gomemlimit

自动设置 GOMEMLIMIT 以匹配容器内存限制。

--auto-gomemlimit.ratio=0.9

设置 GOMEMLIMIT 占容器/系统内存的比例（默认 90%）。

参数

说明

--log.level=info

日志级别：debug, info, warn, error。调试时可用 debug。

--log.format=logfmt

日志输出格式：logfmt（文本）或 json（便于日志收集系统解析）。