Skip to main content
Data Infrastructure Insights
La version française est une traduction automatique. La version anglaise prévaut sur la française en cas de divergence.

Configuration d'un agent pour collecter des données (Windows/Linux)

Contributeurs
PDF

L'"Télégraf"agent Data Infrastructure Insights sert de collecte de données d'intégration. Telegraf est un agent serveur piloté par plug-in qui peut être utilisé pour collecter et signaler des mesures, des événements et des journaux. Les plug-ins d'entrée sont utilisés pour recueillir les informations souhaitées dans l'agent en accédant directement au système/système d'exploitation, en appelant des API tierces ou en écoutant des flux configurés (c.-à-d. Kafka, statsD, etc.). Les plug-ins de sortie permettent d'envoyer les metrics, les événements et les journaux collectés à partir de l'agent vers Data Infrastructure Insights.

La version actuelle de Telegraf pour Data Infrastructure Insights est 1.24.0.

Pour plus d'informations sur l'installation sur Kubernetes, rendez-vous sur la "Opérateur de surveillance NetApp Kubernetes" page.

Remarque Pour un audit et un reporting précis des données, il est fortement recommandé de synchroniser l'heure sur l'ordinateur Agent à l'aide de NTP (Network Time Protocol) ou SNTP (simple Network Time Protocol).
Remarque Si vous souhaitez vérifier les fichiers d'installation avant d'installer l'agent, reportez-vous à la section ci-dessous à la Vérification des sommes de contrôle.

Installation d'un agent

Si vous installez un collecteur de données de service et que vous n'avez pas encore configuré un agent, vous êtes invité à installer un agent pour le système d'exploitation approprié. Cette rubrique fournit des instructions pour l'installation de l'agent Telegraf sur les systèmes d'exploitation suivants :

Pour installer un agent, quelle que soit la plate-forme que vous utilisez, vous devez d'abord effectuer les opérations suivantes :

  1. Connectez-vous à l'hôte que vous utiliserez pour votre agent.

  2. Connectez-vous à votre environnement Data Infrastructure Insights et accédez à observabilité > Collectors.

  3. Cliquez sur +Data Collector et choisissez un collecteur de données à installer.

  4. Choisir la plate-forme appropriée pour votre hôte (Windows, Linux)

  5. Suivez les étapes restantes pour chaque plate-forme.

Remarque Une fois que vous avez installé un agent sur un hôte, vous n'avez pas besoin d'installer de nouveau un agent sur cet hôte.
Astuce Une fois que vous avez installé un agent sur un serveur/une machine virtuelle, Data Infrastructure Insights collecte des metrics à partir de ce système en plus de collecter les données des collecteurs que vous configurez. Ces mesures sont collectées comme "Metrics de nœud".
Remarque Si vous utilisez un proxy, lisez les instructions du proxy de votre plate-forme avant d'installer l'agent Telegraf.

Emplacements des journaux

Les messages journaux Telegraf sont redirigés de stdout vers les fichiers journaux suivants par défaut :

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

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

  • Windows : C:\Program Files\telegraf\telegraf.log

Fenêtres

Conditions préalables :

  • PowerShell doit être installé

  • Si vous êtes derrière un proxy, vous devez suivre les instructions de la section Configuration du support proxy pour Windows.

Configuration du support de proxy pour Windows

Remarque Si votre environnement utilise un proxy, lisez cette section avant de procéder à l'installation.
Remarque Les étapes ci-dessous présentent les actions nécessaires pour définir les variables d'environnement http_proxy/https_proxy. Pour certains environnements proxy, les utilisateurs peuvent également avoir besoin de définir la variable no_proxy Environment.

Pour les systèmes résidant derrière un proxy, procédez comme suit pour définir la ou les variables d'environnement https_proxy et/ou http_proxy ANTÉRIEURES à l'installation de l'agent Telegraf :

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

Installation de l'agent

Installation de Windows Agent

