1 Test du prétraitement

Test

Le test des étapes de prétraitement est utile pour s'assurer que des pipelines de prétraitement complexes produisent les résultats attendus, sans attendre que la valeur de l'élément soit reçue et prétraitée.

Il est possible de tester :

  • avec une valeur hypothétique
  • avec une valeur réelle provenant d'un hôte

Chaque étape de prétraitement peut être testée individuellement, et toutes les étapes peuvent également être testées ensemble. Lorsque vous cliquez sur le bouton Test ou Tester toutes les étapes respectivement dans le bloc Actions, une fenêtre de test s'ouvre.

Test de valeur hypothétique

Parameter Description
Get value from host Si vous souhaitez tester une valeur hypothétique, laissez cette case à cocher non sélectionnée.
Voir aussi: Test de valeur réelle.
Value Saisissez la valeur d'entrée à tester.
Cliquer dans le champ du paramètre ou sur le bouton d'affichage/modification ouvrira une fenêtre de zone de texte pour saisir la valeur ou un bloc de code.
Not supported Cochez cette case pour tester une valeur non prise en charge.
Cette option est utile pour tester l'étape de prétraitement Check for not supported value.
Error Saisissez le texte de l'erreur.
Ce champ est activé lorsque Get value from host n'est pas coché, mais que Not supported est coché.
Si Get value from host est coché, ce champ est rempli avec le message d'erreur réel (lecture seule) provenant de l'hôte.
Time L'heure de la valeur d'entrée est affichée: now (lecture seule).
Previous value Saisissez une valeur d'entrée précédente à comparer.
Uniquement pour les étapes de prétraitement Change et Throttling.
Previous time Saisissez l'heure de la valeur d'entrée précédente à comparer.
Uniquement pour les étapes de prétraitement Change et Throttling.
La valeur par défaut est basée sur la valeur du champ 'Update interval' de l'élément (si '1m', alors ce champ est rempli avec now-1m). Si rien n'est spécifié ou si l'utilisateur n'a pas accès à l'hôte, la valeur par défaut est now-30s.
Macros Si des macros sont utilisées, elles sont listées avec leurs valeurs. Les valeurs sont modifiables à des fins de test, mais les modifications ne seront enregistrées que dans le contexte du test.
End of line sequence Sélectionnez la séquence de fin de ligne pour les valeurs d'entrée multilignes:
LF - séquence LF (line feed)
CRLF - séquence CRLF (carriage-return line-feed).
Preprocessing steps Les étapes de prétraitement sont listées; le résultat du test est affiché pour chaque étape après avoir cliqué sur le bouton Test.
Les résultats de test sont tronqués à une taille maximale de 512KB lorsqu'ils sont envoyés à l'interface. Les résultats de test peuvent être copiés (sans dépasser les 512KB tronqués). Si un résultat est tronqué, une icône d'avertissement s'affiche. La description de l'avertissement s'affiche au survol de la souris. Notez que les données supérieures à 512KB sont toujours entièrement traitées par le serveur Zabbix.
Si l'étape a échoué lors du test, une icône d'erreur s'affiche. La description de l'erreur s'affiche au survol de la souris.
Dans le cas où "Custom on fail" est spécifié pour l'étape et que cette action est exécutée, une nouvelle ligne apparaît juste après la ligne de l'étape de test de prétraitement, indiquant quelle action a été effectuée et quel résultat elle a produit (erreur ou valeur).
Result Le résultat final du test des étapes de prétraitement est affiché dans tous les cas lorsque toutes les étapes sont testées ensemble (lorsque vous cliquez sur le bouton Test all steps).
Le type de conversion vers le type de valeur de l'élément est également affiché, par exemple Result converted to Numeric (unsigned).
Les résultats de test sont tronqués à une taille maximale de 512KB lorsqu'ils sont envoyés à l'interface. Le résultat final peut être copié (sans dépasser les 512KB tronqués). Si un résultat est tronqué, une icône d'avertissement s'affiche. La description de l'avertissement s'affiche au survol de la souris. Notez que les données supérieures à 512KB sont toujours entièrement traitées par le serveur Zabbix.

Cliquez sur Test pour voir le résultat après chaque étape de prétraitement.

