Documentation
Table of Contents
2 ±Ê°ù¨¦³Ù°ù²¹¾±³Ù±ð³¾±ð²Ô³Ù de la valeur de l'¨¦l¨¦ment
Aper?u
Le pr¨¦traitement permet de d¨¦finir des r¨¨gles de transformation pour les valeurs des items re?us. Une ou plusieurs transformations sont possibles avant l'enregistrement dans la base de donn¨¦es.
Les transformations sont ex¨¦cut¨¦es dans l'ordre dans lequel elles sont d¨¦finies. Le pr¨¦traitement est effectu¨¦ par le serveur ou le proxy Áú»¢¶Ä²© (si les ¨¦l¨¦ments sont surveill¨¦s par proxy).
Notez que toutes les valeurs transmises au pr¨¦traitement sont de type cha?ne, la conversion vers le type de valeur souhait¨¦ (tel que d¨¦fini dans la configuration de l'¨¦l¨¦ment) est effectu¨¦e ¨¤ la fin du pipeline de pr¨¦traitement ; cependant, des conversions peuvent ¨¦galement avoir lieu si cela est requis par le ¨¦tape de pr¨¦traitement correspondante. Voir d¨¦tails de pr¨¦traitement pour plus d'informations techniques.
Voir aussi : Exemples d'utilisation
Configuration
Les r¨¨gles de pr¨¦traitement sont d¨¦finies dans l'onglet ±Ê°ù¨¦³Ù°ù²¹¾±³Ù±ð³¾±ð²Ô³Ù du formulaire de configuration de l'¨¦l¨¦ment.
Un ¨¦l¨¦ment deviendra non support¨¦ si l'une des ¨¦tapes de pr¨¦traitement ¨¦choue, ¨¤ moins que la gestion personnalis¨¦e des erreurs n'ait ¨¦t¨¦ sp¨¦cifi¨¦e ¨¤ l'aide d'une option Personnalis¨¦ en cas d'¨¦chec pour les transformations prises en charge.
Pour les ¨¦l¨¦ments de journal, les m¨¦tadonn¨¦es de journal (sans valeur) r¨¦initialiseront toujours l'¨¦tat non pris en charge de l'¨¦l¨¦ment et rendront l'¨¦l¨¦ment ¨¤ nouveau pris en charge, m¨ºme si l'erreur initiale s'est produite apr¨¨s avoir re?u une valeur de journal de l'agent.
Les macros utilisateur et les macros utilisateur avec contexte sont prises en charge dans les param¨¨tres de pr¨¦traitement de la valeur de l'¨¦l¨¦ment, y compris le code JavaScript.
Le contexte est ignor¨¦ lorsqu'une macro est remplac¨¦e par sa valeur. La valeur de la macro est ins¨¦r¨¦e telle quelle dans le code, il n'est pas possible d'ajouter un ¨¦chappement suppl¨¦mentaire avant de placer la valeur dans le code JavaScript. Veuillez noter que cela peut provoquer des erreurs JavaScript dans certains cas.
| Type | ||
|---|---|---|
| Transformation | Description | |
| Texte | ||
| Expression r¨¦guli¨¨re | Faites correspondre la valeur ¨¤ l'expression r¨¦guli¨¨re <motif> et remplacez la valeur par <sortie>. L'expression r¨¦guli¨¨re prend en charge l'extraction d'un maximum de 10 groupes captur¨¦s avec la s¨¦quence \N. Si la valeur d'entr¨¦e ne correspond pas, l'¨¦l¨¦ment ne sera pas pris en charge. ±Ê²¹°ù²¹³¾¨¨³Ù°ù±ðs : motif - expression r¨¦guli¨¨re sortie - mod¨¨le de formatage de sortie. Une s¨¦quence d'¨¦chappement \N (o¨´ N=1...9) est remplac¨¦e par le Ni¨¨me groupe correspondant. Une s¨¦quence d'¨¦chappement \0 est remplac¨¦e par le texte correspondant. Veuillez vous r¨¦f¨¦rer ¨¤ la section expressions r¨¦guli¨¨res pour quelques exemples existants. Si vous cochez la case Personnalis¨¦ en cas d'¨¦chec , l'¨¦l¨¦ment ne deviendra pas non pris en charge en cas d'¨¦chec de l'¨¦tape de pr¨¦traitement et il est possible de sp¨¦cifier des options personnalis¨¦es de gestion des erreurs : soit pour ignorer la valeur, soit pour d¨¦finir une valeur sp¨¦cifi¨¦e, soit pour d¨¦finir un message d'erreur sp¨¦cifi¨¦. |
|
| Remplacer | Trouvez la cha?ne de recherche et remplacez-la par une autre (ou rien). Toutes les occurrences de la cha?ne de recherche seront remplac¨¦es. ±Ê²¹°ù²¹³¾¨¨³Ù°ù±ðs : cha?ne de de caract¨¨res de recherche - la cha?ne ¨¤ rechercher et ¨¤ remplacer, sensible ¨¤ la casse (obligatoire) remplacement - la cha?ne ¨¤ remplacez la cha?ne de recherche par. La cha?ne de remplacement peut ¨¦galement ¨ºtre vide, ce qui permet de supprimer la cha?ne de recherche lorsqu'elle est trouv¨¦e. Il est possible d'utiliser des s¨¦quences d'¨¦chappement pour rechercher ou remplacer les sauts de ligne, les retours chariot, les tabulations et les espaces "\n \r \ t \s" ; la barre oblique inverse peut ¨ºtre ¨¦chapp¨¦e sous la forme "\\" et les s¨¦quences d'¨¦chappement peuvent ¨ºtre ¨¦chapp¨¦es sous la forme "\\n". L'¨¦chappement des sauts de ligne, des retours chariot et des tabulations est automatiquement effectu¨¦ lors de la d¨¦couverte de bas niveau. |
|
| Rogner | Supprimez les caract¨¨res sp¨¦cifi¨¦s au d¨¦but et ¨¤ la fin de la valeur. | |
| Rogner ¨¤ droite | Supprimez les caract¨¨res sp¨¦cifi¨¦s ¨¤ la fin de la valeur. | |
| Rogner ¨¤ gauche | Supprimez les caract¨¨res sp¨¦cifi¨¦s du d¨¦but de la valeur. | |
| Donn¨¦es structur¨¦es | ||
| XPath XML | Extrayez la valeur ou le fragment des donn¨¦es XML ¨¤ l'aide de la fonctionnalit¨¦ XPath. Pour que cette option fonctionne, le serveur Áú»¢¶Ä²© doit ¨ºtre compil¨¦ avec le support libxml. Exemples : number(/document/item/value) extraira 10 de <document><item><value>10</value></item></document>number(/document/item/@attribute) extraira 10 de <document><item attribute="10"></item></document>/document/item extraira <item><value>10</value></item> de <document><item><value>10</value></item></document>Notez que les espaces de noms ne sont pas pris en charge. Si vous cochez la case Personnalis¨¦ en cas d'¨¦chec, l'¨¦l¨¦ment ne deviennent pas non pris en charge en cas d'¨¦chec de l'¨¦tape de pr¨¦traitement et il est possible de sp¨¦cifier des options personnalis¨¦es de gestion des erreurs : soit pour ignorer la valeur, soit pour d¨¦finir une valeur sp¨¦cifi¨¦e, soit pour d¨¦finir un message d'erreur sp¨¦cifi¨¦. |
|
| JSONPath | Extrayez la valeur ou le fragment des donn¨¦es JSON ¨¤ l'aide de la fonctionnalit¨¦ JSONPath. Si vous cochez la case Personnalis¨¦ en cas d'¨¦chec, l'¨¦l¨¦ment ne sera pas pris en charge en cas d'¨¦chec du pr¨¦traitement ¨¦tape et il est possible de sp¨¦cifier des options personnalis¨¦es de gestion des erreurs : soit pour ignorer la valeur, soit pour d¨¦finir une valeur sp¨¦cifi¨¦e, soit pour d¨¦finir un message d'erreur sp¨¦cifi¨¦. |
|
| CSV vers JSON | Convertissez les donn¨¦es du fichier CSV au format JSON. Pour plus d'informations, voir : ±Ê°ù¨¦³Ù°ù²¹¾±³Ù±ð³¾±ð²Ô³Ù CSV vers JSON. |
|
| XML vers JSON | Convertissez les donn¨¦es au format XML en JSON. Pour plus d'informations, voir : R¨¨gles de s¨¦rialisation. Si vous cochez la case Personnalis¨¦ en cas d'¨¦chec, l'¨¦l¨¦ment ne deviendra pas non pris en charge en cas d'¨¦chec de l'¨¦tape de pr¨¦traitement et il est possible de sp¨¦cifier des options personnalis¨¦es de gestion des erreurs : soit pour ignorer la valeur, soit pour d¨¦finir une valeur sp¨¦cifi¨¦e, soit pour d¨¦finir une erreur sp¨¦cifi¨¦e message. |
|
| ´¡°ù¾±³Ù³ó³¾¨¦³Ù¾±±ç³Ü±ð | ||
| Multiplicateur personnalis¨¦ | Multipliez la valeur par l'entier sp¨¦cifi¨¦ ou la valeur ¨¤ virgule flottante. Utilisez cette option pour convertir les valeurs re?ues en Ko, Mops, etc. en B, Bps. Sinon, Áú»¢¶Ä²© ne peut pas d¨¦finir correctement les ±è°ù¨¦´Ú¾±³æ±ð²õ (K, M, G, etc.). Notez que si le type d'¨¦l¨¦ment d'information est Num¨¦rique (non sign¨¦), les valeurs entrantes avec un la partie fractionnaire sera coup¨¦e (c'est-¨¤-dire que '0.9' deviendra '0') avant l'application du multiplicateur personnalis¨¦. Prise en charge : notation scientifique, par exemple, 1e+70 (depuis la version 2.2) ; macros utilisateur et macros LLD (depuis la version 4.0) ; cha?nes qui incluent des macros, par exemple, {#MACRO}e+10, {$MACRO1}e+{$MACRO2}(depuis la version 5.2.3)Les macros doivent se r¨¦soudre en un entier ou un flottant. Si vous cochez la case Personnalis¨¦ en cas d'¨¦chec, l'¨¦l¨¦ment ne deviendra pas non pris en charge en cas d'¨¦chec de l'¨¦tape de pr¨¦traitement et il est possible de sp¨¦cifier des options de gestion des erreurs personnalis¨¦es : soit pour ignorer la valeur, d¨¦finir une valeur sp¨¦cifi¨¦e , ou d¨¦finissez un message d'erreur sp¨¦cifi¨¦. |
|
| Changer | ||
| Changement simple | Calculez la diff¨¦rence entre la valeur actuelle et la valeur pr¨¦c¨¦dente. ?valu¨¦ comme valeur-valeur_precedente, o¨´ valeur - valeur actuelle ; valeur_precedente - valeur pr¨¦c¨¦demment re?ue Ce param¨¨tre peut ¨ºtre utile pour mesurer une valeur en croissance constante. Si la valeur actuelle est inf¨¦rieure ¨¤ la valeur pr¨¦c¨¦dente, Áú»¢¶Ä²© ignore cette diff¨¦rence (ne stocke rien) et attend une autre valeur. Une seule op¨¦ration de modification par ¨¦l¨¦ment est autoris¨¦e. Si vous cochez la case Personnalis¨¦ en cas d'¨¦chec , l'¨¦l¨¦ment ne deviendra pas non pris en charge en cas d'¨¦chec de l'¨¦tape de pr¨¦traitement et il est possible de sp¨¦cifier des options personnalis¨¦es de gestion des erreurs : soit pour ignorer la valeur, soit pour d¨¦finir une valeur sp¨¦cifi¨¦e, soit pour d¨¦finir un message d'erreur sp¨¦cifi¨¦. |
|
| Changement par seconde | Calculez la vitesse de changement de valeur (diff¨¦rence entre la valeur actuelle et pr¨¦c¨¦dente) par seconde. ?valu¨¦ comme (valeur-valeur_precedente)/(temps-temps_precedent), o¨´ valeur - valeur actuelle ; valeur_precedente - valeur pr¨¦c¨¦demment re?ue ; temps - horodatage actuel ; temps_precedent - horodatage de la valeur pr¨¦c¨¦dente. Ce param¨¨tre est extr¨ºmement utile pour obtenir la vitesse par seconde pour une valeur en croissance constante. Si la valeur actuelle est inf¨¦rieure ¨¤ la valeur pr¨¦c¨¦dente, Áú»¢¶Ä²© ignore cette diff¨¦rence (ne stocke rien) et attend une autre valeur. Cela permet de fonctionner correctement avec, par exemple, un encapsulage (d¨¦bordement) de compteurs SNMP 32 bits. Remarque : Comme ce calcul peut produire des nombres ¨¤ virgule flottante, il est recommand¨¦ de d¨¦finir le "Type d'informations". ¨¤ Num¨¦rique (flottant), m¨ºme si les valeurs brutes entrantes sont des nombres entiers. Ceci est particuli¨¨rement pertinent pour les petits nombres o¨´ la partie d¨¦cimale compte. Si les valeurs ¨¤ virgule flottante sont grandes et peuvent d¨¦passer la longueur du champ 'float', auquel cas la valeur enti¨¨re peut ¨ºtre perdue, il est en fait sugg¨¦r¨¦ d'utiliser Num¨¦rique (non sign¨¦) et donc de supprimer uniquement la partie d¨¦cimale. Une seule op¨¦ration de modification par ¨¦l¨¦ment est autoris¨¦e. Si vous cochez la case Personnalis¨¦ en cas d'¨¦chec, l'¨¦l¨¦ment ne deviendra pas non pris en charge en cas d'¨¦chec de l'¨¦tape de pr¨¦traitement et il est possible de sp¨¦cifier des options de gestion des erreurs personnalis¨¦es : soit pour ignorer le valeur, d¨¦finissez une valeur sp¨¦cifi¨¦e ou d¨¦finissez un message d'erreur sp¨¦cifi¨¦. |
|
| Syst¨¨mes num¨¦riques | ||
| Bool¨¦en vers d¨¦cimal | Convertissez la valeur du format bool¨¦en en d¨¦cimal. La repr¨¦sentation textuelle est traduite en 0 ou 1. Ainsi, 'VRAI' est stock¨¦ sous la forme 1 et 'FAUX' est stock¨¦ sous la forme 0. Toutes les valeurs sont mises en correspondance sans tenir compte de la casse. Les valeurs actuellement reconnues sont, pour : VRAI - true, t, yes, y, on, up, running, enabled, available, ok, master FAUX - false, f, no, n, off, down, inutilis¨¦, d¨¦sactiv¨¦, indisponible, err, esclave De plus, toute valeur num¨¦rique diff¨¦rente de z¨¦ro est consid¨¦r¨¦e comme VRAI et z¨¦ro est consid¨¦r¨¦ comme FAUX. Si vous cochez la case Personnalis¨¦ en cas d'¨¦chec , l'¨¦l¨¦ment ne deviendra pas non pris en charge en cas d'¨¦chec de l'¨¦tape de pr¨¦traitement et il est possible de sp¨¦cifier des options personnalis¨¦es de gestion des erreurs : soit pour ignorer la valeur, soit pour d¨¦finir une valeur sp¨¦cifi¨¦e, soit pour d¨¦finir un message d'erreur sp¨¦cifi¨¦. |
|
| Octal vers d¨¦cimal | Convertissez la valeur du format octal en d¨¦cimal. Si vous cochez la case Personnalis¨¦ en cas d'¨¦chec, l'¨¦l¨¦ment ne deviendra pas non pris en charge en cas d'¨¦chec de l'¨¦tape de pr¨¦traitement et il est possible de sp¨¦cifier des options de gestion des erreurs personnalis¨¦es : soit pour ignorer le valeur, d¨¦finissez une valeur sp¨¦cifi¨¦e ou d¨¦finissez un message d'erreur sp¨¦cifi¨¦. |
|
| Hexad¨¦cimal vers d¨¦cimal | Convertissez la valeur du format hexad¨¦cimal en d¨¦cimal. Si vous cochez la case Personnalis¨¦ en cas d'¨¦chec, l'¨¦l¨¦ment ne deviendra pas non pris en charge en cas d'¨¦chec de l'¨¦tape de pr¨¦traitement et il est possible de sp¨¦cifier des options de gestion des erreurs personnalis¨¦es : soit pour ignorer le valeur, d¨¦finissez une valeur sp¨¦cifi¨¦e ou d¨¦finissez un message d'erreur sp¨¦cifi¨¦. |
|
| Scripts personnalis¨¦s | ||
| JavaScript | Entrez le code JavaScript dans le bloc qui appara?t lorsque vous cliquez dans le champ de param¨¨tre ou sur une ic?ne en forme de crayon. Notez que la longueur JavaScript disponible d¨¦pend de la base de donn¨¦es utilis¨¦e. Pour plus d'informations, consultez : ±Ê°ù¨¦³Ù°ù²¹¾±³Ù±ð³¾±ð²Ô³Ù Javascript. |
|
| Validation | ||
| Dans la plage | D¨¦finissez une plage dans laquelle une valeur doit se trouver en sp¨¦cifiant les valeurs minimales/maximales (inclusives). Les valeurs num¨¦riques sont accept¨¦es (y compris n'importe quel nombre de chiffres, partie d¨¦cimale facultative et partie exponentielle facultative, valeurs n¨¦gatives). Des macros utilisateur et des macros de d¨¦couverte de bas niveau peuvent ¨ºtre utilis¨¦es. La valeur minimale doit ¨ºtre inf¨¦rieure ¨¤ la valeur maximale. Au moins une valeur doit exister. Si vous cochez la case Personnalis¨¦ en cas d'¨¦chec, l'¨¦l¨¦ment ne deviendra pas non pris en charge en cas d'¨¦chec de l'¨¦tape de pr¨¦traitement et il est possible pour sp¨¦cifier des options de gestion des erreurs personnalis¨¦es : soit pour ignorer la valeur, soit pour d¨¦finir une valeur sp¨¦cifi¨¦e, soit pour d¨¦finir un message d'erreur sp¨¦cifi¨¦. |
|
| Correspond ¨¤ l'expression r¨¦guli¨¨re | Sp¨¦cifiez une expression r¨¦guli¨¨re ¨¤ laquelle une valeur doit correspondre. Si vous cochez la case Personnalis¨¦ en cas d'¨¦chec, l'¨¦l¨¦ment ne deviendra pas non pris en charge en cas d'¨¦chec de l'¨¦tape de pr¨¦traitement et il est possible de sp¨¦cifier des options de gestion des erreurs personnalis¨¦es : soit pour ignorer la valeur, d¨¦finissez une valeur sp¨¦cifi¨¦e ou d¨¦finissez un message d'erreur sp¨¦cifi¨¦. |
|
| Ne correspond pas ¨¤ l'expression r¨¦guli¨¨re | Sp¨¦cifiez une expression r¨¦guli¨¨re ¨¤ laquelle une valeur ne doit pas correspondre. Si vous cochez la case Personnalis¨¦ en cas d'¨¦chec, l'¨¦l¨¦ment ne deviendra pas non pris en charge en cas d'¨¦chec de l'¨¦tape de pr¨¦traitement et il est possible de sp¨¦cifier des options de gestion des erreurs personnalis¨¦es : soit pour ignorer la valeur, d¨¦finir une valeur sp¨¦cifi¨¦e ou d¨¦finir un message d'erreur sp¨¦cifi¨¦. |
|
| Rechercher une erreur dans le JSON | Recherchez un message d'erreur au niveau de l'application situ¨¦ dans JSONpath. Arr¨ºtez le traitement en cas de succ¨¨s et si le message n'est pas vide ; sinon, continuez le traitement avec la valeur qui ¨¦tait avant cette ¨¦tape de pr¨¦traitement. Notez que ces erreurs de service externe sont signal¨¦es ¨¤ l'utilisateur telles quelles, sans ajouter d'informations sur l'¨¦tape de pr¨¦traitement. Aucune erreur ne sera signal¨¦e en cas d'¨¦chec de l'analyse de JSON invalide. Si vous cochez la case Personnalis¨¦ en cas d'¨¦chec , l'¨¦l¨¦ment ne deviendra pas non pris en charge en cas d'¨¦chec de l'¨¦tape de pr¨¦traitement et il est possible de sp¨¦cifier des options personnalis¨¦es de gestion des erreurs : soit pour ignorer la valeur, soit pour d¨¦finir une valeur sp¨¦cifi¨¦e, soit pour d¨¦finir un message d'erreur sp¨¦cifi¨¦. |
|
| Rechercher une erreur dans le XML | Recherchez un message d'erreur au niveau de l'application situ¨¦ dans XPath. Arr¨ºtez le traitement en cas de succ¨¨s et si le message n'est pas vide ; sinon, continuez le traitement avec la valeur qui ¨¦tait avant cette ¨¦tape de pr¨¦traitement. Notez que ces erreurs de service externe sont signal¨¦es ¨¤ l'utilisateur telles quelles, sans ajouter d'informations sur l'¨¦tape de pr¨¦traitement. Aucune erreur ne sera signal¨¦e en cas d'¨¦chec de l'analyse du XML non valide. Si vous cochez la case Personnalis¨¦ en cas d'¨¦chec , l'¨¦l¨¦ment ne deviendra pas non pris en charge en cas d'¨¦chec de l'¨¦tape de pr¨¦traitement et il est possible de sp¨¦cifier des options personnalis¨¦es de gestion des erreurs : soit pour ignorer la valeur, soit pour d¨¦finir une valeur sp¨¦cifi¨¦e, soit pour d¨¦finir un message d'erreur sp¨¦cifi¨¦. |
|
| Rechercher une erreur en utilisant une expression r¨¦guli¨¨re | Recherchez un message d'erreur au niveau de l'application ¨¤ l'aide d'une expression r¨¦guli¨¨re. Arr¨ºtez le traitement en cas de succ¨¨s et si le message n'est pas vide ; sinon, continuez le traitement avec la valeur qui ¨¦tait avant cette ¨¦tape de pr¨¦traitement. Notez que ces erreurs de service externes sont signal¨¦es ¨¤ l'utilisateur telles quelles, sans ajouter d'informations sur l'¨¦tape de pr¨¦traitement. ±Ê²¹°ù²¹³¾¨¨³Ù°ù±ðs : motif - expression r¨¦guli¨¨re sortie - mod¨¨le de formatage de sortie. Une s¨¦quence d'¨¦chappement \N (o¨´ N=1...9) est remplac¨¦e par le Ni¨¨me groupe correspondant. Une s¨¦quence d'¨¦chappement \0 est remplac¨¦e par le texte correspondant. Si vous cochez la case Personnalis¨¦ en cas d'¨¦chec, l'¨¦l¨¦ment ne deviendra pas non pris en charge en cas d'¨¦chec de l'¨¦tape de pr¨¦traitement et il est possible de sp¨¦cifier des options de gestion des erreurs personnalis¨¦es : soit pour ignorer la valeur, d¨¦finir une valeur sp¨¦cifi¨¦e ou d¨¦finir un message d'erreur sp¨¦cifi¨¦. |
|
| V¨¦rifier si une valeur est non support¨¦e | V¨¦rifiez s'il y a eu une erreur lors de la r¨¦cup¨¦ration de la valeur de l'¨¦l¨¦ment. Normalement, cela conduirait ¨¤ ce que l'¨¦l¨¦ment ne soit plus pris en charge, mais vous pouvez modifier ce comportement en sp¨¦cifiant les options de gestion des erreurs Personnalis¨¦ en cas d'¨¦chec : pour ignorer la valeur, pour d¨¦finir une valeur sp¨¦cifi¨¦e (dans ce cas, l'¨¦l¨¦ment restera pris en charge et le la valeur peut ¨ºtre utilis¨¦e dans les d¨¦clencheurs) ou d¨¦finissez un message d'erreur sp¨¦cifi¨¦. Notez que pour cette ¨¦tape de pr¨¦traitement, la case ¨¤ cocher Personnaliser en cas d'¨¦chec est gris¨¦e et toujours coch¨¦e. Cette ¨¦tape est toujours ex¨¦cut¨¦e en tant que premi¨¨re ¨¦tape de pr¨¦traitement et est plac¨¦e au-dessus de toutes les autres apr¨¨s l'enregistrement des modifications apport¨¦es ¨¤ l'¨¦l¨¦ment. Il ne peut ¨ºtre utilis¨¦ qu'une seule fois. Pris en charge depuis la version 5.2.0. |
|
| ?tranglement | ||
| ?carter les inchang¨¦s | Ignorez une valeur si elle n'a pas chang¨¦. Si une valeur est ignor¨¦e, elle n'est pas enregistr¨¦e dans la base de donn¨¦es et le serveur Áú»¢¶Ä²© ne sait pas que cette valeur a ¨¦t¨¦ re?ue. Aucune expression de d¨¦clencheur ne sera ¨¦valu¨¦e, par cons¨¦quent, aucun probl¨¨me pour les d¨¦clencheurs associ¨¦s ne sera cr¨¦¨¦/r¨¦solu. Les fonctions fonctionneront uniquement sur la base des donn¨¦es r¨¦ellement enregistr¨¦es dans la base de donn¨¦es. Comme les tendances sont construites sur la base des donn¨¦es de la base de donn¨¦es, s'il n'y a pas de valeur enregistr¨¦e pendant une heure, il n'y aura pas non plus de donn¨¦es de tendances pour cette heure. Une seule option de limitation peut ¨ºtre sp¨¦cifi¨¦e pour un ¨¦l¨¦ment. * Notez * qu'il est possible pour les ¨¦l¨¦ments surveill¨¦s par le proxy Áú»¢¶Ä²© que de tr¨¨s petites diff¨¦rences de valeur (moins de 0,000001) ne soient correctement pas supprim¨¦es par le proxy, mais soient stock¨¦es dans l'historique avec la m¨ºme valeur si la base de donn¨¦es du serveur Áú»¢¶Ä²© n'a pas ¨¦t¨¦ mise ¨¤ niveau. |
|
| ?carter les inchang¨¦s avec bit de vie | Ignorez une valeur si elle n'a pas chang¨¦ au cours de la p¨¦riode d¨¦finie (en secondes). Les valeurs enti¨¨res positives sont prises en charge pour sp¨¦cifier les secondes (minimum - 1 seconde). Des suffixes de temps peuvent ¨ºtre utilis¨¦s dans ce champ (par exemple 30s, 1m, 2h, 1d). Des macros utilisateur et des macros de d¨¦couverte de bas niveau peuvent ¨ºtre utilis¨¦es dans ce champ. Si une valeur est ignor¨¦e, elle n'est pas enregistr¨¦e dans la base de donn¨¦es et le serveur Áú»¢¶Ä²© ne sait pas que cette valeur a ¨¦t¨¦ re?ue. Aucune expression de d¨¦clencheur ne sera ¨¦valu¨¦e, par cons¨¦quent, aucun probl¨¨me pour les d¨¦clencheurs associ¨¦s ne sera cr¨¦¨¦/r¨¦solu. Les fonctions fonctionneront uniquement sur la base des donn¨¦es r¨¦ellement enregistr¨¦es dans la base de donn¨¦es. Comme les tendances sont construites sur la base des donn¨¦es de la base de donn¨¦es, s'il n'y a pas de valeur enregistr¨¦e pendant une heure, il n'y aura pas non plus de donn¨¦es de tendances pour cette heure. Une seule option de limitation peut ¨ºtre sp¨¦cifi¨¦e pour un ¨¦l¨¦ment. * Notez * qu'il est possible pour les ¨¦l¨¦ments surveill¨¦s par le proxy Áú»¢¶Ä²© que de tr¨¨s petites diff¨¦rences de valeur (moins de 0,000001) ne soient correctement pas supprim¨¦es par le proxy, mais soient stock¨¦es dans l'historique avec la m¨ºme valeur si la base de donn¨¦es du serveur Áú»¢¶Ä²© n'a pas ¨¦t¨¦ mise ¨¤ niveau. |
|
| Prometheus | ||
| Motif Prometheus | Utilisez la requ¨ºte suivante pour extraire les donn¨¦es requises des m¨¦triques Prometheus. Voir les v¨¦rifications Prometheus pour plus de d¨¦tails. |
|
| Prometheus vers JSON | Convertissez les m¨¦triques Prometheus requises en JSON. Voir les v¨¦rifications Prometheus pour plus de d¨¦tails. |
|
Pour les ¨¦tapes de pr¨¦traitement de modification et de limitation, Áú»¢¶Ä²© doit se souvenir de la derni¨¨re valeur pour calculer/comparer la nouvelle valeur selon les besoins. Ces valeurs pr¨¦c¨¦dentes sont g¨¦r¨¦es par le gestionnaire de pr¨¦traitement. Si le serveur ou le proxy Áú»¢¶Ä²© est red¨¦marr¨¦ ou si des modifications sont apport¨¦es aux ¨¦tapes de pr¨¦traitement, la derni¨¨re valeur de l'¨¦l¨¦ment correspondant est r¨¦initialis¨¦e, ce qui entra?ne :
- pour les ¨¦tapes Changement simple, Changement par seconde - la valeur suivante sera ignor¨¦e car il n'y a pas de valeur pr¨¦c¨¦dente ¨¤ partir de laquelle calculer la modification ;
- pour les ¨¦tapes ?carter les inchang¨¦s. ?carter les inchang¨¦s avec bit de vie - la valeur suivante ne sera jamais supprim¨¦e, m¨ºme si cela aurait d? l'¨ºtre ¨¤ cause des r¨¨gles de suppression.
Le param¨¨tre Type d'information de la rubrique s'affiche en bas de l'onglet lorsqu'au moins une ¨¦tape de pr¨¦traitement est d¨¦finie. Si n¨¦cessaire, il est possible de modifier le type d'informations sans quitter l'onglet ±Ê°ù¨¦³Ù°ù²¹¾±³Ù±ð³¾±ð²Ô³Ù. Voir la Cr¨¦ation d'un ¨¦l¨¦ment pour la description d¨¦taill¨¦e des param¨¨tres.
Si vous utilisez un multiplicateur personnalis¨¦ ou une valeur de stockage en tant que Changement par seconde pour les ¨¦l¨¦ments dont le type d'informations est d¨¦fini sur Num¨¦rique (non sign¨¦) et que la valeur calcul¨¦e r¨¦sultante est en fait un nombre flottant, la valeur calcul¨¦e est toujours accept¨¦e comme valeur correcte un en supprimant la partie d¨¦cimale et en stockant la valeur sous forme d'entier.
Tester
Le test des ¨¦tapes de pr¨¦traitement est utile pour s'assurer que les 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 d'un h?te
Chaque ¨¦tape de pr¨¦traitement peut ¨ºtre test¨¦e individuellement et toutes les ¨¦tapes peuvent ¨ºtre test¨¦es ensemble. Lorsque vous cliquez sur le bouton Tester ou Tester toutes les ¨¦tapes respectivement dans le bloc Actions, une fen¨ºtre de test s'ouvre.
Tester une valeur hypoth¨¦tique
| ±Ê²¹°ù²¹³¾¨¨³Ù°ù±ð | Description |
|---|---|
| Obtenir la valeur de l'h?te | Si vous souhaitez tester une valeur hypoth¨¦tique, laissez cette case d¨¦coch¨¦e. Voir aussi : Tester la valeur r¨¦elle. |
| Valeur | Entrez la valeur d'entr¨¦e ¨¤ tester. Cliquer dans le champ param¨¨tre ou sur le bouton afficher/modifier ouvrira une fen¨ºtre de zone de texte pour entrer la valeur ou le bloc de code. |
| Non pris en charge | Cochez cette case pour tester une valeur non prise en charge. Cette option est utile pour tester l'¨¦tape de pr¨¦traitement V¨¦rifier les valeurs non prises en charge. |
| Heure | L'heure de la valeur d'entr¨¦e est affich¨¦e : now (lecture seule). |
| Valeur pr¨¦c¨¦dente | Entrez une valeur d'entr¨¦e pr¨¦c¨¦dente ¨¤ comparer. Uniquement pour les ¨¦tapes de pr¨¦traitement Changement simple et ?tranglement. |
| Heure pr¨¦c¨¦dente | Entrez l'heure de la valeur d'entr¨¦e pr¨¦c¨¦dente ¨¤ comparer. Uniquement pour les ¨¦tapes de pr¨¦traitement Changement simple et ?tranglement. La valeur par d¨¦faut est bas¨¦e sur la valeur du champ "Intervalle de mise ¨¤ jour" 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 de test. |
| S¨¦quence de fin de ligne | S¨¦lectionnez la s¨¦quence de fin de ligne pour les valeurs d'entr¨¦e multilignes : LF - S¨¦quence LF (saut de ligne) CRLF - S¨¦quence CRLF (retour chariot-saut de ligne). |
| ?tapes de pr¨¦traitement | Les ¨¦tapes de pr¨¦traitement sont r¨¦pertori¨¦es ; le r¨¦sultat du test s'affiche pour chaque ¨¦tape apr¨¨s avoir cliqu¨¦ sur le bouton Tester. 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. Si "Personnalis¨¦ en cas d'¨¦chec" est sp¨¦cifi¨¦ pour l'¨¦tape et que l'action est effectu¨¦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 produit (erreur ou valeur). |
| ¸é¨¦²õ³Ü±ô³Ù²¹³Ù | Le r¨¦sultat final du test des ¨¦tapes de pr¨¦traitement s'affiche dans tous les cas lorsque toutes les ¨¦tapes sont test¨¦es ensemble (lorsque vous cliquez sur le bouton Tester toutes les ¨¦tapes). Le type de conversion vers le type de valeur du ¨¦l¨¦ment est ¨¦galement affich¨¦, par exemple ¸é¨¦²õ³Ü±ô³Ù²¹³Ù converti en num¨¦rique (non sign¨¦). |
Cliquez sur Tester pour voir le r¨¦sultat apr¨¨s chaque ¨¦tape de pr¨¦traitement.
Les valeurs de test sont stock¨¦es entre les sessions de test pour les ¨¦tapes individuelles ou toutes les ¨¦tapes, ce qui permet ¨¤ l'utilisateur de modifier les ¨¦tapes de pr¨¦traitement ou la configuration des ¨¦l¨¦ments, puis de revenir ¨¤ la fen¨ºtre de test sans avoir ¨¤ ressaisir les informations. Les valeurs sont cependant perdues lors d'une actualisation de la page.
Les tests sont effectu¨¦s par le serveur Áú»¢¶Ä²©. Le frontend envoie une requ¨ºte correspondante au serveur et attend le r¨¦sultat. La demande contient la valeur d'entr¨¦e et les ¨¦tapes de pr¨¦traitement (avec des macros utilisateur ¨¦tendues). Pour les ¨¦tapes Changement et ?tranglement, une valeur pr¨¦c¨¦dente et une heure facultatives peuvent ¨ºtre sp¨¦cifi¨¦es. Le serveur r¨¦pond avec des r¨¦sultats pour chaque ¨¦tape de pr¨¦traitement.
Toutes les erreurs techniques ou les erreurs de validation des entr¨¦es sont affich¨¦es dans la bo?te d'erreur en haut de la fen¨ºtre de test.
Tester la valeur r¨¦elle
Pour tester le pr¨¦traitement par rapport ¨¤ une valeur r¨¦elle :
- Cochez la case Obtenir la valeur de l'h?te
- Entrez ou v¨¦rifiez les param¨¨tres de l'h?te (adresse de l'h?te, port, nom du proxy/pas de 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 sensibles au contexte :
- 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 d'agent s¨¦lectionn¨¦e de l'h?te
- Les valeurs doivent ¨ºtre renseign¨¦es manuellement pour les ¨¦l¨¦ments de mod¨¨le
- Les valeurs de macro en texte brut sont r¨¦solues
- Les champs o¨´ la valeur (ou une partie de la valeur) est un secret ou une macro Vault sont vides et doivent ¨ºtre saisis 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, l'adresse h?te et les champs proxy sont d¨¦sactiv¨¦s pour les ¨¦l¨¦ments calcul¨¦s)
- Cliquez sur Obtenir une 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 '¸é¨¦²õ³Ü±ô³Ù²¹³Ù avec mappage de valeurs appliqu¨¦'.
±Ê²¹°ù²¹³¾¨¨³Ù°ù±ðs sp¨¦cifiques ¨¤ l'obtention d'une valeur r¨¦elle d'un h?te :
| ±Ê²¹°ù²¹³¾¨¨³Ù°ù±ð | Description |
|---|---|
| Obtenir la valeur de l'h?te | Cochez cette case pour obtenir une valeur r¨¦elle de l'h?te. |
| Adresse de l'h?te | Entrez l'adresse de l'h?te. Ce champ est automatiquement renseign¨¦ par l'adresse de l'interface h?te de l'¨¦l¨¦ment. |
| Port | Entrez le port h?te. Ce champ est automatiquement renseign¨¦ par le port de l'interface h?te de l'¨¦l¨¦ment. |
| Champs suppl¨¦mentaires pour les interfaces SNMP (version SNMP, communaut¨¦ SNMP, nom de contexte, etc.) |
Voir Configuration de la surveillance SNMP pour plus de d¨¦tails sur la configuration d'un Interface SNMP (v1, v2 et v3). Ces champs sont remplis automatiquement depuis 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). |
Pour le reste des param¨¨tres, voir Tester la valeur hypoth¨¦tique ci-dessus.