Procédure d'installation de l'agent sous Windows :

  1. Choisissez une clé d'accès d'agent.

  2. Copiez le bloc de commande à partir de la boîte de dialogue d'installation de l'agent. Vous pouvez cliquer sur l'icône du presse-papiers pour copier rapidement la commande dans le presse-papiers.

  3. Ouvrez une fenêtre PowerShell

  4. Collez la commande dans la fenêtre PowerShell, puis appuyez sur entrée.

  5. La commande télécharge le programme d'installation de l'agent approprié, l'installe et définit une configuration par défaut. Une fois l'opération terminée, le service agent redémarre. La commande a une clé unique et est valide pendant 24 heures.

  6. Cliquez sur Terminer ou Continuer

Une fois l'agent installé, vous pouvez utiliser les commandes suivantes pour démarrer/arrêter le service :

Start-Service telegraf
Stop-Service telegraf

Désinstallation de l'agent

Pour désinstaller l'agent sous Windows, procédez comme suit dans une fenêtre PowerShell :

  1. Arrêtez et supprimez le service Telegraf :

    Stop-Service telegraf
sc.exe delete telegraf

  2. Retirez le certificat du magasin de la vérité :

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

  3. Supprimez le dossier C:\Program Files\telegraf pour supprimer le fichier binaire, les journaux et les fichiers de configuration

  4. Supprimez la clé SYSTÈME\CurrentControlSet\Services\EventLog\application\telegraf du Registre

Mise à niveau de l'agent

Pour mettre à niveau l'agent telegraf, procédez comme suit :

  1. Arrêtez et supprimez le service telegraf :

    Stop-Service telegraf
sc.exe delete telegraf

  2. Supprimez la clé SYSTÈME\CurrentControlSet\Services\EventLog\application\telegraf du Registre

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

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

  5. "Installez le nouvel agent".

RHEL et CentOS

Conditions préalables :

  • Les commandes suivantes doivent être disponibles : curl, sudo, ping, sha256sum, openssl, et dmidecode

  • Si vous êtes derrière un proxy, vous devez suivre les instructions de la section Configuration du support proxy pour RHEL/CentOS.

Configuration de la prise en charge de Proxy pour RHEL/CentOS

Remarque Si votre environnement utilise un proxy, lisez cette section avant de procéder à l'installation.
Remarque Les étapes ci-dessous présentent les actions nécessaires pour définir les variables d'environnement http_proxy/https_proxy. Pour certains environnements proxy, les utilisateurs peuvent également avoir besoin de définir la variable no_proxy Environment.

Pour les systèmes résidant derrière un proxy, effectuez les opérations suivantes ANTÉRIEUR à l'installation de l'agent Telegraf :

  1. Définissez les variables d'environnement https_proxy et/ou http_proxy pour l'utilisateur actuel :

     export https_proxy=<proxy_server>:<proxy_port>
. Créez _/etc/default/telegraf_ et insérez des définitions pour les variables _https_proxy_ et/ou _http_proxy_ :
    https_proxy=<proxy_server>:<proxy_port>

Installation de l'agent

Installation de l'agent RHEL/CentOS

Étapes d'installation de l'agent sur RHEL/CentOS :

  1. Choisissez une clé d'accès d'agent.

  2. Copiez le bloc de commande à partir de la boîte de dialogue d'installation de l'agent. Vous pouvez cliquer sur l'icône du presse-papiers pour copier rapidement la commande dans le presse-papiers.

  3. Ouvrez une fenêtre de jeu

  4. Collez la commande dans la fenêtre Bash et appuyez sur entrée.

  5. La commande télécharge le programme d'installation de l'agent approprié, l'installe et définit une configuration par défaut. Une fois l'opération terminée, le service agent redémarre. La commande a une clé unique et est valide pendant 24 heures.

  6. Cliquez sur Terminer ou Continuer

Une fois l'agent installé, vous pouvez utiliser les commandes suivantes pour démarrer/arrêter le service :

Si votre système d'exploitation utilise le système (CentOS 7+ et RHEL 7+) :

sudo systemctl start telegraf
sudo systemctl stop telegraf

Si votre système d'exploitation n'utilise pas le système (CentOS 7+ et RHEL 7+) :

sudo service telegraf start
sudo service telegraf stop

Désinstallation de l'agent

Pour désinstaller l'agent sur RHEL/CentOS, dans un terminal Bash, procédez comme suit :

  1. Arrêtez le service 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. Supprimez l'agent Telegraf :

     yum remove telegraf
. Supprimez tous les fichiers de configuration ou de journal qui peuvent être laissés derrière :
    rm -rf /etc/telegraf*