Les valeurs de test sont stockées entre les sessions de test, que ce soit pour des étapes individuelles ou pour l'ensemble des étapes, ce qui permet à l'utilisateur de modifier les étapes de prétraitement ou la configuration de l'élément, puis de revenir à la fenêtre de test sans avoir à ressaisir les informations. Les valeurs sont toutefois perdues lors d'un rafraîchissement de la page.

Le test est effectué par le serveur Zabbix. L'interface envoie une requête correspondante au serveur et attend le résultat. La requête contient la valeur d'entrée et les étapes de prétraitement (avec les macros utilisateur développées). Pour les étapes Change et Throttling, une valeur et une heure précédentes facultatives peuvent être spécifiées. Le serveur répond avec les résultats de chaque étape de prétraitement.

Toutes les erreurs techniques ou erreurs de validation des entrées sont affichées dans la zone d'erreur en haut de la fenêtre de test.

Test de valeur réelle

Pour tester le prétraitement avec une valeur réelle :

  • Cochez la case Obtenir la valeur depuis l'hôte
  • Saisissez ou vérifiez les paramètres de l'hôte (adresse de l'hôte, port, nom du proxy/sans proxy) et les détails spécifiques à l'élément (tels que la communauté SNMPv2 ou les informations d'identification de sécurité SNMPv3). Ces champs sont contextuels :
    • Les valeurs sont préremplies lorsque cela est possible, c'est-à-dire, pour les éléments nécessitant un agent, en prenant les informations de l'interface agent sélectionnée de l'hôte
    • Les valeurs doivent être saisies manuellement pour les éléments de modèle
    • Les valeurs des macros en texte brut sont résolues
    • Lorsque la valeur du champ (ou une partie de la valeur) est un secret ou une macro Vault, le champ sera vide et devra être rempli manuellement. Si un paramètre d'élément contient une valeur de macro secrète, le message d'avertissement suivant s'affiche : "L'élément contient des macros définies par l'utilisateur avec des valeurs secrètes. Les valeurs de ces macros doivent être saisies manuellement."
    • Les champs sont désactivés lorsqu'ils ne sont pas nécessaires dans le contexte du type d'élément (par exemple, les champs adresse de l'hôte et proxy sont désactivés pour les éléments calculés)
  • Cliquez sur Obtenir la valeur et tester pour tester le prétraitement

Si vous avez spécifié un mappage de valeurs dans le formulaire de configuration de l'élément (champ 'Afficher la valeur'), la boîte de dialogue de test de l'élément affichera une autre ligne après le résultat final, nommée 'Résultat avec mappage de valeurs appliqué'.

Paramètres spécifiques à l'obtention d'une valeur réelle depuis un hôte :

Parameter Description
Get value from host Cochez cette case pour obtenir une valeur réelle depuis l'hôte.
Host address Saisissez l'adresse de l'hôte.
Ce champ est automatiquement rempli avec l'adresse de l'interface hôte de l'élément.
Port Saisissez le port de l'hôte.
Ce champ est automatiquement rempli avec le port de l'interface hôte de l'élément.
Additional fields for SNMP interfaces
(SNMP version, SNMP community, Context name, etc.)		 Consultez Configuration de la surveillance SNMP pour plus de détails sur la configuration d'une interface SNMP (v1, v2 et v3).
Ces champs sont automatiquement remplis à partir de l'interface hôte de l'élément.
Proxy Spécifiez le proxy si l'hôte est surveillé par un proxy.
Ce champ est automatiquement rempli par le proxy de l'hôte (le cas échéant).
Value Valeur récupérée depuis l'hôte.
Cliquer dans le champ du paramètre ou sur le bouton d'affichage/modification ouvrira une zone de texte contenant la valeur ou un bloc de code.
Les valeurs sont tronquées à une taille maximale de 512 Ko et uniquement dans l'interface. Si un résultat est tronqué, une icône d'avertissement s'affiche. La description de l'avertissement s'affiche au survol de la souris. Notez que les données supérieures à 512 Ko sont toujours traitées intégralement par le serveur Zabbix.

Pour le reste des paramètres, consultez Test de valeur hypothétique ci-dessus.