Áú»¢¶Ä²©

1 Cr¨¦ation d'un ¨¦l¨¦ment

Aper?u

Pour cr¨¦er un ¨¦l¨¦ment dans l'interface web Áú»¢¶Ä²©, proc¨¦dez comme suit :

• Allez dans : Configuration ¡ú H?tes
• Cliquez sur ·¡±ô¨¦³¾±ð²Ô³Ùs dans la rang¨¦e correspondant ¨¤ l'h?te
• Cliquez sur Cr¨¦er un ¨¦l¨¦ment dans le coin sup¨¦rieur droit de l'¨¦cran
• Entrez les ±è²¹°ù²¹³¾¨¨³Ù°ù±ð²õ de l'¨¦l¨¦ment dans le formulaire

Vous pouvez ¨¦galement cr¨¦er un ¨¦l¨¦ment en ouvrant un ¨¦l¨¦ment existant, en appuyant sur le bouton Cloner, puis en enregistrant sous un autre nom.

Configuration

L'onglet ·¡±ô¨¦³¾±ð²Ô³Ù contient les attributs g¨¦n¨¦raux de l'¨¦l¨¦ment.

Tous les champs de saisie obligatoires sont marqu¨¦s d'un ast¨¦risque rouge.

±Ê²¹°ù²¹³¾¨¨³Ù°ù±ð	Description
Name	Nom de l'¨¦l¨¦ment.
Type	Type d'¨¦l¨¦ment. Voir les sections sur les [types d'¨¦l¨¦ments].
Key	Cl¨¦ d'¨¦l¨¦ment (jusqu'¨¤ 2 048 caract¨¨res). Les cl¨¦s d'¨¦l¨¦ment prises en charge peuvent ¨ºtre trouv¨¦es dans les sections sur les types d'¨¦l¨¦ments. La cl¨¦ doit ¨ºtre unique au sein d'un m¨ºme h?te. Si le type de cl¨¦ est 'Agent Áú»¢¶Ä²©', 'Agent Áú»¢¶Ä²© (actif)' ou 'Simple check', la valeur de la cl¨¦ doit ¨ºtre prise en charge par l'agent Áú»¢¶Ä²© ou le serveur Áú»¢¶Ä²©. Voir ¨¦galement : format de cl¨¦ correct.
Type of information	Type de donn¨¦es telles qu'elles sont stock¨¦es dans la base de donn¨¦es apr¨¨s avoir effectu¨¦ les conversions, le cas ¨¦ch¨¦ant. Num¨¦rique (non sign¨¦) - Entier non sign¨¦ 64 bits Num¨¦rique (flottant) - Nombre ¨¤ virgule flottante 64 bits Ceci permettra une pr¨¦cision d'environ 15 chiffres et une plage d'environ -1,79E+308 ¨¤ 1,79E+308 (¨¤ l'exception de PostgreSQL 11 et versions ant¨¦rieures). La gestion des valeurs en notation scientifique est ¨¦galement prise en charge. Par exemple. 1.23E+7, 1e308, 1.1E-4. °ä²¹°ù²¹³¦³Ù¨¨°ù±ð - donn¨¦es textuelles courtes Log - donn¨¦es textuelles longues avec des propri¨¦t¨¦s facultatives li¨¦es au log (horodatage, source, gravit¨¦, logeventid) Texte - donn¨¦es textuelles longues. Voir aussi limites de donn¨¦es textuelles. Pour les cl¨¦s d'¨¦l¨¦ment qui ne renvoient des donn¨¦es que dans un format sp¨¦cifique, le type d'informations correspondant est s¨¦lectionn¨¦ automatiquement.
Host interface	S¨¦lection de l'interface de l'h?te. Ce champ est disponible lors de la modification d'un ¨¦l¨¦ment au niveau de l'h?te.
Units	Si un symbole d'unit¨¦ est d¨¦fini, Áú»¢¶Ä²© ajoutera un post-traitement ¨¤ la valeur re?ue et l'affichera avec le suffixe d'unit¨¦ d¨¦fini. Par d¨¦faut, si la valeur brute d¨¦passe 1 000, elle est divis¨¦e par 1 000 et affich¨¦e en cons¨¦quence. Par exemple, si vous d¨¦finissez bps et recevez une valeur de 881764, elle sera affich¨¦e sous la forme 881,76 Kbps. La norme de m¨¦moire est utilis¨¦e pour traiter les unit¨¦s B (octet), Bps (octets par seconde), qui sont divis¨¦es par 1024. Ainsi, si les unit¨¦s sont d¨¦finies sur B ou Bps, Áú»¢¶Ä²© affichera : 1 comme 1B/1Bps 1024 comme 1KB/1KBps 1536 comme 1.5KB/1.5KBps Un traitement sp¨¦cial est utilis¨¦ si les unit¨¦s temporelles suivantes sont utilis¨¦es : unixtime - traduit par "aaaa.mm.jj hh:mm:ss". Pour traduire correctement, la valeur re?ue doit ¨ºtre un type d'information Num¨¦rique (non sign¨¦). uptime - traduit en "hh:mm:ss" ou "N days, hh:mm:ss" Par exemple, si vous recevez la valeur comme 881764 (secondes), elle sera affich¨¦e comme "10 jours, 04:56:04" s - traduit par "aaa mmm jjhhh mmm sss ms " ; le param¨¨tre est trait¨¦ comme un nombre de secondes. Par exemple, si vous recevez la valeur comme 881764 (secondes), elle sera affich¨¦e comme "10d 4h 56m" Seules 3 unit¨¦s majeures sup¨¦rieures sont affich¨¦es, comme "1m 15d 5h" ou "2h 4m 46s". S'il n'y a pas de jours ¨¤ afficher, seuls deux niveaux sont affich¨¦s - "1m 5h" (aucune minute, seconde ou milliseconde n'est affich¨¦e). Sera traduit en "< 1 ms" si la valeur est inf¨¦rieure ¨¤ 0,001. Notez que si une unit¨¦ est pr¨¦fix¨¦e par !, aucun pr¨¦fixe/traitement d'unit¨¦ n'est appliqu¨¦ aux valeurs d'¨¦l¨¦ment. Voir conversion d'unit¨¦.
Update interval	R¨¦cup¨¨re une nouvelle valeur pour cet ¨¦l¨¦ment toutes les N secondes. L'intervalle de mise ¨¤ jour maximal autoris¨¦ est de 86 400 secondes (1 jour). Les suffixes temporels sont pris en charge, par ex. 30s, 1m, 2h, 1d. Les macros utilisateur sont support¨¦es. Une seule macro doit remplir tout le champ. Les macros multiples dans un champ ou les macros m¨¦lang¨¦es avec du texte ne sont pas prises en charge. Remarque : L'intervalle de mise ¨¤ jour ne peut ¨ºtre d¨¦fini sur "0" que s'il existe des intervalles personnalis¨¦s avec une valeur diff¨¦rente de z¨¦ro. S'il est d¨¦fini sur "0" et qu'un intervalle personnalis¨¦ (flexible ou programm¨¦) existe avec une valeur diff¨¦rente de z¨¦ro, l'¨¦l¨¦ment sera interrog¨¦ pendant la dur¨¦e de l'intervalle personnalis¨¦. Notez que le premier ¨¦l¨¦ment interrog¨¦ apr¨¨s que l'¨¦l¨¦ment soit devenu actif ou apr¨¨s un changement d'intervalle de mise ¨¤ jour peut se produire plus t?t que la valeur configur¨¦e. Un ¨¦l¨¦ment passif existant peut ¨ºtre interrog¨¦ pour une valeur imm¨¦diatement en appuyant sur le bouton Ex¨¦cuter maintenant (#form_buttons).
Custom intervals	Vous pouvez cr¨¦er des r¨¨gles personnalis¨¦es pour v¨¦rifier l'¨¦l¨¦ment : Flexible - cr¨¦er une exception ¨¤ l'intervalle de mise ¨¤ jour (intervalle avec une fr¨¦quence diff¨¦rente) Planification - cr¨¦er un calendrier d'interrogation personnalis¨¦. Pour des informations d¨¦taill¨¦es, voir Intervalles personnalis¨¦s. Les suffixes de temps sont pris en charge dans le champ Interval, par ex. 30s, 1m, 2h, 1d. Les macros utilisateur sont support¨¦es. Une seule macro doit remplir tout le champ. Les macros multiples dans un champ ou les macros m¨¦lang¨¦es avec du texte ne sont pas prises en charge. La planification est prise en charge depuis Áú»¢¶Ä²© 3.0.0. Remarque : Non disponible pour les ¨¦l¨¦ments actifs de l'agent Áú»¢¶Ä²©.
History storage period	S¨¦lectionnez : Ne pas conserver l'historique : l'historique des ¨¦l¨¦ments n'est pas stock¨¦. Utile pour les ¨¦l¨¦ments principaux si seuls les ¨¦l¨¦ments d¨¦pendants doivent conserver l'historique. Ce param¨¨tre ne peut pas ¨ºtre remplac¨¦ dans les ±è²¹°ù²¹³¾¨¨³Ù°ù±ð²õ de la proc¨¦dure de nettoyage. P¨¦riode de stockage - sp¨¦cifiez la dur¨¦e de conservation de l'historique d¨¦taill¨¦ dans la base de donn¨¦es (1 heure ¨¤ 25 ans). Les donn¨¦es plus anciennes seront supprim¨¦es par la proc¨¦dure de nettoyage. Stock¨¦ en secondes. Les suffixes temporels sont pris en charge, par ex. 2h, 1j. Les macros utilisateur sont prises en charge. La valeur P¨¦riode de stockage peut ¨ºtre remplac¨¦e globalement dans Administration ¡ú G¨¦n¨¦ral ¡ú Nettoyage. Si un param¨¨tre prioritaire global existe, une ic?ne d'information verte s'affiche. Si vous placez votre souris dessus, un message d'avertissement s'affiche, par ex. Remplac¨¦ par les ±è²¹°ù²¹³¾¨¨³Ù°ù±ð²õ globaux de nettoyage (1d). Il est recommand¨¦ de conserver les valeurs enregistr¨¦es le moins longtemps possible afin de r¨¦duire la taille de l'historique des valeurs dans la base de donn¨¦es. Au lieu de conserver un long historique des valeurs, vous pouvez conserver des donn¨¦es plus longues avec les tendances. Voir ¨¦galement : Historique et tendances.
Trend storage period	S¨¦lectionnez soit : Ne pas conserver les tendances - les tendances ne sont pas stock¨¦es. Ce param¨¨tre ne peut pas ¨ºtre remplac¨¦ dans les ±è²¹°ù²¹³¾¨¨³Ù°ù±ð²õ de la proc¨¦dure de nettoyage. P¨¦riode de stockage : sp¨¦cifiez la dur¨¦e de conservation de l'historique agr¨¦g¨¦ (min, max, moy, comptage) dans la base de donn¨¦es (1 jour ¨¤ 25 ans). Les donn¨¦es plus anciennes seront supprim¨¦es par la proc¨¦dure de nettoyage. Stock¨¦ en secondes. Les suffixes temporels sont pris en charge, par ex. 24h, 1j. Les macros utilisateur sont prises en charge. La valeur P¨¦riode de stockage peut ¨ºtre remplac¨¦e globalement dans Administration ¡ú G¨¦n¨¦ral ¡ú Nettoyage. Si un param¨¨tre prioritaire global existe, une ic?ne d'information verte s'affiche. Si vous placez votre souris dessus, un message d'avertissement s'affiche, par ex. Remplac¨¦ par les ±è²¹°ù²¹³¾¨¨³Ù°ù±ð²õ g¨¦n¨¦raux du nettoyage (7d). Remarque : La conservation des tendances n'est pas disponible pour les donn¨¦es non num¨¦riques - caract¨¨res, log et texte. Voir aussi Historique et tendances.
Value mapping	Appliquez le mappage de valeur ¨¤ cet ¨¦l¨¦ment. Le mappage de valeur ne modifie pas les valeurs re?ues, il sert uniquement ¨¤ afficher les donn¨¦es. Il fonctionne avec les ¨¦l¨¦ments Num¨¦rique (non sign¨¦), Num¨¦rique (flottant) et °ä²¹°ù²¹³¦³Ù¨¨°ù±ð. Par exemple, "?tats du service Windows".
Log time format	Disponible uniquement pour les ¨¦l¨¦ments de type Log. Espaces r¨¦serv¨¦s pris en charge : * y : Ann¨¦e (1970-2038) * M : Mois (01-12) * d : Jour (01-31) * h : Heure (00-23) * m : Minute (00-59)<br >* s : Seconde (00-59) Si laiss¨¦ vide, l'horodatage ne sera pas analys¨¦. Par exemple, consid¨¦rez la ligne suivante du fichier de log de l'agent Áú»¢¶Ä²© : " 23480:20100328:154718.045 L'agent Áú»¢¶Ä²© a d¨¦marr¨¦. Áú»¢¶Ä²© 1.8.2 (r¨¦vision 11211)." Il commence par six positions de caract¨¨res pour le PID, suivis de la date, de l'heure et du reste de la ligne. Le format de cette ligne serait "pppppp:yyyyMMdd:hhmmss". Notez que les caract¨¨res "p" et ":" ne sont que des espaces r¨¦serv¨¦s et peuvent ¨ºtre autre chose que "yMdhms".
Populates host inventory field	Vous pouvez s¨¦lectionner un champ d'inventaire d'h?te que la valeur de l'¨¦l¨¦ment remplira. Cela fonctionnera si le remplissage automatique de l'inventaire est activ¨¦ pour l'h?te. Ce champ n'est pas disponible si Type d'information est d¨¦fini sur 'Log'.
Description	Entrez une description de l'¨¦l¨¦ment.
Enabled	Cochez la case pour activer l'¨¦l¨¦ment afin qu'il soit trait¨¦.
Latest data	Cliquez sur le lien pour afficher les derni¨¨res donn¨¦es de l'¨¦l¨¦ment. Ce lien n'est disponible que lors de la modification d'un ¨¦l¨¦ment d¨¦j¨¤ existant.

L'onglet Tags permet de d¨¦finir des tags au niveau de l'¨¦l¨¦ment.

±Ê°ù¨¦³Ù°ù²¹¾±³Ù±ð³¾±ð²Ô³Ù de la valeur de l'¨¦l¨¦ment

L'onglet ±Ê°ù¨¦³Ù°ù²¹¾±³Ù±ð³¾±ð²Ô³Ù permet de d¨¦finir des r¨¨gles de transformation pour les valeurs re?ues.

Test

Il est possible de tester un ¨¦l¨¦ment et, s'il est configur¨¦ correctement, d'obtenir une valeur r¨¦elle en retour. Les tests peuvent avoir lieu avant m¨ºme qu'un ¨¦l¨¦ment ne soit enregistr¨¦.

Les tests sont disponibles pour les ¨¦l¨¦ments d'h?te et de ³¾´Ç»å¨¨±ô±ð, les prototypes d'¨¦l¨¦ment et les r¨¨gles de d¨¦couverte de bas niveau. Les tests ne sont pas disponibles pour les ¨¦l¨¦ments actifs.

Les tests d'objets sont disponibles pour les types d'objets passifs suivants :

• Agent Áú»¢¶Ä²©
• Agent SNMP (v1, v2, v3)
• Agent IPMI
• V¨¦rifications SSH
• V¨¦rifications Telnet
• Agent JMX
• V¨¦rifications simples (sauf ¨¦l¨¦ments icmpping*, vmware.*)
• Áú»¢¶Ä²© interne
• ?l¨¦ments calcul¨¦s
• Contr?les externes
• Moniteur de base de donn¨¦es
• Agent HTTP
• ³§³¦¨¦²Ô²¹°ù¾±´Ç

Pour tester un ¨¦l¨¦ment, cliquez sur le bouton Tester en bas du formulaire de configuration de l'¨¦l¨¦ment. Notez que le bouton Tester sera d¨¦sactiv¨¦ pour les ¨¦l¨¦ments qui ne peuvent pas ¨ºtre test¨¦s (comme les v¨¦rifications actives et les v¨¦rifications simples).

Le formulaire de test d'¨¦l¨¦ment comporte des champs pour les ±è²¹°ù²¹³¾¨¨³Ù°ù±ð²õ d'h?te requis (adresse d'h?te, port, nom de proxy/pas de proxy) et des 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 reprenant les informations de l'interface agent s¨¦lectionn¨¦e de l'h¨¦bergeur
• Les valeurs doivent ¨ºtre renseign¨¦es manuellement pour les ¨¦l¨¦ments de type ³¾´Ç»å¨¨±ô±ð
• 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, le champ d'adresse h?te et le champ proxy sont d¨¦sactiv¨¦s pour les ¨¦l¨¦ments calcul¨¦s)

Pour tester l'¨¦l¨¦ment, cliquez sur Get value. Si la valeur est r¨¦cup¨¦r¨¦e avec succ¨¨s, elle remplira le champ Valeur, d¨¦pla?ant la valeur actuelle (le cas ¨¦ch¨¦ant) vers le champ Valeur pr¨¦c¨¦dente tout en calculant ¨¦galement le champs P¨¦riode pr¨¦c¨¦dente, c'est-¨¤-dire la diff¨¦rence de temps entre les deux valeurs (clics) et essaye de d¨¦tecter d'une s¨¦quence EOL et passage ¨¤ CRLF si d¨¦tection de "\n\r" dans la valeur r¨¦cup¨¦r¨¦e.

Si la configuration est incorrecte, un message d'erreur s'affiche d¨¦crivant la cause possible.

Une valeur r¨¦cup¨¦r¨¦e avec succ¨¨s depuis l'h?te peut ¨¦galement ¨ºtre utilis¨¦e pour tester les ¨¦tapes de pr¨¦traitement.

Boutons de formulaire

Des boutons en bas du formulaire permettent d'effectuer plusieurs op¨¦rations.

	Ajouter un ¨¦l¨¦ment. Ce bouton n'est disponible que pour les nouveaux ¨¦l¨¦ments.
	Mettre ¨¤ jour les propri¨¦t¨¦s d'un ¨¦l¨¦ment.
	Cr¨¦er un autre ¨¦l¨¦ment bas¨¦ sur les propri¨¦t¨¦s de l'¨¦l¨¦ment actuel.
	Ex¨¦cuter une v¨¦rification pour une nouvelle valeur d'¨¦l¨¦ment imm¨¦diatement. Pris en charge pour les v¨¦rifications passives uniquement (voir plus de d¨¦tails). Notez que lors de la v¨¦rification imm¨¦diate d'une valeur, le cache de configuration n'est pas mis ¨¤ jour, donc la valeur ne refl¨¦tera pas les modifications tr¨¨s r¨¦centes apport¨¦es ¨¤ la configuration de l'¨¦l¨¦ment.
	Testez si la configuration de l'¨¦l¨¦ment est correcte en obtenant une valeur.
	Supprimer l'historique et les tendances des ¨¦l¨¦ments.
	Supprimer l'¨¦l¨¦ment.
	Annuler la modification des propri¨¦t¨¦s de l'¨¦l¨¦ment.

Conversion d'unit¨¦

Par d¨¦faut, la sp¨¦cification d'une unit¨¦ pour un ¨¦l¨¦ment entra?ne l'ajout d'un pr¨¦fixe multiplicateur - par exemple, une valeur entrante ??2048?? avec l'unit¨¦ ??B?? serait affich¨¦e sous la forme ??2?Ko??.

Pour emp¨ºcher la conversion d'une unit¨¦, utilisez le pr¨¦fixe !, par exemple, !B. Pour mieux comprendre le fonctionnement de la conversion avec et sans le point d'exclamation, consultez les exemples de valeurs et d'unit¨¦s suivants?:

 1024 !B ¡ú 1024B
        1024 B ¡ú 1 Ko
        61 !s ¡ú 61s
        61 s ¡ú 1m 1s
        0 !uptime ¡ú 0 uptime
        0 uptime¡ú 00:00:00
        0 !! ¡ú 0 !
        0 ! ¡ú 0

Limites des donn¨¦es textuelles

Les limites des donn¨¦es de type texte d¨¦pendent du backend de la base de donn¨¦es. Avant de stocker les valeurs de texte dans la base de donn¨¦es, elles sont tronqu¨¦es pour correspondre ¨¤ la limite de type de valeur de la base de donn¨¦es?:

Limite de script personnalis¨¦

La longueur de script personnalis¨¦ disponible d¨¦pend de la base de donn¨¦es utilis¨¦e?:

?l¨¦ments non pris en charge

Un ¨¦l¨¦ment peut devenir non pris en charge si sa valeur ne peut pas ¨ºtre r¨¦cup¨¦r¨¦e pour une raison quelconque. Ces ¨¦l¨¦ments sont toujours rev¨¦rifi¨¦s ¨¤ leur intervalle de mise ¨¤ jour standard.

Les ¨¦l¨¦ments non pris en charge sont signal¨¦s comme ayant un ¨¦tat NON SUPPORT?.