rm -rf /var/log/telegraf*

Mise à niveau de l'agent

Pour mettre à niveau l'agent telegraf, procédez comme suit :

  1. Arrêtez le service 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. Supprimez l'agent telegraf précédent :

     yum remove telegraf
. link:#rhel-and-centos["Installez le nouvel agent"].

Ubuntu et Debian

Conditions préalables :

  • Les commandes suivantes doivent être disponibles : curl, sudo, ping, sha256sum, openssl, et dmidecode

  • Si vous êtes derrière un proxy, vous devez suivre les instructions de la section Configuration de la prise en charge du proxy pour Ubuntu/Debian.

Configuration de la prise en charge de proxy pour Ubuntu/Debian

Remarque Si votre environnement utilise un proxy, lisez cette section avant de procéder à l'installation.
Remarque Les étapes ci-dessous présentent les actions nécessaires pour définir les variables d'environnement http_proxy/https_proxy. Pour certains environnements proxy, les utilisateurs peuvent également avoir besoin de définir la variable no_proxy Environment.

Pour les systèmes résidant derrière un proxy, effectuez les opérations suivantes ANTÉRIEUR à l'installation de l'agent Telegraf :

  1. Définissez les variables d'environnement https_proxy et/ou http_proxy pour l'utilisateur actuel :

     export https_proxy=<proxy_server>:<proxy_port>
. Créez /etc/default/telegraf et insérez des définitions pour les variables _https_proxy_ et/ou _http_proxy_ :
    https_proxy=<proxy_server>:<proxy_port>

Installation de l'agent

Installation de l'agent Ubuntu/Debian

Étapes pour installer un agent sur Debian ou Ubuntu :

  1. Choisissez une clé d'accès d'agent.

  2. Copiez le bloc de commande à partir de la boîte de dialogue d'installation de l'agent. Vous pouvez cliquer sur l'icône du presse-papiers pour copier rapidement la commande dans le presse-papiers.

  3. Ouvrez une fenêtre de jeu

  4. Collez la commande dans la fenêtre Bash et appuyez sur entrée.

  5. La commande télécharge le programme d'installation de l'agent approprié, l'installe et définit une configuration par défaut. Une fois l'opération terminée, le service agent redémarre. La commande a une clé unique et est valide pendant 24 heures.

  6. Cliquez sur Terminer ou Continuer

Une fois l'agent installé, vous pouvez utiliser les commandes suivantes pour démarrer/arrêter le service :

Si votre système d'exploitation utilise systemd :

sudo systemctl start telegraf
sudo systemctl stop telegraf

Si votre système d'exploitation n'utilise pas le système :

sudo service telegraf start
sudo service telegraf stop

Désinstallation de l'agent

Pour désinstaller l'agent sur Ubuntu/Debian, dans un terminal Bash, exécutez les opérations suivantes :

  1. Arrêtez le service Telegraf :

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

  2. Supprimez l'agent Telegraf :

     dpkg -r telegraf
. Supprimez tous les fichiers de configuration ou de journal qui peuvent être laissés derrière :
    rm -rf /etc/telegraf*
rm -rf /var/log/telegraf*

Mise à niveau de l'agent

Pour mettre à niveau l'agent telegraf, procédez comme suit :

  1. Arrêtez le service telegraf :

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

  2. Supprimez l'agent telegraf précédent :

     dpkg -r telegraf
. link:#ubuntu-and-debian["Installez le nouvel agent"].

Vérification des sommes de contrôle

Le programme d'installation de l'agent Data Infrastructure Insights effectue des vérifications d'intégrité, mais certains utilisateurs peuvent vouloir effectuer leurs propres vérifications avant d'installer ou d'appliquer des artéfacts téléchargés. Pour ce faire, téléchargez le programme d'installation et générez une somme de contrôle pour le package téléchargé, puis comparez la somme de contrôle à la valeur indiquée dans les instructions d'installation.

Téléchargez le programme d'installation sans l'installer

