prometheus
标志
参数 | 描述 | 默认值 |
---|---|---|
-h , --help | 显示上下文相关的帮助(可以尝试 --help-long 和 --help-man )。 | - |
--version | 显示应用程序版本。 | - |
--config.file | Prometheus 配置文件路径。 | prometheus.yml |
--web.listen-address | UI、API 和指标数据监听的地址。可以重复指定。 | 0.0.0.0:9090 |
--auto-gomemlimit.ratio | 预留的 GOMEMLIMIT 内存与检测到的最大容器或系统内存的比例 | 0.9 |
--web.config.file | [实验性] 配置文件路径,可启用 TLS 或认证。 | - |
--web.read-timeout | 读取请求的最大持续时间,以及关闭空闲连接的时间。 | 5m |
--web.max-connections | 所有监听器同时连接的最大数量。 | 512 |
--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 | 接收 remote write 请求时接受的remote write protobuf 消息列表。支持的值:prometheus.WriteRequest , io.prometheus.write.v2.Request | prometheus.WriteRequest |
--web.console.templates | 可访问 /consoles 目录的控制台模板目录。 | consoles |
--web.console.libraries | 控制台库目录路径。 | console_libraries |
--web.page-title | Prometheus 实例的文档标题。 | Prometheus Time Series Collection and Processing Server |
--web.cors.origin | CORS 来源正则表达式。它是完全锚定的。示例:`https?://(domain1 | domain2).com` |
--storage.tsdb.path | 元数据存储的基本路径。仅在服务器模式下使用。 | data/ |
--storage.tsdb.retention | [已弃用] 存储中保留样本的时长。此标志已被弃用,请使用 "storage.tsdb.retention.time" 而不是。仅在服务器模式下使用。 | - |
--storage.tsdb.retention.time | 存储中样本保留的时长。当此标志被设置时,它会覆盖 "storage.tsdb.retention" 。如果没有设置这个标志、"storage.tsdb.retention" 或 "storage.tsdb.retention.size" ,保留时长默认被设置为 15 天。支持的单位:y, w, d, h, m, s, ms。仅在服务器模式下使用。 | - |
--storage.tsdb.retention.size | 存储块的最大字节数。需要单位,支持的单位:B, KB, MB, GB, TB, PB, EB。示例:“512MB”。基于 2 的幂,因此 1KB 是 1024B。仅在服务器模式下使用。 | - |
--storage.tsdb.no-lockfile | 不在数据目录中创建 lockfile。仅在服务器模式下使用。 | false |
--storage.tsdb.head-chunks-write-queue-size | 通过磁盘写入头块以进行 m-mapping 的队列大小。实验性。仅在服务器模式下使用。 | 0 |
--storage.agent.path | 元数据存储的基本路径。仅在代理模式下使用。 | data-agent/ |
--storage.agent.wal-compression | 压缩代理 WAL。仅在代理模式下使用。 | 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 | 单个查询通过 remote read 接口返回的最大样本总数。0表示无限制。此限制对于流式响应类型被忽略。仅在服务器模式下使用。 | 5e7 |
--storage.remote.read-concurrent-limit | 并发 remote read 调用的最大数量。0表示无限制。仅在服务器模式下使用。 | 10 |
--storage.remote.read-max-bytes-in-frame | 流式 remote read 响应类型中单帧的最大字节数,在进行数据打包之前。注意客户端可能也有帧大小的限制。默认推荐值为 1MB。仅在服务器模式下使用。 | 1048576 |
--rules.alert.for-outage-tolerance | 恢复“for”状态的告警的 Prometheus 最大停机容忍时间。仅在服务器模式下使用。 | 1h |
--rules.alert.for-grace-period | 告警与恢复“for”状态之间保持的最短持续时间。仅在服务器模式下使用。 | 10m |
--rules.alert.resend-delay | 重新发送告警到 Alertmanager 的最小延迟时间。仅在服务器模式下使用。 | 1m |
--rules.max-concurrent-evals | 独立规则可以并行运行的最大并发限制。当设置时,“query.max-concurrency”可能需要相应调整。仅在服务器模式下使用。 | 4 |
--alertmanager.notification-queue-capacity | 待通知的 Alertmanager 通知队列容量。仅在服务器模式下使用。 | 10000 |
--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 |
--scrape.name-escaping-scheme | 当发送给不支持 UTF-8 的 Prometheus 时,用于从遗留无效名称中转义的方法。可以是 values 、underscores 或 dots 中的一个。 | values |
--enable-feature | 逗号分隔的功能名称列表,用于启用功能特性。有效选项:agent 、auto-gomaxprocs 、auto-gomemlimit 、concurrent-rule-eval 、created-timestamp-zero-ingestion 、delayed-compaction 、exemplar-storage 、expand-external-labels 、extra-scrape-metrics 、memory-snapshot-on-shutdown 、native-histograms 、new-service-discovery-manager 、no-default-scrape-port 、otlp-write-receiver 、promql-experimental-functions 、promql-delayed-name-removal 、promql-per-step-stats 、remote-write-receiver (DEPRECATED) 、utf8-names 。更多请见特性标志。 | |
--log.level | 仅记录给定严重性或以上严重性的消息。取值其中之一:[debug, info, warn, error] | info |
--log.format | 日志消息的输出格式。取值其中之一:[logfmt,json] | logfmt |
该文档基于 Prometheus 官方文档翻译而成。