【prometheus】Pushgateway安裝和使用

在本文中，我們將探討Prometheus Pushgateway的安裝與使用方法。Pushgateway是一種服務，用於暫存那些原本無法被Prometheus直接抓取的指標數據，特別適用於處理一次性或短暫性任務所生成的指標。以下將介紹如何在不同的操作系統上安裝Pushgateway，以及如何通過Prometheus配置來使其開始收集這些暫存的指標。

安裝Pushgateway

Linux系統（Debian/Ubuntu）

1. 下載二進制文件：

wget https://github.com/prometheus/pushgateway/releases/download/v1.7.0/pushgateway-1.7.0.linux-amd64.tar.gz

2. 解壓壓縮包：

tar -zxvf pushgateway-1.7.0.linux-amd64.tar.gz

3. 運行Pushgateway：

./pushgateway-1.7.0.linux-amd64/bin/pushgateway --log.level=debug --web.listen-address=":9091"

macOS系統

對於macOS用戶，你可以從Homebrew或其他軟件管理器獲取`pushgateway`。然而，爲了確保獲得最新版本，建議直接從官方網站下載二進制文件。

Windows系統

由於Windows系統的特殊性，你可能需要考慮使用WSL或者虛擬機環境來部署Pushgateway。在這種情況下，可以使用上述Linux部分的指導進行操作。

配置Prometheus

一旦Pushgateway成功安裝並啓動後，你需要在Prometheus的配置文件中添加相應的規則來抓取通過Pushgateway暴露的指標。以下是一些基本的步驟來設置Prometheus以監控Pushgateway:

1. 在Prometheus配置文件的`scrape_configs`部分添加新的目標：

- job_name: 'pushgateway'
static_configs:
- targets: ['localhost:9091']

2. (可選) 如果需要，可以指定標籤和重採樣規則。例如，你可以爲每個通過Pushgateway推送的數據增加一個特定的標籤：

relabel_configs:
# Add a label to all metrics coming from the Pushgateway so we can identify them in Prometheus
- source_labels: [__meta_pushgateway_job]
action: labeldrop
regex: non_pushgateway_jobs

3. 重啓Prometheus服務器以確保新配置生效。

使用Pushgateway

現在你已經有了Pushgateway的服務和一個指向它的Prometheus配置，你可以開始使用它了。下面是如何通過HTTP接口向Pushgateway發送指標數據的示例：

1. 發送指標：

POST /metrics/job/my_job/task/my_task HTTP/1.1
Host: localhost:9091
Content-Type: text/plain; version=0.0.4; charset=utf-8

# HELP my_metric A description of what this metric measures
# TYPE my_metric gauge
my_metric{some_tag="value"} 123.45

2. 驗證指標是否已存儲：

訪問`http://localhost:9091/metrics`，你應該能看到所有通過Pushgateway暫存的指標。如果一切正常，Prometheus應該也會定期抓取這些指標並在其UI中顯示出來。

請注意，Pushgateway的設計原則並不是作爲持久化存儲解決方案，而是作爲一種臨時機制來幫助那些難以直接被Prometheus抓取的任務。因此，在使用時應考慮到這一點，並且在適當的時候遷移到更合適的長期存儲方案。