Skip to main content
Data Infrastructure Insights
Se proporciona el idioma español mediante traducción automática para su comodidad. En caso de alguna inconsistencia, el inglés precede al español.

Configuración de un agente para recopilar datos (Windows/Linux)

Colaboradores netapp-alavoie dgracenetapp netapp-mjryan
PDF

Data Infrastructure Insights utiliza"Telégrafo" como su agente para la recopilación de datos de integración. Telegraf es un agente de servidor controlado por complementos que se puede utilizar para recopilar e informar métricas, eventos y registros. Los complementos de entrada se utilizan para recopilar la información deseada en el agente accediendo directamente al sistema/SO, llamando a API de terceros o escuchando transmisiones configuradas (es decir, Kafka, statsD, etc.). Los complementos de salida se utilizan para enviar las métricas, los eventos y los registros recopilados del agente a Data Infrastructure Insights.

Para obtener información sobre la instalación en Kubernetes, consulte"Operador de monitorización de Kubernetes de NetApp" página.

Nota Para obtener informes de datos y auditorías precisos, se recomienda encarecidamente sincronizar la hora en la máquina del Agente mediante Protocolo de tiempo de red (NTP) o Protocolo simple de tiempo de red (SNTP).
Nota Si desea verificar los archivos de instalación antes de instalar el Agente, consulte la sección a continuación sobreVerificación de las sumas de comprobación de los paquetes Telegraf .

Instalación de un agente

Si está instalando un recopilador de datos de servicio y aún no ha configurado un Agente, se le solicitará que primero instale un Agente para el sistema operativo apropiado. Este tema proporciona instrucciones para instalar el agente Telegraf en los siguientes sistemas operativos:

Para instalar un agente, independientemente de la plataforma que esté utilizando, primero debe hacer lo siguiente:

  1. Inicie sesión en el host que utilizará para su agente.

  2. Inicie sesión en su entorno de Data Infrastructure Insights y navegue a Observabilidad > Recopiladores.

  3. Haga clic en +Recopilador de datos y elija un recopilador de datos para instalar.

  4. Elija la plataforma adecuada para su host (Windows, Linux)

  5. Siga los pasos restantes para cada plataforma.

Nota Una vez que haya instalado un agente en un host, no necesitará instalar otro agente nuevamente en ese host.
Consejo Una vez que haya instalado un agente en un servidor/máquina virtual, Data Infrastructure Insights recopila métricas de ese sistema además de recopilarlas de cualquier recopilador de datos que configure. Estas métricas se recopilan como"Métricas de "nodo"" .
Nota Si está utilizando un proxy, lea las instrucciones del proxy para su plataforma antes de instalar el agente Telegraf.

Ubicaciones de registros

Los mensajes de registro de Telegraf se redirigen desde stdout a los siguientes archivos de registro de forma predeterminada:

  • RHEL/CentOS: /var/log/telegraf/telegraf.log

  • Ubuntu/Debian: /var/log/telegraf/telegraf.log

  • Windows: C:\Archivos de programa\telegraf\telegraf.log

Ventanas

Prerrequisitos:

  • PowerShell debe estar instalado

  • Si está detrás de un proxy, debe seguir las instrucciones de la sección Configuración de soporte de proxy para Windows.

Configuración de la compatibilidad con proxy para Windows

Nota Si su entorno utiliza un proxy, lea esta sección antes de realizar la instalación.
Nota Los pasos a continuación describen las acciones necesarias para configurar las variables de entorno http_proxy/https_proxy. Para algunos entornos de proxy, los usuarios también pueden necesitar configurar la variable de entorno no_proxy.

Para los sistemas que residen detrás de un proxy, realice lo siguiente para configurar las variables de entorno https_proxy y/o http_proxy ANTES de instalar el agente Telegraf:

[System.Environment]:SetEnvironmentVariable(“https_proxy”, “<proxy_server>:<proxy_port>”, [System.EnvironmentVariableTarget]:Machine)

Instalación del agente

Instalación del agente de Windows

Pasos para instalar el agente en Windows:

  1. Elija una clave de acceso de agente.

  2. Copie el bloque de comando del cuadro de diálogo de instalación del agente. Puede hacer clic en el icono del portapapeles para copiar rápidamente el comando al portapapeles.

  3. Abrir una ventana de PowerShell

  4. Pegue el comando en la ventana de PowerShell y presione Entrar.

  5. El comando descargará el instalador del agente apropiado, lo instalará y establecerá una configuración predeterminada. Cuando termine, se reiniciará el servicio del agente. El comando tiene una clave única y es válido por 24 horas.

  6. Haga clic en Finalizar o Continuar

