prometheus
Prometheus 监控服务器
标志
| 参数 | 描述 | 默认值 |
|---|---|---|
-h, --help | 显示上下文相关的帮助信息（亦可尝试 --help-long 和 --help-man）。 | |
--version | 显示应用程序版本。 | |
--config.file | Prometheus 配置文件路径。 | prometheus.yml |
--config.auto-reload | 启用配置文件自动重载。另请参阅 --config.auto-reload-interval。 | false |
--config.auto-reload-interval | 指定在检测到更改时检查并自动重载 Prometheus 配置文件的时间间隔。仅在设置了 --config.auto-reload 时生效。 | 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 | 启用接收远程写入（remote write）请求的 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 | 指标存储的基础路径。仅在服务器模式（server mode）下使用。 | data/ |
--storage.tsdb.retention.time | [已弃用] 样本在存储中的保留时间。如果未设置此参数，也未设置 "storage.tsdb.retention.size"，则保留时间默认为 15d。支持的单位：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 | 内存块（head chunks）写入磁盘以进行内存映射（m-map）的队列大小，0 会完全禁用队列。实验性功能。仅在服务器模式下使用。 | 0 |
--storage.tsdb.delay-compact-file.path | 包含已上传 TSDB 数据块的 JSON 文件路径（例如 Thanos shipper 元数据文件）。如果设置此参数，TSDB 将仅压缩该文件中标记为已上传的 1 级数据块，从而改善与外部存储的集成（例如与 Thanos sidecar 配合）。1 级以上的压缩不会被延迟。仅在服务器模式下使用。 | |
--storage.agent.path | 指标存储的基础路径。仅在代理模式（agent mode）下使用。 | data-agent/ |
--storage.agent.wal-compression | 压缩代理 WAL（预写日志）。如果为 false，则忽略 --storage.agent.wal-compression-type 参数。仅在代理模式下使用。 | true |
--storage.agent.retention.min-time | 截断 WAL 时，在考虑将其删除之前样本必须达到的最小存活时间。仅在代理模式下使用。 | 5m |
--storage.agent.retention.max-time | 截断 WAL 时，样本被强制删除前的最大存活时间。仅在代理模式下使用。 | 4h |
--storage.agent.checkpoint-from-in-memory-series | 构建检查点时仅使用内存中的序列数据。仅在代理模式下使用。 | false |
--storage.agent.checkpoint-batch-size | 要刷新的单个 WAL 日志条目块的大小。若未指定 --storage.agent.checkpoint-from-in-memory-series 参数，则此参数无效果。仅在代理模式下使用。 | 1000 |
--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 |
--web.search.max-limit | 实验性搜索 API (--enable-feature=search-api) 所接受的 "limit" 查询参数的硬上限。限制更高的请求将被拒绝并返回 HTTP 400。0 表示不设上限。仅在服务器模式下使用。 | 10000 |
--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 | 在表达式求值和联邦（federation）期间检索指标的最大回溯持续时间。仅在服务器模式下使用。 | 5m |
--query.timeout | 查询在被中止前可能消耗的最大时间。仅在服务器模式下使用。 | 2m |
--query.max-concurrency | 并发执行的最大查询数。仅在服务器模式下使用。 | 20 |
--query.max-samples | 单个查询可以加载到内存中的最大样本数。请注意，如果查询尝试加载超过此数量的样本到内存中，则会失败，因此这也限制了查询可以返回的样本数。仅在服务器模式下使用。 | 50000000 |
--enable-feature ... | 要启用的特性名称，以逗号分隔。有效选项：concurrent-rule-eval, created-timestamp-zero-ingestion, delayed-compaction, exemplar-storage, extra-scrape-metrics, memory-snapshot-on-shutdown, metadata-wal-records, old-ui, otlp-deltatocumulative, otlp-native-delta-ingestion, promql-binop-fill-modifiers, promql-delayed-name-removal, promql-duration-expr, promql-experimental-functions, promql-extended-range-selectors, promql-per-step-stats, search-api, st-storage, st-synthesis, type-and-unit-labels, use-start-timestamps, use-uncached-io, xor2-encoding。详情请参阅 https://prometheus.ac.cn/docs/prometheus/latest/feature_flags/。 | |
--agent | 在“代理模式”（Agent mode）下运行 Prometheus。 | |
--log.level | 仅记录指定严重级别或以上的日志消息。可选值：[debug, info, warn, error] | info |
--log.format | 日志消息的输出格式。可选值：[logfmt, json] | logfmt |