Documentation
Table of Contents
12. Expressions r¨¦guli¨¨res
Aper?u
Les (PCRE) sont support¨¦es dans Áú»¢¶Ä²©.
Il y a deux fa?ons d'utiliser des expressions r¨¦guli¨¨res dans Áú»¢¶Ä²© :
- en entrant manuellement une expression r¨¦guli¨¨re
- en utilisant une expression r¨¦guli¨¨re globale cr¨¦¨¦e dans Áú»¢¶Ä²©
Expressions r¨¦guli¨¨res
Vous pouvez entrer manuellement une expression r¨¦guli¨¨re aux endroits support¨¦s. Notez que l¡¯expression ne peut pas commencer par @ car ce symbole est utilis¨¦ dans Áú»¢¶Ä²© pour r¨¦f¨¦rencer des expressions r¨¦guli¨¨res globales.
::: notewarning ?Il est possible de manquer de pile (out of stack) en utilisant des expressions r¨¦guli¨¨res. Reportez-vous ¨¤ la ] pour plus d'informations. :::?
Notez que dans une correspondance multiligne, les ancres ^ et $ correspondent au d¨¦but/¨¤ la fin de chaque ligne, respectivement, au lieu du d¨¦but/de la fin de la cha?ne enti¨¨re.
Expressions r¨¦guli¨¨res globales
Il existe un ¨¦diteur avanc¨¦ pour la cr¨¦ation et le test d¡¯expressions r¨¦guli¨¨res complexes dans l'interface web de Áú»¢¶Ä²©.
Une fois qu'une expression r¨¦guli¨¨re a ¨¦t¨¦ cr¨¦¨¦e de cette mani¨¨re, elle peut ¨ºtre utilis¨¦e ¨¤ plusieurs endroits dans l'interface en se r¨¦f¨¦rant ¨¤ son nom, pr¨¦c¨¦d¨¦ de @, par exemple, @mycustomregexp.
Pour cr¨¦er une expression r¨¦guli¨¨re globale :
- Aller dans Administration ¡ú G¨¦n¨¦ral
- ³§¨¦±ô±ð³¦³Ù¾±´Ç²Ô²Ô±ð³ú Expressions r¨¦guli¨¨res dans la liste d¨¦roulante.
- Cliquez sur Nouvelle expression r¨¦guli¨¨re
L'onglet Expressions permet de d¨¦finir le nom de l'expression r¨¦guli¨¨re et d'ajouter des sous-expressions.
Tous les champs de saisie obligatoires sont marqu¨¦s d'un ast¨¦risque rouge.
| ±Ê²¹°ù²¹³¾¨¨³Ù°ù±ð | Description | |
|---|---|---|
| Nom | D¨¦finissez le nom de l'expression r¨¦guli¨¨re. Tous les caract¨¨res Unicode sont autoris¨¦s. | |
| Expressions | Cliquez sur Ajouter dans le bloc Expressions pour ajouter une nouvelle sous-expression. | |
| Type d'expression | ³§¨¦±ô±ð³¦³Ù¾±´Ç²Ô²Ô±ð³ú le type d'expression : Cha?ne de caract¨¨res inclue - correspond ¨¤ la sous cha?ne Toute cha?ne de caract¨¨re inclue - correspond ¨¤ n'importe quelle sous-cha?ne d'une liste d¨¦limit¨¦e. La liste d¨¦limit¨¦e comprend une virgule (,), un point (.) ou une barre oblique (/) Cha?ne de caract¨¨res non inclue - correspond ¨¤ n'importe quelle cha?ne sauf la sous-cha?ne Le r¨¦sultat est VRAI - correspond ¨¤ l'expression r¨¦guli¨¨re Le r¨¦sultat est FAUX - ne correspond pas ¨¤ l'expression r¨¦guli¨¨re |
|
| Expression | Entrez une sous-cha?ne/expression r¨¦guli¨¨re. | |
| ¶Ù¨¦±ô¾±³¾¾±³Ù±ð³Ü°ù | Une virgule (,), un point (.) ou une barre oblique (/) pour s¨¦parer les cha?nes de texte dans une expression r¨¦guli¨¨re. Ce ±è²¹°ù²¹³¾¨¨³Ù°ù±ð est actif uniquement lorsque le type d'expression "Toute cha?ne de caract¨¨res inclue" est s¨¦lectionn¨¦. | |
| Sensible ¨¤ la casse | Une case ¨¤ cocher pour sp¨¦cifier si une expression r¨¦guli¨¨re est sensible ¨¤ la casse. | |
Depuis Áú»¢¶Ä²© 2.4.0, une barre oblique (/) dans l'expression est trait¨¦e litt¨¦ralement, plut?t que comme d¨¦limiteur. De cette fa?on, il est possible de sauvegarder des expressions contenant une barre oblique, alors que cela produisait auparavant une erreur.
Un nom d'expression r¨¦guli¨¨re personnalis¨¦ dans Áú»¢¶Ä²© peut contenir des virgules, des espaces, etc. Dans les cas o¨´ cela peut conduire ¨¤ une interpr¨¦tation erron¨¦e lors du r¨¦f¨¦rencement (par exemple, une virgule dans le ±è²¹°ù²¹³¾¨¨³Ù°ù±ð d'une cl¨¦ d'¨¦l¨¦ment), la r¨¦f¨¦rence enti¨¨re peut ¨ºtre plac¨¦e entre guillemets : "@My custom regexp for purpose1, purpose2".
Les noms des expressions r¨¦guli¨¨res ne doivent pas ¨ºtre entre guillemets ailleurs (par exemple, dans les propri¨¦t¨¦s de la r¨¨gle LLD).
Exemple
Utilisation de l'expression r¨¦guli¨¨re suivante dans la LLD pour d¨¦couvrir des bases de donn¨¦es ne prenant pas en compte une base de donn¨¦es portant un nom sp¨¦cifique :
Type d'expression choisie : "Le r¨¦sultat est FAUX". Ne correspond pas au nom, contenant la cha?ne ¡°TESTDATABASE¡±.
Exemple avec un modificateur de regex en ligne
Utilisation de l'expression r¨¦guli¨¨re suivante, y compris un modificateur en ligne (?i) pour faire correspondre les caract¨¨res "error" :
Type d'expression choisie : "Le r¨¦sultat est VRAI". Les caract¨¨res "error" correspondent.
Un autre exemple avec un modificateur de regex en ligne
Utilisation de l'expression r¨¦guli¨¨re suivante, y compris plusieurs modificateurs en ligne, pour faire correspondre les caract¨¨res apr¨¨s une ligne sp¨¦cifique :
(?<=match (?i)everything(?-i) after this line\n)(?sx).*# we add s modifier to allow . match newline characters
Type d'expression choisie : "Le r¨¦sultat est VRAI". Les caract¨¨res apr¨¨s une ligne sp¨¦cifique correspondent.
Le modificateur g ne peut pas ¨ºtre sp¨¦cifi¨¦ dans la ligne. La liste des modificateurs disponibles se trouve dans la . Pour plus d'informations sur la syntaxe PCRE, reportez-vous ¨¤ la .
Exemple plus complexe
Une expression r¨¦guli¨¨re personnalis¨¦e peut comprendre plusieurs sous-expressions et peut ¨ºtre test¨¦e dans l'onglet Test en fournissant une cha?ne de test.
Les r¨¦sultats montrent le statut de chaque sous-expression et le statut total de l'expression personnalis¨¦e.
Le statut total de l'expression personnalis¨¦e est d¨¦fini en tant que R¨¦sultat combin¨¦. Si plusieurs sous-expressions sont d¨¦finies, Áú»¢¶Ä²© utilise l'op¨¦rateur logique ET pour calculer le R¨¦sultat combin¨¦. Cela signifie que si au moins un r¨¦sultat est faux, le R¨¦sultat combin¨¦ a ¨¦galement le statut faux.
Explication des expressions r¨¦guli¨¨res globales
| Regexp Globale | Expression | Description |
|---|---|---|
| Syst¨¨me de fichiers pour la d¨¦couverte | ^(btrfs\|ext2\|ext3\|ext4\|jfs\|reiser\|xfs\|ffs\|ufs\|jfs\|jfs2\|vxfs\|hfs\|refs\|apfs\|ntfs\|fat32\|zfs)$ |
Correspond ¨¤ "btrfs" ou "ext2" ou "ext3" ou "ext4" ou "jfs" ou "reiser" ou " xfs" ou "ffs" ou "ufs" ou "jfs" ou "jfs2" ou "vxfs" ou "hfs" ou "refs" ou "apfs" ou "ntfs" ou "fat32" ou "zfs" |
| Interfaces r¨¦seau pour la d¨¦couverte | ^Software Loopback Interface |
Correspond aux cha?nes commen?ant par "Software Loopback Interface" |
^lo$ |
Correspond ¨¤ "lo" | |
^(In)?[Ll]oop[Bb]ack[0-9._]*$ |
Correspond aux cha?nes qui commencent ¨¦ventuellement par "In", puis ont "L" ou "l", puis "oop", puis "B" ou "b", puis "ack", qui peut ¨¦ventuellement ¨ºtre suivi d'un nombre quelconque de chiffres, points ou underscores | |
^NULL[0-9.]*$ |
Correspond aux cha?nes avec "NULL" ¨¦ventuellement suivies d'un nombre quelconque de chiffres ou de points | |
^[Ll]o[0-9.]*$ |
Correspond aux cha?nes commen?ant par "Lo" ou "lo" et ¨¦ventuellement suivies d'un nombre quelconque de chiffres ou de points | |
^[Ss]ystem$ |
Correspond ¨¤ "System" ou "system" | |
^Nu[0-9.]*$ |
Correspond aux cha?nes avec "Nu" ¨¦ventuellement suivies d'un nombre quelconque de chiffres ou de points | |
| P¨¦riph¨¦riques de stockage pour la d¨¦couverte SNMP | ^(Physical memory\|Virtual memory\|Memory buffers\|Cached memory\|Swap space)$ |
Correspond ¨¤ "Physical memory" ou "Virtual memory" ou "Memory buffers" ou "Cached memory" ou "Swap space" |
| Noms de services Windows pour la d¨¦couverte | ^(MMCSS\|gupdate\|SysmonLog\|clr_optimization_v2.0.50727_32\|clr_optimization_v4.0.30319_32)$ |
Correspond ¨¤ "MMCSS" ou "gupdate" ou "SysmonLog" ou des cha?nes comme "clr_optimization_v2.0.50727_32" et "clr_optimization_v4.0.30319_32" o¨´ au lieu de points, vous pouvez ins¨¦rer un caract¨¨re sauf newline |
| ?tats de d¨¦marrage du service Windows pour la d¨¦couverte | ^(automatic\|automatic delayed)$ |
Correspond ¨¤ "automatic" ou "automatic delayed" |
Support d'expression r¨¦guli¨¨re par emplacement
| Emplacement | Expression r¨¦guli¨¨re | Expression r¨¦guli¨¨re globale | Commentaires | |
|---|---|---|---|---|
| ?l¨¦ment d'agent | ||||
| eventlog[] | Oui | Oui | ±è²¹°ù²¹³¾¨¨³Ù°ù±ð²õ regexp, severity, source, eventid |
|
| log[] | ±è²¹°ù²¹³¾¨¨³Ù°ù±ð regexp |
|||
| log.count[] | ||||
| logrt[] | Oui/Non | ±è²¹°ù²¹³¾¨¨³Ù°ù±ð regexp supporte les deux, ±è²¹°ù²¹³¾¨¨³Ù°ù±ð file_regexp supporte uniquement les expressions non-globales |
||
| logrt.count[] | ||||
| proc.cpu.util[] | Non | ±è²¹°ù²¹³¾¨¨³Ù°ù±ð cmdline |
||
| proc.mem[] | ||||
| proc.num[] | ||||
| sensor[] | ±è²¹°ù²¹³¾¨¨³Ù°ù±ð²õ device et sensor sur Linux 2.4 |
|||
| system.hw.macaddr[] | ±è²¹°ù²¹³¾¨¨³Ù°ù±ð interface |
|||
| system.sw.packages[] | ±è²¹°ù²¹³¾¨¨³Ù°ù±ð package |
|||
| vfs.dir.count[] | ±è²¹°ù²¹³¾¨¨³Ù°ù±ð²õ regex_incl et regex_excl |
|||
| vfs.dir.size[] | ±è²¹°ù²¹³¾¨¨³Ù°ù±ð²õ regex_incl et regex_excl |
|||
| vfs.file.regexp[] | ±è²¹°ù²¹³¾¨¨³Ù°ù±ð regexp |
|||
| vfs.file.regmatch[] | ||||
| web.page.regexp[] | ||||
| Traps SNMP | ||||
| snmptrap[] | Oui | Oui | ±è²¹°ù²¹³¾¨¨³Ù°ù±ð regexp |
|
| Pr¨¦-traitement de la valeur d'un ¨¦l¨¦ment | Oui | Non | ±è²¹°ù²¹³¾¨¨³Ù°ù±ð pattern |
|
| Fonction d¨¦clencheur | ||||
| count() | Oui | Oui | ±è²¹°ù²¹³¾¨¨³Ù°ù±ð pattern si ±è²¹°ù²¹³¾¨¨³Ù°ù±ð operator est regexp ou iregexp |
|
| logeventid() | ±è²¹°ù²¹³¾¨¨³Ù°ù±ð pattern |
|||
| logsource() | ||||
| iregexp() | ||||
| regexp() | ||||
| D¨¦couverte de bas niveau | Oui | Oui | champs Filtre | |
| Supervision Web | Oui | Non | Variables avec un pr¨¦fix regex: champs Cha?ne requise |
|
| Fonctions de macro | ||||
| regsub() | Oui | Non | ±è²¹°ù²¹³¾¨¨³Ù°ù±ð pattern |
|
| iregsub() | ||||
| Correspondance d'ic?nes | Oui | Oui | champs Expression | |