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 | 头块通过队列写入磁盘以进行内存映射的大小，0 表示完全禁用队列。实验性功能。仅在服务器模式下使用。 | 0 |
--storage.tsdb.delay-compact-file.path | 包含已上传 TSDB 块的 JSON 文件路径，例如 Thanos shipper 元文件。如果设置，TSDB 将只压缩在该文件中标记为已上传的 1 级块，从而改善外部存储集成，例如与 Thanos sidecar 的集成。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 | 流式远程读取响应类型在编组前单个帧中的最大字节数。请注意，客户端也可能对帧大小有限制。默认为 protobuf 建议的 1MB。仅在服务器模式下使用。 | 1048576 |
--rules.alert.for-outage-tolerance | 恢复告警“for”状态时，Prometheus 故障的最大容忍时间。仅在服务器模式下使用。 | 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, st-storage, concurrent-rule-eval, delayed-compaction, old-ui, otlp-deltatocumulative, promql-duration-expr, use-uncached-io, promql-extended-range-selectors, promql-binop-fill-modifiers, xor2-encoding。有关更多详细信息，请参阅 https://prometheus.ac.cn/docs/prometheus/latest/feature_flags/。 | |
--agent | 以“代理模式”运行 Prometheus。 | |
--log.level | 仅记录具有给定严重级别或更高级别的消息。之一：[debug, info, warn, error] | info |
--log.format | 日志消息的输出格式。之一：[logfmt, json] | logfmt |