Prometheus
Prometheus 监控服务器
标志
| 命令行标志 | 描述 | 默认值 |
|---|---|---|
-h, --help | 显示上下文相关帮助（也可以尝试 --help-long 和 --help-man）。 | |
--version | 显示应用程序版本。 | |
--config.file | Prometheus 配置文件路径。 | prometheus.yml |
--config.auto-reload-interval | 指定检查并自动重新加载 Prometheus 配置文件的时间间隔，以检测更改。 | 30s |
--web.listen-address ... | 用于 UI、API 和遥测的监听地址。可以重复。 | 0.0.0.0:9090 |
--auto-gomaxprocs | 自动设置 GOMAXPROCS 以匹配 Linux 容器 CPU 配额 | true |
--auto-gomemlimit | 自动设置 GOMEMLIMIT 以匹配 Linux 容器或系统内存限制 | true |
--auto-gomemlimit.ratio | 保留的 GOMEMLIMIT 内存与检测到的最大容器或系统内存的比例 | 0.9 |
--web.config.file | [实验性] 配置文件路径，可用于启用 TLS 或身份验证。 | |
--web.read-timeout | 读取请求之前的最大超时时长，并关闭空闲连接。 | 5m |
--web.max-connections | 所有监听器同时连接的最大数量。 | 512 |
--web.max-notifications-subscribers | 限制可以同时接收实时通知的订阅者最大数量。如果达到限制，将拒绝新的订阅请求，直到现有连接关闭。 | 16 |
--web.external-url | Prometheus 可从外部访问的 URL（例如，如果 Prometheus 通过反向代理提供服务）。用于生成指向 Prometheus 本身的相对和绝对链接。如果 URL 具有路径部分，则将用于为 Prometheus 提供的所有 HTTP 端点添加前缀。如果省略，相关 URL 组件将自动派生。 | |
--web.route-prefix | Web 端点内部路由的前缀。默认为 --web.external-url 的路径。 | |
--web.user-assets | 静态资源目录的路径，可在 /user 访问。 | |
--web.enable-lifecycle | 通过 HTTP 请求启用关闭和重新加载。 | false |
--web.enable-admin-api | 启用用于管理员控制操作的 API 端点。 | false |
--web.enable-remote-write-receiver | 启用接受远程写入请求的 API 端点。 | false |
--web.remote-write-receiver.accepted-protobuf-messages | 接收远程写入时要接受的远程写入 protobuf 消息列表。支持的值：prometheus.WriteRequest, io.prometheus.write.v2.Request | prometheus.WriteRequest |
--web.enable-otlp-receiver | 启用接受 OTLP 写入请求的 API 端点。 | false |
--web.console.templates | 控制台模板目录的路径，可在 /consoles 访问。 | consoles |
--web.console.libraries | 控制台库目录的路径。 | console_libraries |
--web.page-title | Prometheus 实例的文档标题。 | Prometheus 时间序列收集和处理服务器 |
--web.cors.origin | CORS 源的正则表达式。它是完全固定的。示例：'https?://(domain1|domain2).com' | .* |
--storage.tsdb.path | 指标存储的基路径。仅与服务器模式一起使用。 | data/ |
--storage.tsdb.retention.time | [已弃用] 样本在存储中保留多长时间。如果未设置此标志或“storage.tsdb.retention.size”，则保留时间默认为 15 天。支持的单位：y, w, d, h, m, s, ms。此标志已被弃用，请改用配置文件中的 storage.tsdb.retention.time 字段。仅与服务器模式一起使用。 | |
--storage.tsdb.retention.size | [已弃用] 可为块存储的最大字节数。需要单位，支持的单位：B, KB, MB, GB, TB, PB, EB。例如：“512MB”。基于 2 的幂，所以 1KB 是 1024B。此标志已被弃用，请改用配置文件中的 storage.tsdb.retention.size 字段。仅与服务器模式一起使用。 | |
--storage.tsdb.no-lockfile | 不在数据目录中创建锁文件。仅与服务器模式一起使用。 | false |
--storage.tsdb.head-chunks-write-queue-size | 用于将头部块写入磁盘以进行 m-mapping 的队列大小，0 完全禁用队列。实验性。仅与服务器模式一起使用。 | 0 |
--storage.tsdb.delay-compact-file.path | 包含已上传 TSDB 块的 JSON 文件的路径，例如 Thanos shipper meta 文件。如果设置，TSDB 将只压缩在该文件中标记为已上传的 1 级块，从而改进与 Thanos 侧车等的外部存储集成。1 级以上的压缩不会被延迟。仅与服务器模式一起使用。 | |
--storage.agent.path | 指标存储的基路径。仅与代理模式一起使用。 | data-agent/ |
--storage.agent.wal-compression | 压缩代理 WAL。如果为 false，则忽略 --storage.agent.wal-compression-type 标志。仅与代理模式一起使用。 | true |
--storage.agent.retention.min-time | 在截断 WAL 时，样本在被考虑删除之前的最小年龄。仅与代理模式一起使用。 | |
--storage.agent.retention.max-time | 在截断 WAL 时，样本在被强制删除之前的最大年龄。仅与代理模式一起使用。 | |
--storage.agent.no-lockfile | 不在数据目录中创建锁文件。仅与代理模式一起使用。 | false |
--storage.remote.flush-deadline | 关闭或重新加载配置时，等待冲刷样本的时长。 | 1m |
--storage.remote.read-sample-limit | 通过远程读取接口单次查询可以返回的样本总数上限。0 表示无限制。此限制对于流式响应类型将被忽略。仅与服务器模式一起使用。 | 5e7 |
--storage.remote.read-concurrent-limit | 并发远程读取调用的最大数量。0 表示无限制。仅与服务器模式一起使用。 | 10 |
--storage.remote.read-max-bytes-in-frame | 用于流式远程读取响应类型的单个帧中的最大字节数，在编组之前。请注意，客户端可能也有帧大小限制。默认推荐值为 1MB（来自 protobuf）。仅与服务器模式一起使用。 | 1048576 |
--rules.alert.for-outage-tolerance | 容忍 Prometheus 停机时间以恢复警报“for”状态的最大时间。仅与服务器模式一起使用。 | 1h |
--rules.alert.for-grace-period | 警报和已恢复的“for”状态之间的最小持续时间。这仅适用于配置了“for”时间大于宽限期的警报。仅与服务器模式一起使用。 | 10m |
--rules.alert.resend-delay | 在将警报重发给 Alertmanager 之前等待的最短时间。仅与服务器模式一起使用。 | 1m |
--rules.max-concurrent-evals | 独立规则可以并发运行的全局并发限制。设置此值时，可能需要相应地调整“query.max-concurrency”。仅与服务器模式一起使用。 | 4 |
--alertmanager.notification-queue-capacity | 待处理 Alertmanager 通知队列的容量。仅与服务器模式一起使用。 | 10000 |
--alertmanager.notification-batch-size | 发送到 Alertmanager 的每个通知批次的最大数量。仅与服务器模式一起使用。 | 256 |
--alertmanager.drain-notification-queue-on-shutdown | 在关闭时发送所有待处理的 Alertmanager 通知。如果为 false，则在关闭时将丢弃所有待处理的 Alertmanager 通知。仅与服务器模式一起使用。 | true |
--query.lookback-delta | 在表达式评估和联合期间检索指标的最大回溯时长。仅与服务器模式一起使用。 | 5m |
--query.timeout | 查询可能需要的最长中止时间。仅与服务器模式一起使用。 | 2m |
--query.max-concurrency | 并发执行的最大查询数量。仅与服务器模式一起使用。 | 20 |
--query.max-samples | 单个查询可以加载到内存中的最大样本数。请注意，尝试加载超过此数量的样本的查询将失败，因此这也会限制查询可以返回的样本数量。仅与服务器模式一起使用。 | 50000000 |
--enable-feature ... | 要启用的逗号分隔的功能名称。有效选项：exemplar-storage, expand-external-labels, memory-snapshot-on-shutdown, promql-per-step-stats, promql-experimental-functions, extra-scrape-metrics, auto-gomaxprocs, created-timestamp-zero-ingestion, concurrent-rule-eval, delayed-compaction, old-ui, otlp-deltatocumulative, promql-duration-expr, use-uncached-io, promql-extended-range-selectors。更多详情请参阅 https://prometheus.ac.cn/docs/prometheus/latest/feature_flags/。 | |
--agent | 以“代理模式”运行 Prometheus。 | |
--log.level | 仅记录给定严重性或更高级别的消息。可选值：[debug, info, warn, error] | info |
--log.format | 日志消息的输出格式。可选值：[logfmt, json] | logfmt |