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 netapp-alavoie dgracenetapp netapp-mjryan
PDF

Utilisations de Data Infrastructure Insights"Télégraphe" en tant qu'agent de collecte des données d'intégration. Telegraf est un agent serveur piloté par plugin qui peut être utilisé pour collecter et signaler des métriques, des événements et des journaux. Les plugins d'entrée sont utilisés pour collecter les informations souhaitées dans l'agent en accédant directement au système/OS, en appelant des API tierces ou en écoutant des flux configurés (c'est-à-dire Kafka, statsD, etc.). Les plugins de sortie sont utilisés pour envoyer les métriques, les événements et les journaux collectés de l'agent à Data Infrastructure Insights.

Pour plus d'informations sur l'installation sur Kubernetes, consultez le"Opérateur de surveillance NetApp Kubernetes" page.

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

Installation d'un agent

Si vous installez un collecteur de données de service et que vous n'avez pas encore configuré d'agent, vous êtes invité à installer d'abord 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 plateforme 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é > Collecteurs.

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

  4. Choisissez la plateforme appropriée pour votre hébergeur (Windows, Linux)

  5. Suivez les étapes restantes pour chaque plateforme.

Remarque Une fois que vous avez installé un agent sur un hôte, vous n’avez pas besoin d’installer à 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 métriques à partir de ce système en plus de celles collectées à partir de tous les collecteurs de données que vous configurez. Ces mesures sont collectées comme"Métriques « Node »" .
Remarque Si vous utilisez un proxy, lisez les instructions du proxy pour votre plateforme 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

Windows

Prérequis :

  • PowerShell doit être installé

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

Configuration de la prise en charge du proxy pour Windows

Remarque Si votre environnement utilise un proxy, lisez cette section avant de procéder à l'installation.
Remarque Les étapes ci-dessous décrivent 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 d'environnement no_proxy.

Pour les systèmes résidant derrière un proxy, procédez comme suit pour définir les variables d'environnement https_proxy et/ou http_proxy AVANT d'installer l'agent Telegraf :

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

Installation de l'agent

Installation de l'agent Windows

Étapes pour installer l'agent sur 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. Ouvrir une fenêtre PowerShell

  4. Collez la commande dans la fenêtre PowerShell et appuyez sur Entrée.

  5. La commande téléchargera le programme d'installation de l'agent approprié, l'installera et définira une configuration par défaut. Une fois terminé, le service de l'agent redémarrera. La commande possède une clé unique et est valable 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êter et supprimer le service Telegraf :

    Stop-Service telegraf
sc.exe delete telegraf

  2. Supprimer le certificat du trustore :

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

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

  4. Supprimez la clé SYSTEM\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é SYSTEM\CurrentControlSet\Services\EventLog\Application\telegraf du registre

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

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

  5. "Installer le nouvel agent" .

RHEL et CentOS

Prérequis :

  • 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 RHEL/CentOS.

Configuration de la prise en charge du 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 décrivent 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 d'environnement no_proxy.

Pour les systèmes résidant derrière un proxy, effectuez les étapes suivantes AVANT d'installer 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 les définitions des variables _https_proxy_ et/ou _http_proxy_ :
    https_proxy=<proxy_server>:<proxy_port>

Installation de l'agent

Installation de l'agent Rhel/CentOS

Étapes pour installer 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. Ouvrir une fenêtre Bash

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

  5. La commande téléchargera le programme d'installation de l'agent approprié, l'installera et définira une configuration par défaut. Une fois terminé, le service de l'agent redémarrera. La commande possède une clé unique et est valable 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 (CentOS 7+ et RHEL 7+) :

sudo systemctl start telegraf
sudo systemctl stop telegraf

Si votre système d'exploitation n'utilise pas systemd (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. Supprimer l'agent Telegraf :

     yum remove telegraf
. Supprimez tous les fichiers de configuration ou journaux qui pourraient ê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. Supprimer l'agent Telegraf précédent :

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

Ubuntu et Debian

Prérequis :

  • 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 du 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 décrivent 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 d'environnement no_proxy.

Pour les systèmes résidant derrière un proxy, effectuez les étapes suivantes AVANT d'installer 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 les définitions des 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 l'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. Ouvrir une fenêtre Bash

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

  5. La commande téléchargera le programme d'installation de l'agent approprié, l'installera et définira une configuration par défaut. Une fois terminé, le service de l'agent redémarrera. La commande possède une clé unique et est valable 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 systemd :

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 ce qui 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. Supprimer l'agent Telegraf :

     dpkg -r telegraf
. Supprimez tous les fichiers de configuration ou journaux qui pourraient ê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. Supprimer l'agent Telegraf précédent :

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

Vérification des sommes de contrôle des packages Telegraf

Le programme d'installation de l'agent Data Infrastructure Insights effectue des contrôles d'intégrité, mais certains utilisateurs peuvent souhaiter effectuer leurs propres vérifications avant d'installer le binaire Telegraf téléchargé. Cela peut être fait en téléchargeant le programme d'installation et en générant une somme de contrôle pour le package téléchargé, puis en comparant la somme de contrôle à la valeur indiquée dans les instructions d'installation.

Téléchargez le package 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 « installer ».

Suivez ces étapes :

  1. Copiez l’extrait du programme d’installation de l’agent comme indiqué.

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

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

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

  5. Collez-le maintenant dans votre fenêtre de commande (dans un répertoire de travail) et exécutez-le.

Non-Windows (ces exemples concernent Kubernetes ; les noms de script réels peuvent varier) :

  • Télécharger et installer (par défaut) :

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

Fenêtres:

  • Télécharger et installer (par défaut) :

     !$($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"})"
* Téléchargement uniquement :
    !$($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"})"

La commande de téléchargement uniquement téléchargera tous les artefacts requis de Data Infrastructure Insights vers le répertoire de travail. Les artefacts comprennent, sans toutefois s'y limiter :

  • un script d'installation

  • un fichier d'environnement

  • un binaire Telegraf

  • une signature pour le binaire Telegraf

  • un certificat public pour vérifier la signature binaire

L'extrait d'installation téléchargé et copié à partir de DII vérifie automatiquement le script d'installation et la signature du binaire Telegraf est vérifiée par le script d'installation.

Vérifier la valeur de la somme de contrôle

Pour générer la valeur de somme de contrôle, exécutez la commande suivante pour votre plate-forme appropriée :

  • RHEL/Ubuntu :

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

Installer le package téléchargé

Une fois que tous les artefacts ont été 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
Fenêtres:
.\cloudinsights-windows.ps1 -install

Création et utilisation de jetons d'accès API

Pour créer un jeton d'accès API pour l'ingestion de données Telegraf, veuillez effectuer l'une des opérations suivantes :

Créer via la page d'installation du collecteur de données

  1. Accédez à la page d’installation de Data Collector pour la plate-forme que vous souhaitez utiliser (Windows, Linux).

  2. Créez un jeton avec le bouton + Jeton d'accès API.

  3. Saisissez un nom et cliquez sur Enregistrer.

  4. Le nom du jeton doit maintenant être sélectionné dans la liste déroulante et sera utilisé lors de l'installation du collecteur.

Créer manuellement un jeton d'accès API

  1. Accédez à Admin > Accès API.

  2. Cliquez sur + Jeton d'accès API.

  3. Saisissez un nom et éventuellement une description.

  4. Sous « Quel type d’API ce jeton sera-t-il utilisé pour appeler ? », sélectionnez uniquement « Ingestion de données », puis décochez « Unité d’acquisition ».

  5. Sous « Autorisations », sélectionnez Lecture/Écriture.

  6. Décochez « Faire pivoter automatiquement les jetons pour Kubernetes ».

Pour utiliser votre jeton d’accès API nouvellement créé, sélectionnez-le dans la liste déroulante « Sélectionner un jeton d’accès API existant ou en créer un nouveau » sur la page du programme d’installation. Veuillez noter que seuls les jetons possédant les propriétés suivantes peuvent être utilisés :

  • Type d'API : « Ingestion de données » uniquement

  • Autorisations : lecture/écriture

  • Rotation automatique de Kubernetes : désactivée

Dépannage

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

Problème: Essayez ceci:

Après avoir configuré un nouveau plugin et redémarré Telegraf, Telegraf ne parvient pas à démarrer. Les journaux indiquent une erreur semblable à ce qui suit : « [telegraf] Erreur lors de l'exécution de l'agent : Erreur lors du chargement du fichier de configuration /etc/telegraf/telegraf.d/cloudinsights-default.conf : plugin outputs.http : ligne <linenumber> : la configuration a spécifié les champs ["use_system_proxy"], mais ils n'ont pas été utilisés »

La version Telegraf installée est obsolète. Suivez les étapes sur 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 plus de données

Désinstallez l'agent Telegraf, puis réexécutez le script d'installation. Suivez les étapes Mettre à niveau l'agent sur cette page pour votre plateforme 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/VM, vous n’avez pas besoin de réinstaller l’agent. Dans ce cas, choisissez simplement la plate-forme et la clé appropriées dans l'écran d'installation de l'agent, puis cliquez sur Continuer ou Terminer.

J'ai déjà installé un agent, mais je n'utilise pas 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 garantir des paramètres de fichier de configuration par défaut appropriés. Une fois terminé, cliquez sur Continuer ou Terminer.

Des informations complémentaires peuvent être trouvées à partir du"Support" page ou dans le"Matrice de support du collecteur de données" .