Una vez instalado el agente, puede utilizar los siguientes comandos para iniciar o detener el servicio:

Start-Service telegraf
Stop-Service telegraf

Desinstalación del agente

Para desinstalar el agente en Windows, haga lo siguiente en una ventana de PowerShell:

  1. Detener y eliminar el servicio Telegraf:

    Stop-Service telegraf
sc.exe delete telegraf

  2. Eliminar el certificado del almacén de confianza:

    cd Cert:\CurrentUser\Root
//rm E5FB7B68C08B1CA902708584C274F8EFC7BE8ABC
rm 1A918038E8E127BB5C87A202DF173B97A05B4996

  3. Elimine la carpeta C:\Program Files\telegraf para eliminar los archivos binarios, de registro y de configuración

  4. Elimine la clave SYSTEM\CurrentControlSet\Services\EventLog\Application\telegraf del registro

Actualización del agente

Para actualizar el agente de telegraf, haga lo siguiente:

  1. Detener y eliminar el servicio de telégrafo:

    Stop-Service telegraf
sc.exe delete telegraf

  2. Eliminar la clave SYSTEM\CurrentControlSet\Services\EventLog\Application\telegraf del registro

  3. Eliminar C:\Program Files\telegraf\telegraf.conf

  4. Eliminar C:\Program Files\telegraf\telegraf.exe

  5. "Instalar el nuevo agente" .

RHEL y CentOS

Prerrequisitos:

  • Los siguientes comandos deben estar disponibles: curl, sudo, ping, sha256sum, openssl y dmidecode

  • Si está detrás de un proxy, debe seguir las instrucciones de la sección Configuración de soporte de proxy para RHEL/CentOS.

Configuración de la compatibilidad de proxy para RHEL/CentOS

Nota Si su entorno utiliza un proxy, lea esta sección antes de realizar la instalación.
Nota Los pasos a continuación describen las acciones necesarias para configurar las variables de entorno http_proxy/https_proxy. Para algunos entornos de proxy, los usuarios también pueden necesitar configurar la variable de entorno no_proxy.

Para los sistemas que residen detrás de un proxy, realice los siguientes pasos ANTES de instalar el agente Telegraf:

  1. Establezca las variables de entorno https_proxy y/o http_proxy para el usuario actual:

     export https_proxy=<proxy_server>:<proxy_port>
. Cree _/etc/default/telegraf_ e inserte definiciones para las variables _https_proxy_ y/o _http_proxy_:
    https_proxy=<proxy_server>:<proxy_port>

Instalación del agente

Instalación del agente Rhel/CentOS

Pasos para instalar el agente en RHEL/CentOS:

  1. Elija una clave de acceso de agente.

  2. Copie el bloque de comando del cuadro de diálogo de instalación del agente. Puede hacer clic en el icono del portapapeles para copiar rápidamente el comando al portapapeles.

  3. Abrir una ventana de Bash

  4. Pegue el comando en la ventana de Bash y presione Enter.

  5. El comando descargará el instalador del agente apropiado, lo instalará y establecerá una configuración predeterminada. Cuando termine, se reiniciará el servicio del agente. El comando tiene una clave única y es válido por 24 horas.

  6. Haga clic en Finalizar o Continuar

Una vez instalado el agente, puede utilizar los siguientes comandos para iniciar o detener el servicio:

Si su sistema operativo utiliza systemd (CentOS 7+ y RHEL 7+):

sudo systemctl start telegraf
sudo systemctl stop telegraf

Si su sistema operativo no utiliza systemd (CentOS 7+ y RHEL 7+):

sudo service telegraf start
sudo service telegraf stop

Desinstalación del agente

