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

發行項
06/13/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 監視器自訂計量輸出 \(英文\)。

清除資源

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

下一步

深入了解自訂計量。

共用方式為