Vous pouvez exécuter des scripts personnalisés dans la machine cible et collecter des données personnalisées qui peuvent ensuite être utilisées comme mesure.
Conditions préalables
- Tous les scripts personnalisés que vous exécutez doivent générer une valeur entière unique. Si la sortie n'est pas une valeur entière unique, une erreur s'affiche dans l'interface utilisateur.
- Le script personnalisé utilise le plug-in exec de Telegraf pour exécuter des scripts sur le système d'exploitation d'une machine cible. Dans les systèmes d'exploitation Linux, un utilisateur spécial appelé arcuser disposant de privilèges spécifiques est créé pour l'installation de l'agent Telegraf. Par conséquent, le plug-in exec exécute les scripts comme utilisateur arcuser. Assurez-vous que l'utilisateur arcuser peut exécuter les scripts personnalisés (arcuser doit disposer des autorisations pour exécuter le script). Par exemple, l'utilisateur arcuser créé automatiquement par le proxy cloud ne dispose pas des privilèges permettant d'exécuter des scripts stockés dans le répertoire /root.
- Dans les systèmes d'exploitation Windows, un utilisateur système est utilisé pour l'installation de l'agent Telegraf. Par conséquent, le plug-in exec exécute les scripts comme utilisateur système. Assurez-vous que l'utilisateur système dispose de privilèges et peut exécuter le script personnalisé.
- Le script doit être placé dans le dossier /opt/vmware.
- La variable d'environnement PATH doit être définie pour que les scripts PowerShell s'exécutent sur le système d'exploitation Windows si l'utilisateur a utilisé le préfixe powershell -File. Par exemple, "%SYSTEMROOT%\System32\WindowsPowerShell\v1.0\" dans la variable PATH de la variable d'environnement.
Exécution de scripts personnalisés
- Dans l'onglet Gérer les agents Telegraf, filtrez par .
- Développez la flèche déroulante en regard de la machine cible sur laquelle l’agent est installé. La section Surveillance personnalisée s'affiche.
- En regard de l'option Script personnalisé, cliquez sur les trois points verticaux, puis sur Ajouter.
- Dans la boîte de dialogue Gérer le service personnalisé, vous pouvez ajouter et configurer les services Windows à surveiller.
Paramètres d'instance
| Option | Description |
|---|---|
| Statut | Activez l'exécution du script personnalisé. |
| Nom d'affichage | Ajoutez un nom approprié pour le script. Le symbole * est un caractère non valide qui ne doit pas être utilisé dans le nom. |
| Chemin d'accès | Entrez le chemin d’accès au fichier script sur la machine cible. Exemple :
Pour les machines Linux :
/opt/vmware/scripts/customscript.pyPour les machines Windows : c:\scripts\customscript.ps1 |
| Préfixe | Entrez un préfixe si nécessaire. Exemple : Pour les machines Linux : python2.7, /bin/bash ou perl, etc. Pour les machines Windows : powershell -File |
| Arguments | Énumérez les arguments du script. |
| Délai d'expiration | Saisissez un délai d'expiration d'exécution de script sur la machine virtuelle. |
Une fois que vous avez enregistré le script, il s'affiche sous Script personnalisé. Vous pouvez modifier ou supprimer des scripts en cliquant sur les options Modifier ou Supprimer des trois points verticaux en regard du script personnalisé que vous avez ajouté. Une fois les scripts ajoutés et enregistrés, cliquez sur la flèche déroulante en regard de Script personnalisé, pour afficher la liste des scripts et leur état.
- Le script personnalisé doit générer toutes les erreurs dans le format ERROR|<Error_message> pour que la propagation des erreurs fonctionne. Si le script ne génère pas d'erreur dans le format spécifié, VMware Aria Operations affiche le message d'erreur Unable to parse the error message. Please check the endpoint dans l'interface utilisateur. Ce comportement est intentionnel, jusqu'à ce que le proxy cloud propage le message d'erreur exact.
- Le script de bash doit commencer par
shebang (#!/bin/bash).
Onglet Toutes les mesures
Lorsque les données sont collectées correctement, vous pouvez afficher le script comme mesure pour la machine cible dans l'onglet Toutes les mesures. Les mesures de script sont créées sous un objet appelé Script personnalisé, qui est un objet unique à chaque machine cible. Toutes les mesures des scripts de la machine cible sont placées sous cet objet Script personnalisé qui contient tous les scripts personnalisés que vous avez créés. Vous pouvez afficher la sortie de la mesure spécifique. Le nom de la mesure sous le dossier Scripts correspond au nom d'affichage que l'utilisateur spécifie lors de la création de la configuration du script. Par exemple, si vous définissez le nom d'affichage sur script Python, une mesure est créée avec le nom script Python si les données sont collectées avec succès.
