Nota
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Este artículo explica cómo implementar y configurar el agente de InfluxData Telegraf en una máquina virtual Linux para enviar métricas a Azure Monitor.
Nota:
InfluxData Telegraf es un agente de código abierto y no se admite oficialmente en Azure Monitor. Si tiene problemas con el conector de Telegraf, consulte la página de Telegraf en GitHub aquí: InfluxData
Agente de Telegraf de InfluxData
Telegraf es un agente controlado por complementos que habilita la recopilación de métricas de más de 150 orígenes diferentes. En función de las cargas de trabajo que se ejecutan en la máquina virtual Linux, puede configurar el agente para que use complementos de entrada especializados para recopilar métricas. Algunos ejemplos son MySQL, NGINX y Apache. Mediante el uso de complementos de salida, el agente puede escribir en los destinos que se elijan. El agente de Telegraf se integra directamente con la API REST de métricas personalizadas de Azure Monitor. Admite un complemento de salida de Azure Monitor. Cuando se usa este complemento, el agente puede recopilar métricas específicas de la carga de trabajo en la máquina virtual Linux y enviarlas como métricas personalizadas a Azure Monitor.
Conexión a la máquina virtual
Cree una conexión SSH a la máquina virtual donde desea instalar Telegraf. Seleccione el botón Conectar en la página de información general de la máquina virtual.
En la página Conectarse a la máquina virtual , mantenga las opciones predeterminadas para conectarse por nombre del sistema de nombres de dominio (DNS) a través del puerto 22. En Iniciar sesión con la cuenta local de VM se muestra un comando de conexión. Para copiar el comando, seleccione el botón . En el ejemplo siguiente se muestra el aspecto que tiene el comando de conexión SSH:
ssh azureuser@XXXX.XX.XXX
Pegue el comando de conexión SSH en un shell, como Azure Cloud Shell o Bash en Ubuntu o Windows, o bien use un cliente de SSH de su elección para crear la conexión.
Instalación y configuración de Telegraf
Para instalar el paquete de Telegraf para Debian en la máquina virtual, ejecute los siguientes comandos desde la sesión SSH:
Agregue el repositorio:
# 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
Instala el paquete:
sudo apt-get update
sudo apt-get install telegraf
El archivo de configuración de Telegraf define las operaciones de Telegraf. De forma predeterminado, se instala un archivo de configuración de ejemplo en la ruta de acceso /etc/telegraf/telegraf.conf. En el archivo de configuración de ejemplo se enumeran todos los complementos de entrada y salida posibles. Sin embargo, cree un archivo de configuración personalizado y haga que el agente lo use mediante la ejecución de los siguientes comandos:
# 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
Nota:
El código anterior solo habilita dos complementos de entrada: cpu y mem. Puede agregar más complementos de entrada, en función de la carga de trabajo que se ejecute en la máquina. Algunos ejemplos son Docker, MySQL y NGINX. Para obtener una lista completa de los complementos de entrada, consulte la sección Otras configuraciones .
Por último, para que el agente se inicie con la nueva configuración, hacemos que el agente se detenga y se inicie mediante los siguientes comandos:
# 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
Ahora, el agente recopilará las métricas de cada uno de los complementos de entrada especificados y los emitirá a Azure Monitor.
Trazado de las métricas de Telegraf en Azure Portal
Abra Azure Portal.
Vaya a la pestaña Supervisar. Seleccione Métricas.
Seleccione la máquina virtual en el selector de recursos.
Seleccione el espacio de nombres Telegraf/CPU y la métrica usage_system. Puede elegir filtrar por las dimensiones de esta métrica, o dividir según dichas dimensiones.
Otras configuraciones
En el tutorial anterior se proporciona información sobre cómo configurar el agente de Telegraf para recopilar métricas de algunos complementos de entrada básicos. El agente de Telegraf admite más de 150 complementos de entrada, con algunas opciones de configuración compatibles. InfluxData publicó una lista de complementos admitidos e instrucciones sobre cómo configurarlos.
Además, en este tutorial, ha usado el agente de Telegraf para emitir métricas sobre la máquina virtual en la que se implementa el agente. El agente Telegraf también se puede usar como un recopilador y reenviador de métricas para otros recursos. Para obtener más información sobre cómo configurar el agente para que emita métricas para otros recursos de Azure, consulte Azure Monitor Custom Metric Output for Telegraf (Salida de métricas personalizadas de Azure Monitor para Telegraf).
Limpieza de recursos
Cuando ya no los necesite, puede eliminar el grupo de recursos, la máquina virtual y todos los recursos relacionados. Para ello, seleccione el grupo de recursos de la máquina virtual y seleccione Eliminar. Después, confirme el nombre del grupo de recursos que hay que eliminar.
Pasos siguientes
- Más información acerca de las métricas personalizadas.