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.golang.com.tw/docs/prometheus/latest/feature_flags/。 | |
--agent | 在“代理模式”（Agent mode）下執行 Prometheus。 | |
--log.level | 僅記錄指定嚴重級別或以上的日誌訊息。可選值：[debug, info, warn, error] | info |
--log.format | 日誌訊息的輸出格式。可選值：[logfmt, json] | logfmt |