Raccogliere metriche personalizzate per una macchina virtuale Linux con l’agente InfluxDataTelegraph

Questo articolo illustra come distribuire e configurare l'agente InfluxData Telegraf in una macchina virtuale Linux per inviare metriche a Monitoraggio di Azure.

Agente InfluxData Telegraf

Telegraf è un agente basato su plug-in che consente la raccolta delle metriche di oltre 150 origini diverse. A seconda dei carichi di lavoro eseguiti sulla macchina virtuale è possibile configurare l'agente per usare plug-in di input specializzati per raccogliere le metriche. Tra gli esempi vi sono Apache, MySQL e NGINX. Tramite i plug-in di output, l'agente può quindi scrivere nelle destinazioni scelte dall'utente. L'agente Telegraf si integra direttamente nell'API REST di metriche personalizzate di Monitoraggio di Azure. e supporta un plug-in di output di Monitoraggio di Azure. Usando questo plug-in, l'agente può raccogliere metriche specifiche del carico di lavoro nella VM Linux e inviarle come metriche personalizzate a Monitoraggio di Azure.

Connettersi alla macchina virtuale

Creare una connessione SSH alla macchina virtuale in cui si vuole installare Telegraph. Selezionare il pulsante Connetti nella pagina di panoramica della macchina virtuale.

Nella pagina Connetti a macchina virtuale mantenere le opzioni predefinite per la connessione con nome DNS sulla porta 22. In Accedi con l'account locale della macchina virtuale viene visualizzato un comando di connessione. Fare clic sul pulsante per copiare il comando. Di seguito è mostrato un esempio di comando di connessione SSH:

ssh azureuser@XXXX.XX.XXX

Incollare il comando di connessione SSH in una shell, ad esempio Azure Cloud Shell o Bash in Ubuntu in Windows, oppure usare un client SSH qualsiasi per creare la connessione.

Installare e configurare Telegraf

Per installare il pacchetto Debian Telegraf nella VM, eseguire i comandi seguenti dalla sessione SSH:

# 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

Il file di configurazione di Telegraph definisce le operazioni Telegraph. Per impostazione predefinita, un file di configurazione di esempio viene installato nel percorso /etc/telegraf/telegraf.conf. Il file di configurazione di esempio elenca tutti i plug-in di input e output possibili. Si creerà tuttavia un file di configurazione personalizzato, che verrà usato dall'agente eseguendo i comandi seguenti:

# 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

Infine, affinché l'agente usi la nuova configurazione, vengono forzati l'arresto e l'avvio dell'agente eseguendo i comandi seguenti:

# 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

A questo punto l'agente raccoglie le metriche da ogni plug-in di input specificato e le invia a Monitoraggio di Azure.

Tracciare le metriche Telegraf nel portale di Azure

1. Apri il portale di Azure.

2. Passare alla nuova scheda Monitoraggio. Selezionare quindi Metriche.

3. Selezionare la macchina virtuale nel selettore di risorse.

4. Selezionare lo spazio dei nomi Telegraf/CPU e la metrica usage_system. È possibile scegliere di filtrare in base alle dimensioni in questa metrica o dividerle.

   

Configurazione aggiuntiva

La procedura dettagliata precedente fornisce informazioni su come configurare l'agente Telegraf per la raccolta delle metriche da alcuni plug-in di input di base. L'agente Telegraf supporta più di 150 plug-in di input con alcune opzioni di configurazione aggiuntive. InfluxData ha pubblicato un elenco di plug-in supportati e le istruzioni su come configurarli.

Inoltre, questa procedura dettagliata ha consentito di usare l'agente Telegraf per generare metriche sulla macchina virtuale in cui è distribuito l'agente. L'agente Telegraf può essere usato anche come agente di raccolta e servizio di inoltro di metriche per altre risorse. Per informazioni su come configurare l'agente per la generazione di metriche per altre risorse di Azure, vedere Azure Monitor Custom Metric Output for Telegraf (Output di metriche personalizzate di Monitoraggio di Azure per Telegraf).

Pulire le risorse

Quando non servono più è possibile eliminare il gruppo di risorse, la macchina virtuale e tutte le risorse correlate. A tale scopo selezionare il gruppo di risorse per la macchina virtuale e fare clic su Elimina. Confermare quindi il nome del gruppo di risorse da eliminare.

Passaggi successivi

• Altre informazioni sulle metriche personalizzate.