Pour effectuer une opération de téléchargement uniquement (par opposition au téléchargement et à l'installation par défaut), les utilisateurs peuvent modifier la commande d'installation de l'agent obtenue à partir de l'interface utilisateur et supprimer l'option "installation" de fin.

Voici la procédure à suivre :

  1. Copiez l'extrait de code Agent installer comme indiqué.

  2. Au lieu de coller le fragment dans une fenêtre de commande, collez-le dans un éditeur de texte.

  3. Supprimez la commande de fin « --install » (Linux) ou « -install » (Windows).

  4. Copiez la commande entière à partir de l'éditeur de texte.

  5. Ensuite, collez-la dans votre fenêtre de commande (dans un répertoire de travail) et exécutez-la.

Non Windows (ces exemples sont pour Kubernetes ; les noms réels de scripts peuvent varier) :

  • Téléchargement et installation (par défaut) :

     installerName=cloudinsights-kubernetes.sh … && sudo -E -H ./$installerName --download –-install
* Téléchargement uniquement :
    installerName=cloudinsights-kubernetes.sh … && sudo -E -H ./$installerName --download

Windows :

  • Téléchargement et installation (par défaut) :

     !$($installerName=".\cloudinsights-windows.ps1") … -and $(&$installerName -download -install)
* Téléchargement uniquement :
    !$($installerName=".\cloudinsights-windows.ps1") … -and $(&$installerName -download)

La commande de téléchargement uniquement télécharge tous les artefacts requis depuis Data Infrastructure Insights vers le répertoire de travail. Les artefacts incluent, mais ne se limitent pas aux éléments suivants :

  • un script d'installation

  • un fichier d'environnement

  • Fichiers YAML

  • un fichier de somme de contrôle (se terminant par sha256.signed ou sha256.ps1)

Le script d'installation, le fichier d'environnement et les fichiers YAML peuvent être vérifiés à l'aide d'une inspection visuelle.

Générer une valeur de somme de contrôle

Pour générer la valeur de checksum, exécutez la commande suivante pour votre plateforme appropriée :

  • RHEL/Ubuntu :

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

Vérifier la somme de contrôle

Extraire la somme de contrôle attendue du fichier de somme de contrôle

  • Non Windows :

     openssl smime -verify -in telegraf*.sha256.signed -CAfile netapp_cert.pem -purpose any -nosigs -noverify
* Windows :
    (Get-Content telegraf.zip.sha256.ps1 -First 1).toUpper()

Installez l'image téléchargée

Une fois tous les artefacts vérifiés de manière satisfaisante, l'installation de l'agent peut être lancée en exécutant :

Non Windows :

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

Dépannage

Certaines choses à essayer si vous rencontrez des problèmes lors de la configuration d'un agent :

Problème : Essayer :

Après avoir configuré un nouveau plug-in et redémarré Telegraf, Telegraf ne démarre pas. Les journaux indiquent qu'une erreur semblable à celle qui suit : "[telegraf] erreur d'exécution de l'agent : erreur lors du chargement du fichier de configuration /etc/telegraf/telegraf.d/cloudInsights-default.conf : sorties du plug-in.http: Line <linenumber>: Configuration a spécifié les champs ["use_system_proxy"], mais ils n'ont pas été utilisés"

La version installée de Telegraf est obsolète. Suivez les étapes de cette page pour mettre à niveau l'agent pour votre plate-forme appropriée.

J'ai exécuté le script d'installation sur une ancienne installation et maintenant l'agent n'envoie pas de données

Désinstallez l'agent telegraf, puis relancez le script d'installation. Suivez les étapes mettre à niveau l'agent de cette page pour votre plate-forme appropriée.

J'ai déjà installé un agent à l'aide de Data Infrastructure Insights

Si vous avez déjà installé un agent sur votre hôte/machine virtuelle, il n'est pas nécessaire d'installer l'agent à nouveau. Dans ce cas, il vous suffit de choisir la plate-forme et la clé appropriées dans l'écran installation de l'agent, puis de cliquer sur Continuer ou Terminer.

Un agent est déjà installé, mais pas en utilisant le programme d'installation de Data Infrastructure Insights

Supprimez l'agent précédent et exécutez l'installation de l'agent Data Infrastructure Insights pour vous assurer que les paramètres par défaut du fichier de configuration sont corrects. Lorsque vous avez terminé, cliquez sur Continuer ou Terminer.

Des informations supplémentaires sont disponibles sur la "Assistance" page ou dans le "Matrice de prise en charge du Data Collector".