Surveillance des applications à l'aide du logiciel open source Telegraf sur une plate-forme Windows

Utilisez le script d'aide pour surveiller les applications et les systèmes d'exploitation sur une plate-forme Windows à l'aide du logiciel open source Telegraf.

Le script d'aide est uniquement testé sur Windows Server 2012, 2012 R2, 2016, 2019 et 2022.

Conditions préalables

Vérifiez que Windows PowerShell est à la version 4.0 ou supérieure.
Assurez-vous que la version de VMTools >=10.2 si une machine virtuelle vCenter Server est surveillée par VMware Aria Operations. vmware-toolbox-cmd n'est nécessaire que pour les machines virtuelles vCenter Server.
Seul IPv4 est actuellement pris en charge pour le proxy cloud.
Assurez-vous d'être connecté à Internet.
Assurez-vous que le proxy cloud est actif et en ligne dans VMware Aria Operations. Dans le cas de groupes de collecteurs, assurez-vous qu'au moins un proxy cloud dans le groupe de collecteurs activé pour la haute disponibilité de surveillance d'applications est actif et en ligne dans VMware Aria Operations.
Les machines virtuelles vCenter Server, les instances d'AWS EC2, les machines virtuelles Azure ou le serveur physique doivent avoir accès aux ports 8443 et 443 du proxy cloud ou à l'adresse IP virtuelle du groupe de collecteurs activés pour la surveillance de l'application.

Procédure

Téléchargez le script d'aide à partir du proxy cloud à l'adresse https://<CloudProxy-IP>/downloads/salt/telegraf-utils.ps1.

Note : Utilisez l' adresse IP pour <CloudProxy-IP> dans les commandes et l'emplacement précédents spécifiés. Pour les groupes de collecteurs activés pour la haute disponibilité de surveillance d'applications, fournissez l'adresse IP virtuelle.

Si le téléchargement du script échoue avec le message suivant : La demande a été abandonnée : impossible de créer un canal sécurisé SSL/TLS, suivez les étapes mentionnées dans Échec du téléchargement du script sur une plate-forme Windows.
Accédez au répertoire dans lequel le script est téléchargé.
Exécutez le script d'aide pour mettre à jour les configurations Telegraf.
```
telegraf-utils.ps1  opensource -c cloud_proxy_ip_or_collector_group_name -t token -d telegraf_conf_dir -e telegraf_bin_path [-g gateway_url -a csp_auth_url]
    
Description of arguments:
      -c : [REQUIRED] cloud_proxy_ip_or_collector_group_name - Cloud Proxy IP or Collector Group Name
      -t : [REQUIRED] token - [REQUIRED] - CSP Refresh Token of the user/account. For getting a new token, follow - 
           User/Organization Settings >> My Account >> API Tokens >> Generate a New API Token.
           Example: gi7lwabjnvdfiawt4watzksuol8sywrjvg8kabh31mx9x1guepgyhycyx61dqrpq
      
      -d : [REQUIRED] telegraf_conf_dir - Telegraf configuration directory and it is required argument. ex: C:\Telegraf\telegraf-1.20.4\telegraf.d
      -e : [REQUIRED] telegraf_bin_path - Path of telegraf executable ex: C:\Telegraf\telegraf-1.20.4\telegraf.exe
      
      -g : [OPTIONAL] [SAAS-SPECIFIC] gateway_url - argument to override default VMware Aria Operations SaaS gateway URL
      -a : [OPTIONAL] [SAAS-SPECIFIC] csp_auth_url - argument to override default CSP authentication URL


Example: .\telegraf-utils.ps1 opensource -c 10.10.10.101 -t gi7lwabjnvdfiawt4watzksuol8sywrjvg8kabh31mx9x1guepgyhycyx61dqrpq -d C:\Telegraf\telegraf-1.20.4\telegraf.d -e C:\Telegraf\telegraf-1.20.4\telegraf.exe
```
Note : Après avoir exécuté le script d'aide, assurez-vous que les configurations respectives sont correctement définies dans le chemin du répertoire de configuration donné (option -d ) sous le nom cloudproxy-http.conf. Pour plus d'informations, reportez-vous à la section Exemples de configurations. Pour les machines virtuelles vCenter Server gérées, les instances d'AWS EC2 ou les machines virtuelles Azure, des configurations non gérées peuvent apparaître pour l'une des raisons suivantes :
- Les détails des machines virtuelles vCenter Server, des instances d'AWS EC2 ou des machines virtuelles Azure ne sont pas disponibles dans VMware Aria Operations par les adaptateurs vCenter Server, AWS ou Azure respectivement. Attendez entre un et deux cycles de collecte après la configuration des comptes de cloud vCenter Server de VMware Aria Operations.
- Erreur SAAS_REFRESH_TOKEN.
Note :
- N'utilisez pas d'espace dans le chemin de configuration. Les chemins contenant des espaces peuvent être transmis sous la forme d'une notation de nom abrégé, telle que c:\PROGRA~1 pour c:\Program Files.
Note : Assurez-vous que les plug-ins d'entrée dans le fichier telegraf.conf sont liés au système d'exploitation correspondant. Reportez-vous à Détails de configuration Telegraf pour les systèmes d’exploitation.

Note : L'URL de la passerelle par défaut est https://www.mgmt.cloud.vmware.com/vrops-cloud et l'URL d'authentification par défaut est https://console.cloud.vmware.com/csp/gateway/am/api/auth/api-tokens/authorize. Si l'URL d'authentification et l'URL de la passerelle sont différentes des paramètres par défaut, fournissez les arguments appropriés (-g et -a).

Redémarrez le service Telegraf.

telegraf.exe --config telegraf.conf --config-directory telegraf.d

Vous pouvez également faire de Telegraf un service Windows.

<Telegraf_executable_path> --config <Telegraf_config_file_path> --config-directory <Telegraf_config_directory_path> --service install net start telegraf

Par exemple :

& 'C:\Telegraf\telegraf-1.20.4\telegraf.exe'  --config 'C:\Telegraf\telegraf-1.20.4\telegraf.conf' --config-directory 'C:\Telegraf\telegraf-1.20.4\telegraf.d'  --service install
net start telegraf

Que faire ensuite

Hiérarchie d'objets de VM gérés :

Si une VM vCenter Server est surveillée par VMware Aria Operations, les objets du système d'exploitation et de l'application seront placés sous VM > Objet de SE > Instance de « service applicatif »
Si une machine virtuelle Azure est surveillée par VMware Aria Operations, les objets du système d'exploitation et de l'application seront placés sous VM Azure > Objet de SE > Instance de « service applicatif ».
Si une instance d'AWS EC2 de la VM est surveillée par VMware Aria Operations, les objets du système d'exploitation et de l'application seront placés sous Instance d'AWS EC2 > Objet de SE > Instance de « service applicatif »

Machines non surveillées par VMware Aria Operations : Si une machine virtuelle vCenter Server, une instance d'AWS EC2, une machine virtuelle Azure ou un serveur physique ne sont pas surveillés par VMware Aria Operations, les objets du système d'exploitation et de l'application seront placés sous Environnement > Point de terminaison > Objet de SE > Instance de « service applicatif ».

Afficher les données collectées : les données sont collectées et s'affichent sur la page Gérer les agents Telegraf. Pour afficher les détails, vous pouvez filtrer par Type d'agent > Agent open source à partir de la page Gérer les agents Telegraf.