Para desinstalar el agente en RHEL/CentOS, en una terminal Bash, haga lo siguiente:

  1. Detener el servicio Telegraf:

    systemctl stop telegraf (If your operating system is using systemd (CentOS 7+ and RHEL 7+)
/etc/init.d/telegraf stop (for systems without systemd support)

  2. Eliminar el agente Telegraf:

     yum remove telegraf
. Elimine cualquier archivo de configuración o registro que pueda quedar:
    rm -rf /etc/telegraf*
rm -rf /var/log/telegraf*

Actualización del agente

Para actualizar el agente de telegraf, haga lo siguiente:

  1. Detener el servicio de telégrafo:

    systemctl stop telegraf (If your operating system is using systemd (CentOS 7+ and RHEL 7+)
/etc/init.d/telegraf stop (for systems without systemd support)

  2. Eliminar el agente telegraf anterior:

     yum remove telegraf
. link:#rhel-and-centos["Instalar el nuevo agente"] .

Ubuntu y Debian

Prerrequisitos:

  • Los siguientes comandos deben estar disponibles: curl, sudo, ping, sha256sum, openssl y dmidecode

  • Si está detrás de un proxy, debe seguir las instrucciones de la sección Configuración de soporte de proxy para Ubuntu/Debian.

Configuración de la compatibilidad con proxy para Ubuntu/Debian

Nota Si su entorno utiliza un proxy, lea esta sección antes de realizar la instalación.
Nota Los pasos a continuación describen las acciones necesarias para configurar las variables de entorno http_proxy/https_proxy. Para algunos entornos de proxy, los usuarios también pueden necesitar configurar la variable de entorno no_proxy.

Para los sistemas que residen detrás de un proxy, realice los siguientes pasos ANTES de instalar el agente Telegraf:

  1. Establezca las variables de entorno https_proxy y/o http_proxy para el usuario actual:

     export https_proxy=<proxy_server>:<proxy_port>
. Cree /etc/default/telegraf e inserte definiciones para las variables _https_proxy_ y/o _http_proxy_:
    https_proxy=<proxy_server>:<proxy_port>

Instalación del agente

Instalación del agente de Ubuntu/Debian

Pasos para instalar el agente en Debian o Ubuntu:

  1. Elija una clave de acceso de agente.

  2. Copie el bloque de comando del cuadro de diálogo de instalación del agente. Puede hacer clic en el icono del portapapeles para copiar rápidamente el comando al portapapeles.

  3. Abrir una ventana de Bash

  4. Pegue el comando en la ventana de Bash y presione Enter.

  5. El comando descargará el instalador del agente apropiado, lo instalará y establecerá una configuración predeterminada. Cuando termine, se reiniciará el servicio del agente. El comando tiene una clave única y es válido por 24 horas.

  6. Haga clic en Finalizar o Continuar

Una vez instalado el agente, puede utilizar los siguientes comandos para iniciar o detener el servicio:

Si su sistema operativo utiliza systemd:

sudo systemctl start telegraf
sudo systemctl stop telegraf

Si su sistema operativo no utiliza systemd:

sudo service telegraf start
sudo service telegraf stop

Desinstalación del agente

Para desinstalar el agente en Ubuntu/Debian, en una terminal Bash, ejecute lo siguiente:

  1. Detener el servicio Telegraf:

    systemctl stop telegraf (If your operating system is using systemd)
/etc/init.d/telegraf stop (for systems without systemd support)

  2. Eliminar el agente Telegraf:

     dpkg -r telegraf
. Elimine cualquier archivo de configuración o registro que pueda quedar:
    rm -rf /etc/telegraf*
rm -rf /var/log/telegraf*

Actualización del agente

Para actualizar el agente de telegraf, haga lo siguiente:

  1. Detener el servicio de telégrafo:

    systemctl stop telegraf (If your operating system is using systemd)
/etc/init.d/telegraf stop (for systems without systemd support)

  2. Eliminar el agente telegraf anterior:

     dpkg -r telegraf
. link:#ubuntu-and-debian["Instalar el nuevo agente"] .

Verificación de las sumas de comprobación de los paquetes Telegraf

El instalador del agente de Data Infrastructure Insights realiza comprobaciones de integridad, pero es posible que algunos usuarios quieran realizar sus propias verificaciones antes de instalar el binario de Telegraf descargado. Esto se puede hacer descargando el instalador y generando una suma de verificación para el paquete descargado, luego comparando la suma de verificación con el valor que se muestra en las instrucciones de instalación.

Descargue el paquete de instalación sin instalar

Para realizar una operación de solo descarga (a diferencia de la descarga e instalación predeterminada), los usuarios pueden editar el comando de instalación del agente obtenido de la interfaz de usuario y eliminar la opción "instalar".

Siga estos pasos:

  1. Copie el fragmento del instalador del agente según las instrucciones.

  2. En lugar de pegar el fragmento en una ventana de comandos, péguelo en un editor de texto.

  3. Elimine el “--install” (Linux) o “-install” (Windows) final del comando.

  4. Copia el comando completo desde el editor de texto.

  5. Ahora péguelo en su ventana de comandos (en un directorio de trabajo) y ejecútelo.

No Windows (estos ejemplos son para Kubernetes; los nombres de los scripts reales pueden variar):

  • Descargar e instalar (predeterminado):

     installerName=cloudinsights-ubuntu_debian.sh … && ./$installerName --download --verify && sudo -E -H ./$installerName --install
* Sólo descarga:
    installerName=cloudinsights-ubuntu_debian.sh … && ./$installerName --download --verify

Ventanas:

  • Descargar e instalar (predeterminado):

     !$($installerName=".\cloudinsights-windows.ps1") … -and $(if(((Get-FileHash $installerName).Hash).ToLower() -eq "INSTALLER_CHECKSUM ") { &$installerName -download -verify -install } else { Write-Host "Install script checksum does not match"})"
* Sólo descarga:
    !$($installerName=".\cloudinsights-windows.ps1") … -and $(if(((Get-FileHash $installerName).Hash).ToLower() -eq "INSTALLER_CHECKSUM ") { &$installerName -download -verify } else { Write-Host "Install script checksum does not match"})"

El comando de solo descarga descargará todos los artefactos necesarios de Data Infrastructure Insights al directorio de trabajo. Los artefactos incluyen, pero no se limitan a:

  • un script de instalación

  • un archivo de entorno

  • un binario de Telegraf

  • una firma para el binario Telegraf

  • un certificado público para verificar la firma binaria

El fragmento de instalación descargado y copiado desde DII verifica automáticamente la suma de comprobación del script de instalación, y la firma del binario de Telegraf es verificada por el script de instalación.

Verificar el valor de la suma de comprobación

Para generar el valor de suma de comprobación, ejecute el siguiente comando para su plataforma adecuada:

  • RHEL/Ubuntu:

     sha256sum <package_name>
* Ventanas:
    Get-FileHash telegraf.zip -Algorithm SHA256 | Format-List

Instalar el paquete descargado

Una vez que se hayan verificado satisfactoriamente todos los artefactos, se puede iniciar la instalación del agente ejecutando:

No Windows:

 sudo -E -H ./<installation_script_name> --install
Ventanas:
.\cloudinsights-windows.ps1 -install

Creación y uso de tokens de acceso a la API

Para crear un token de acceso API para la ingesta de datos de Telegraf, realice una de las siguientes acciones:

Crear a través de la página de instalación del recopilador de datos

  1. Vaya a la página de instalación de Data Collector para la plataforma que desea utilizar (Windows, Linux).

  2. Crea un token con el botón + Token de acceso API.

  3. Ingrese un nombre y haga clic en guardar.

  4. El nombre del token ahora debe seleccionarse en el menú desplegable y se utilizará al instalar el recopilador.

Crear manualmente un token de acceso a la API

  1. Vaya a Admin>Acceso API.

  2. Haga clic en + Token de acceso API.

  3. Ingrese un nombre y opcionalmente una descripción.

  4. En “¿Qué tipo de API se usarán con este token para llamar?”, seleccione solo “Ingestión de datos” y luego desmarque “Unidad de adquisición”.

  5. En “Permisos” seleccione Lectura/Escritura.

  6. Desmarque “Rotar tokens automáticamente para Kubernetes”.

Para utilizar el token de acceso API recién creado, selecciónelo en el menú desplegable “Seleccionar token de acceso API existente o crear uno nuevo” en la página del instalador. Tenga en cuenta que solo se pueden utilizar tokens con las siguientes propiedades:

  • Tipo de API: solo “Ingestión de datos”

  • Permisos: Lectura/Escritura

  • Rotación automática de Kubernetes: Desactivada

Solución de problemas

Algunas cosas que puedes probar si tienes problemas al configurar un agente:

Problema: Prueba esto:

Después de configurar un nuevo complemento y reiniciar Telegraf, Telegraf no puede iniciarse. Los registros indican que se produjo un error similar al siguiente: "[telegraf] Error al ejecutar el agente: Error al cargar el archivo de configuración /etc/telegraf/telegraf.d/cloudinsights-default.conf: plugin outputs.http: línea <linenumber>: la configuración especificó los campos ["use_system_proxy"], pero no se utilizaron"

La versión de Telegraf instalada está desactualizada. Siga los pasos de esta página para Actualizar el agente para su plataforma adecuada.

Ejecuté el script de instalación en una instalación antigua y ahora el agente no envía datos

Desinstale el agente telegraf y vuelva a ejecutar el script de instalación. Siga los pasos para Actualizar el agente en esta página para su plataforma adecuada.

Ya instalé un agente usando Data Infrastructure Insights

Si ya ha instalado un agente en su host/VM, no necesita instalarlo nuevamente. En este caso, simplemente elija la Plataforma y la Clave adecuadas en la pantalla de Instalación del Agente y haga clic en Continuar o Finalizar.

Ya tengo un agente instalado pero no mediante el instalador de Data Infrastructure Insights

Elimine el agente anterior y ejecute la instalación del agente de Data Infrastructure Insights para garantizar la configuración correcta del archivo de configuración predeterminado. Cuando haya terminado, haga clic en Continuar o Finalizar.

Información adicional se puede encontrar en el"Soporte" página o en el"Matriz de soporte del recopilador de datos" .