标志

参数	描述	默认值
-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 官方文档翻译而成。