使用 InfluxData Telegraf 代理程式收集 Linux 虛擬機器的自訂計量

發行項
10/15/2024

本文說明如何在 Linux 虛擬機器上部署和設定 InfluxData Telegraf 代理程式，以便將計量傳送至 Azure 監視器。

注意

InfluxData Telegraf 是開放原始碼代理程式，不受 Azure 監視器正式支援。有關 Telegraf 連接器的問題，請參閱此 Telegraf GitHub 頁面：InfluxData

InfluxData Telegraf 代理程式

Telegraf 是外掛程式驅動的代理程式，能夠從 150 個不同的來源收集計量。根據 VM 上執行的工作負載而定，您可以將代理程式設定為使用特製化輸入外掛程式來收集計量。範例包括 MySQL、NGINX 和 Apache。藉由使用輸出外掛程式，代理程式即可寫入至您選擇的目的地。 Telegraf 代理程式與 Azure 監視器自訂計量 REST API 直接整合。可支援 Azure 監視器輸出外掛程式。代理程式可以使用此外掛程式，收集 Linux VM 上的工作負載特有計量，並作為自訂計量提交至 Azure 監視器。

連線至 VM

為要安裝 Telegraf 的 VM 建立 SSH 連線。在虛擬機器的 [概觀] 頁面上，選取 [連線] 按鈕。

在 [連線至虛擬機器] 頁面中，保留以 DNS 名稱透過連接埠 22 進行連線的預設選項。在 [使用 VM 本機帳戶登入] 中，會顯示連線命令。選取按鈕以複製該命令。下列範例說明 SSH 連線命令的內容：

ssh azureuser@XXXX.XX.XXX

將 SSH 連線命令貼到殼層中 (例如 Azure Cloud Shell、Windows 上 Ubuntu 的 Bash)，或使用您選擇的 SSH 用戶端來建立連線。

安裝並設定 Telegraf

若要將 Telegraf Debian 套件安裝到 VM 上，請從 SSH 工作階段執行下列命令：

Ubuntu、Debian
RHEL，Oracle Linux

新增存放庫：

# download the package to the VM
curl -s https://repos.influxdata.com/influxdb.key | sudo apt-key add -
source /etc/lsb-release
sudo echo "deb https://repos.influxdata.com/${DISTRIB_ID,,} ${DISTRIB_CODENAME} stable" | sudo tee /etc/apt/sources.list.d/influxdb.list
sudo curl -fsSL https://repos.influxdata.com/influxdata-archive_compat.key | sudo apt-key --keyring /etc/apt/trusted.gpg.d/influxdata-archive_compat.gpg add

安裝套件：

   sudo apt-get update
   sudo apt-get install telegraf

新增存放庫：

cat <<EOF | sudo tee /etc/yum.repos.d/influxdb.repo
[influxdb]
name = InfluxDB Repository - RHEL $releasever
baseurl = https://repos.influxdata.com/rhel/$releasever/$basearch/stable
enabled = 1
gpgcheck = 1
gpgkey = https://repos.influxdata.com/influxdata-archive_compat.key
EOF

安裝套件：

   sudo yum -y install telegraf

Telegraf 的組態檔會定義 Telegraf 的作業。根據預設，範例組態檔會安裝在 /etc/telegraf/telegraf.conf 路徑。範例組態檔會列出所有可能的輸入與輸出外掛程式。不過，我們將建立自訂組態檔，並透過執行下列命令讓代理程式使用它：

# generate the new Telegraf config file in the current directory
telegraf --input-filter cpu:mem --output-filter azure_monitor config > azm-telegraf.conf

# replace the example config with the new generated config
sudo cp azm-telegraf.conf /etc/telegraf/telegraf.conf

注意

上述程式碼只能啟用兩個輸入外掛程式：cpu 和 mem。視您電腦上執行的工作負載而定，您可以新增更多輸入外掛程式。範例包括 Docker、MySQL 和 NGINX。如需輸入外掛程式的完整清單，請參閱其他設定一節。

最後，執行下列命令強制停止並啟動代理程式，讓代理程式使用新設定來啟動：

# stop the telegraf agent on the VM
sudo systemctl stop telegraf
# start and enable the telegraf agent on the VM to ensure it picks up the latest configuration
sudo systemctl enable --now telegraf

代理程式現在會從每個指定的輸入外掛程式收集計量，並向 Azure 監視器發出計量。

在 Azure 入口網站中繪製 Telegraf 計量

開啟 Azure 入口網站。
瀏覽至新的 [監視] 索引標籤。然後選取 [計量]。
在資源選取器中選取您的 VM。
選取 Telegraf/CPU 命名空間，然後選取 usage_system 計量。您可以根據此計量的維度來選擇篩選條件，或分割它們。

其他設定

上述逐步解說提供如何設定 Telegraf 代理程式以從幾個基本輸入外掛程式收集計量的資訊。Telegraf 代理程式可支援超過 150 種輸入外掛程式，還支援一些其他設定選項。 InfluxData 已發佈支援的外掛程式清單 \(英文\) 以及如何設定 \(英文\) 的指示。

此外，在此逐步解說中，您使用了 Telegraf 代理程式發出該代理程式部署所在 VM 的相關計量。 Telegraf 代理程式也可用來作為其他資源計量的收集器與轉寄站。若要了解如何設定代理程式發出其他 Azure 資源的計量，請參閱 Telegraf 的 Azure 監視器自訂計量輸出 \(英文\)。

清除資源

若不再需要，您可以刪除資源群組、虛擬機器和所有相關資源。若要這樣做，請選取虛擬機器的資源群組，再選取 [刪除]。然後確認要刪除的資源群組名稱。

下一步

深入了解自訂計量。

共用方式為