參數名稱
含義
備注
--version
顯示應用的版本信息
配置文件參數
--config.file="prometheus.yml"
Prometheus配置文件路徑
WEB服務參數
--web.listen-address="0.0.0.0:9090"
UI、API、遙測(telemetry)監聽地址
--web.read-timeout=5m
讀取請求和關閉空閑連接的最大超時時間
默認值:5m
--web.max-connections=512
最大同時連接數
默認值:512
--web.external-url=<URL>
可從外部訪問普羅米修斯的URL
如果Prometheus存在反向代理時使用,用於生成相對或者絕對鏈接,返回到Prometheus本身,如果URL存在路徑部分,它將用於給Prometheus服務的所有HTTP端點加前綴,如果省略,將自動派生相關的URL組件。
--web.route-prefix=<path>
Web端點的內部路由
默認路徑:--web.external-url
--web.user-assets=<path>
靜態資產目錄的路徑
在/user路徑下生效可用
--web.enable-lifecycle
通過HTTP請求啟用關閉(shutdown)和重載(reload)
--web.enable-admin-api
啟用管理員行為API端點
--web.console.templates="consoles"
總線模板目錄路徑
在/consoles路徑下生效可用
--web.console.libraries="console_libraries"
總線庫文件目錄路徑
--web.page-title="Prometheus Time Series Collection and Processing Server"
Prometheus實例的文檔標題
--web.cors.origin=".*"
CORS來源的正則Regex,是完全錨定的
例如:'https?://(domain1|domain2).com'
數據存儲參數
--storage.tsdb.path="data/"
指標存儲的根路徑
--storage.tsdb.retention=STORAGE.TSDB.RETENTION
[DEPRECATED]樣例存儲時間
此標簽已經丟棄,用"storage.tsdb.retention.time"替代
--storage.tsdb.retention.time=STORAGE.TSDB.RETENTION.TIME
存儲時長,如果此參數設置了,會覆蓋"storage.tsdb.retention"參數;如果設置了"storage.tsdb.retention" 或者"storage.tsdb.retention.size"參數,存儲時間默認是15d(天),單位:y, w, d, h, m, s, ms
--storage.tsdb.retention.size=STORAGE.TSDB.RETENTION.SIZE
[EXPERIMENTAL]試驗性的。存儲為塊的最大字節數,需要使用一個單位,支持:B, KB, MB, GB,TB, PB, EB
此標簽處於試驗中,未來版本會改變
--storage.tsdb.no-lockfile
不在data目錄下創建鎖文件
--storage.tsdb.allow-overlapping-blocks
[EXPERIMENTAL]試驗性的。允許重疊塊,可以支持垂直壓縮和垂直查詢合並。
--storage.tsdb.wal-compression
壓縮tsdb的WAL
WAL(Write-ahead logging, 預寫日志),WAL被分割成默認大小為128M的文件段(segment),之前版本默認大小是256M,文件段以數字命名,長度為8位的整形。WAL的寫入單位是頁(page),每頁的大小為32KB,所以每個段大小必須是頁的大小的整數倍。如果WAL一次性寫入的頁數超過一個段的空閑頁數,就會創建一個新的文件段來保存這些頁,從而確保一次性寫入的頁不會跨段存儲。
--storage.remote.flush-deadline=<duration>
關閉或者配置重載時刷新示例的等待時長
--storage.remote.read-sample-limit=5e7
在單個查詢中通過遠程讀取接口返回的最大樣本總數。0表示無限制。對於流式響應類型,將忽略此限制。
--storage.remote.read-concurrent-limit=10
最大並發遠程讀取調用數。0表示無限制。
--storage.remote.read-max-bytes-in-frame=1048576
在封送處理之前,用於流式傳輸遠程讀取響應類型的單個幀中的最大字節數。請注意,客戶機可能對幀大小也有限制。
默認情況下,protobuf建議使用1MB。
告警規則相關參數
--rules.alert.for-outage-tolerance=1h
允許prometheus中斷以恢復“for”警報狀態的最長時間。
--rules.alert.for-grace-period=10m
警報和恢復的“for”狀態之間的最短持續時間。這僅對配置的“for”時間大於寬限期的警報進行維護。
--rules.alert.resend-delay=1m
向Alertmanager重新發送警報之前等待的最短時間。
告警管理中心相關參數
--alertmanager.notification-queue-capacity=10000
掛起的Alertmanager通知的隊列容量。
默認值:10000
--alertmanager.timeout=10s
發送告警到Alertmanager的超時時間
默認值:10s
數據查詢參數
--query.lookback-delta=5m
通過表達式解析和聯合檢索指標的最大反饋時間
默認值:5m
--query.timeout=2m
查詢中止前可能需要的最長時間。
默認值:2m
--query.max-concurrency=20
並發(concurrently)執行查詢的最大值
--query.max-samples=50000000
單個查詢可以加載到內存中的最大樣本數。注意,如果查詢試圖將更多的樣本加載到內存中,則會失敗,因此這也限制了查詢可以返回的樣本數。
數量級:5千萬
日志信息參數
--log.level=info
僅記錄給定的日志級別及以上的信息
可選參數值:[debug, info, warn, error],其中之一
--log.format=logfmt
日志信息輸出格式
可選參數值:[logfmt, json],其中之一