Documentation
Table of Contents
1 Types de Media
Aper?u
Les m¨¦dias sont les canaux de diffusion utilis¨¦s pour envoyer des notifications et des alertes depuis Áú»¢¶Ä²©.
Vous pouvez configurer plusieurs types de m¨¦dias :
Les types de m¨¦dias sont configur¨¦s dans Administration ¡ú Types de m¨¦dias.
Certains types de m¨¦dias sont pr¨¦d¨¦finis dans le jeu de donn¨¦es par d¨¦faut. Il vous suffit d'affiner leurs ±è²¹°ù²¹³¾¨¨³Ù°ù±ðs pour les faire fonctionner.
Il est possible de tester si un type de m¨¦dia configur¨¦ fonctionne, en cliquant sur Tester dans la derni¨¨re colonne (voir Test de type de m¨¦dia pour plus de d¨¦tails).
Pour cr¨¦er un nouveau type de m¨¦dia, cliquez sur le bouton Cr¨¦er un type de m¨¦dia. Un formulaire de configuration de type de m¨¦dia s'ouvre.
±Ê²¹°ù²¹³¾¨¨³Ù°ù±ðs communs
Certains ±è²¹°ù²¹³¾¨¨³Ù°ù±ðs sont communs ¨¤ tous les types de m¨¦dias.
Dans l'onglet Type de m¨¦dia, les attributs g¨¦n¨¦raux communs sont :
| ±Ê²¹°ù²¹³¾¨¨³Ù°ù±ð | Description |
|---|---|
| Nom | Nom du type de m¨¦dia. |
| Type | ³§¨¦±ô±ð³¦³Ù¾±´Ç²Ô²Ô±ð³ú le type de m¨¦dia. |
| Description | Entrez une description. |
| ´¡³¦³Ù¾±±¹¨¦ | Cochez la case pour activer le type de m¨¦dia. |
Voir les pages individuelles des types de m¨¦dias pour les ±è²¹°ù²¹³¾¨¨³Ù°ù±ðs sp¨¦cifiques aux m¨¦dias.
L'onglet ²Ñ´Ç»å¨¨±ô±ðs de message permet de d¨¦finir des messages de notification par d¨¦faut pour tout ou partie des types d'¨¦±¹¨¦²Ô±ð³¾±ð²Ô³Ù²õ suivants :
- ±Ê°ù´Ç²ú±ô¨¨³¾±ð
- R¨¦cup¨¦ration de probl¨¨me
- Mise ¨¤ jour du probl¨¨me
- Service
- Reprise de service
- Mise ¨¤ jour de service
- ¶Ù¨¦³¦´Ç³Ü±¹±ð°ù³Ù±ð
- Enregistrement automatique
- ±Ê°ù´Ç²ú±ô¨¨³¾±ð interne
- R¨¦cup¨¦ration de probl¨¨me interne
Pour personnaliser les mod¨¨les de message :
- Dans l'onglet ²Ñ´Ç»å¨¨±ô±ðs de messages cliquez sur
: une fen¨ºtre contextuelle ²Ñ´Ç»å¨¨±ô±ð de message s'ouvrira. - ³§¨¦±ô±ð³¦³Ù¾±´Ç²Ô²Ô±ð³ú Type de message requis et modifiez les textes Sujet et Message.
- Cliquez sur Ajouter pour enregistrer le mod¨¨le de message
±Ê²¹°ù²¹³¾¨¨³Ù°ù±ðs du mod¨¨le de message :
| ±Ê²¹°ù²¹³¾¨¨³Ù°ù±ð | Description |
|---|---|
| Type de message | Type d'¨¦v¨¦nement pour lequel le message par d¨¦faut doit ¨ºtre utilis¨¦. Un seul message par d¨¦faut peut ¨ºtre d¨¦fini pour chaque type d'¨¦v¨¦nement. |
| Sujet | |
| Message | Le message par d¨¦faut. Il est limit¨¦ ¨¤ un certain nombre de caract¨¨res en fonction du type de base de donn¨¦es (voir Envoi de messages pour plus d'informations). Le message peut contenir des macros prises en charge. Dans les messages de probl¨¨me et de mise ¨¤ jour de probl¨¨me, les macros d'expression sont prises en charge (par exemple, {?avg(/host/key,1h)}). |
Pour apporter des modifications ¨¤ un mod¨¨le de message existant : Dans la colonne Actions, cliquez sur
pour modifier le mod¨¨le ou cliquez sur 
pour supprimer le mod¨¨le de message.
Il est possible de d¨¦finir un mod¨¨le de message personnalis¨¦ pour une action sp¨¦cifique (voir les op¨¦rations d'action pour plus de d¨¦tails). Les messages personnalis¨¦s d¨¦finis dans la configuration de l'action remplaceront le mod¨¨le de message de type de m¨¦dia par d¨¦faut.
La d¨¦finition de mod¨¨les de message est obligatoire pour tous les types de m¨¦dias, y compris les webhooks ou les scripts d'alerte personnalis¨¦s qui n'utilisent pas les messages par d¨¦faut pour les notifications. Par exemple, une action "Envoyer un message au webhook Pushover" ne parviendra pas ¨¤ envoyer des notifications de probl¨¨me, si le message ±Ê°ù´Ç²ú±ô¨¨³¾±ð pour le webhook Pushover n'est pas d¨¦fini.
L'onglet Options contient les ±è²¹°ù²¹³¾¨¨³Ù°ù±ðs de traitement des alertes. Le m¨ºme ensemble d'options est configurable pour chaque type de support.
Tous les types de m¨¦dias sont trait¨¦s en parall¨¨le. Bien que le nombre maximal de sessions simultan¨¦es soit configurable par type de m¨¦dia, le nombre total de processus d'alerte sur le serveur ne peut ¨ºtre limit¨¦ que par le ±è²¹°ù²¹³¾¨¨³Ù°ù±ð StartAlerters. Les alertes g¨¦n¨¦r¨¦es par un d¨¦clencheur sont trait¨¦es s¨¦quentiellement. Ainsi, plusieurs notifications ne peuvent ¨ºtre trait¨¦es simultan¨¦ment que si elles sont g¨¦n¨¦r¨¦es par plusieurs d¨¦clencheurs.
| ±Ê²¹°ù²¹³¾¨¨³Ù°ù±ð | Description |
|---|---|
| Sessions simultan¨¦es | ³§¨¦±ô±ð³¦³Ù¾±´Ç²Ô²Ô±ð³ú le nombre de sessions d'alerte parall¨¨les pour le type de m¨¦dia : Une - une session ±õ±ô±ô¾±³¾¾±³Ù¨¦ - un nombre illimit¨¦ de sessions ±Ê±ð°ù²õ´Ç²Ô²Ô²¹±ô¾±²õ¨¦ - s¨¦lectionnez un nombre personnalis¨¦ de sessions Des valeurs illimit¨¦es/¨¦lev¨¦es signifient plus de sessions parall¨¨les et une capacit¨¦ accrue d'envoi de notifications. Des valeurs illimit¨¦es/¨¦lev¨¦es doivent ¨ºtre utilis¨¦es dans les grands environnements o¨´ de nombreuses notifications peuvent devoir ¨ºtre envoy¨¦es simultan¨¦ment. Si plus de notifications doivent ¨ºtre envoy¨¦es qu'il n'y a de sessions simultan¨¦es, les notifications restantes seront mises en file d'attente ; ils ne seront pas perdus. |
| Tentatives | Nombre de tentatives d'envoi d'une notification. Jusqu'¨¤ 100 tentatives peuvent ¨ºtre sp¨¦cifi¨¦es ; la valeur par d¨¦faut est '3'. Si '1' est sp¨¦cifi¨¦, Áú»¢¶Ä²© n'enverra la notification qu'une seule fois et ne r¨¦essayera pas si l'envoi ¨¦choue. |
| Intervalle de tentative | Fr¨¦quence des tentatives de renvoi d'une notification en cas d'¨¦chec de l'envoi, en secondes (0-3600). Si '0' est sp¨¦cifi¨¦, Áú»¢¶Ä²© r¨¦essayera imm¨¦diatement. Les suffixes horaires sont pris en charge, par ex. 5s, 3m, 1h. |
Test de type de m¨¦dia
Il est possible de tester si un type de m¨¦dia configur¨¦ fonctionne.
Par exemple, pour tester un type de media e-mail :
- Cliquez sur Test dans la derni¨¨re colonne de la liste (une fen¨ºtre de test s'ouvrira)
- Entrez une adresse de destinataire Envoyer ¨¤ et facultativement le corps et le sujet
- Envoyez un message de test en cliquant sur Tester
Le message de r¨¦ussite ou d'¨¦chec du test s'affichera dans la m¨ºme fen¨ºtre :
 |
|---|
Webhook
Pour tester un type de m¨¦dia webhook :
- Localisez le webhook pertinent dans la liste des types de m¨¦dia
- Cliquez sur Test dans la derni¨¨re colonne de la liste (une fen¨ºtre de test s'ouvrira)
- Modifiez les valeurs des ±è²¹°ù²¹³¾¨¨³Ù°ù±ðs du webhook, si n¨¦cessaire
- Cliquez sur Tester
Par d¨¦faut, les tests de webhook sont effectu¨¦s avec des ±è²¹°ù²¹³¾¨¨³Ù°ù±ðs saisis lors de la configuration. Cependant, il est possible de modifier les valeurs d'attribut pour les tests. Le remplacement ou la suppression de valeurs dans la fen¨ºtre de test n'affecte que la proc¨¦dure de test, les valeurs r¨¦elles des attributs du webhook resteront inchang¨¦es.
 |
|---|
Pour afficher les entr¨¦es du journal de test de type de media sans quitter la fen¨ºtre de test :
- Cliquez sur Ouvrir le journal (une nouvelle fen¨ºtre contextuelle s'ouvrira).
 |
|---|
Si le test du webhook est r¨¦ussi
- Le message "Test du type de support r¨¦ussi." s'affiche
- La r¨¦ponse du serveur appara?t dans le champ gris ¸é¨¦±è´Ç²Ô²õ±ð
- Le type de r¨¦ponse (JSON ou String) est sp¨¦cifi¨¦ sous le champ ¸é¨¦±è´Ç²Ô²õ±ð
Si le test du webhook ¨¦choue
- Le message "?chec du test du type de support." s'affiche, suivi de d¨¦tails suppl¨¦mentaires sur l'¨¦chec.
M¨¦dia utilisateur
Pour recevoir des notifications d'un type de m¨¦dia, un m¨¦dia (adresse e-mail/num¨¦ro de t¨¦l¨¦phone/ID utilisateur webhook, etc.) pour ce type de m¨¦dia doit ¨ºtre d¨¦fini dans le profil de l'utilisateur. Par exemple, une action envoyant des messages ¨¤ l'utilisateur "Admin" ¨¤ l'aide du webhook "X" ¨¦chouera toujours ¨¤ envoyer quoi que ce soit si le support du webhook "X" n'est pas d¨¦fini dans le profil de l'utilisateur.
Pour d¨¦finir un m¨¦dia utilisateur :
- Allez dans votre profil d'utilisateur, ou allez dans Administration ¡ú Utilisateurs et ouvrez le formulaire des propri¨¦t¨¦s de l'utilisateur
- Dans l'onglet M¨¦dia, cliquez sur
Attributs de m¨¦dia utilisateur :
| ±Ê²¹°ù²¹³¾¨¨³Ù°ù±ð | Description |
|---|---|
| Type | La liste d¨¦roulante contient les noms de tous les types de m¨¦dias configur¨¦s. |
| Envoyer ¨¤ | Fournir les coordonn¨¦es requises o¨´ envoyer les messages. Pour un type de m¨¦dia e-mail, il est possible d'ajouter plusieurs adresses en cliquant sur sous le champ d'adresse. Dans ce cas, la notification sera envoy¨¦e ¨¤ toutes les adresses e-mail fournies. Il est ¨¦galement possible de sp¨¦cifier le nom du destinataire dans le champ Envoyer ¨¤ du destinataire de l'e-mail au format 'Nom du destinataire <[email protected]>'. Notez que si un nom de destinataire est fourni, une adresse e-mail doit ¨ºtre plac¨¦e entre crochets (<>). Les caract¨¨res UTF-8 dans le nom sont pris en charge, les paires entre guillemets et les commentaires ne le sont pas. Par exemple : John Abercroft <[email protected]> et [email protected] sont tous deux des formats valides. Exemples incorrects : John Doe [email protected], %%"Áú»¢¶Ä²©\@\<H(comment)Q\>" [email protected] %%. |
| Lorsqu'il est actif | Vous pouvez limiter le temps d'envoi des messages, par exemple, d¨¦finir les jours ouvrables uniquement (1-5,09:00-18:00). Notez que cette limite est bas¨¦e sur le fuseau horaire de l'utilisateur. Si le fuseau horaire de l'utilisateur est modifi¨¦ et diff¨¦rent du fuseau horaire du syst¨¨me, cette limite peut devoir ¨ºtre ajust¨¦e en cons¨¦quence afin de ne pas manquer de messages importants. Voir la page Sp¨¦cification de la p¨¦riode pour la description du format. |
| Utiliser si la s¨¦v¨¦rite | Cochez les cases des s¨¦v¨¦rit¨¦s des d¨¦clencheurs pour lesquelles vous souhaitez recevoir des notifications. Notez que la s¨¦v¨¦rit¨¦ par d¨¦faut ("Non class¨¦") doit ¨ºtre coch¨¦e si vous souhaitez recevoir des notifications pour les ¨¦±¹¨¦²Ô±ð³¾±ð²Ô³Ù²õ non d¨¦clencheurs. Apr¨¨s l'enregistrement, les s¨¦v¨¦rit¨¦s de d¨¦clenchement s¨¦lectionn¨¦es seront affich¨¦es dans les couleurs de s¨¦v¨¦rit¨¦ correspondantes, tandis que celles non s¨¦lectionn¨¦es seront gris¨¦es. |
| ?tat | ?tat du m¨¦dia utilisateur. ´¡³¦³Ù¾±±¹¨¦ - est en cours d'utilisation. ¶Ù¨¦²õ²¹³¦³Ù¾±±¹¨¦ - n'est pas utilis¨¦. |