6 Marķēšana

Pārskats

Birkas sastāv no birkas nosaukuma un birkas vērtības. Marķējot entītijas, var izmantot tikai nosaukumu vai arī savienot to pārī ar vērtību (piemēram, mysql, jira, target:mysql, service:jira u.c.).

Birkas var definēt dažādām entītijām:

  • Veidnes
  • Hosti
  • Vienumi
  • Tīmekļa scenāriji
  • Trigeri
  • Pakalpojumi
  • Veidņu vienumi un trigeri
  • Hostu, vienumu un trigeru prototipi

Veidņu, Hostu, Vienumu, Trigeru, Tīmekļa scenāriju sarakstos un to prototipos kolonnā Birkas tiek parādītas gan parastās, gan mantotās birkas. Novietojot kursoru virs mantotas birkas vai noklikšķinot uz tās, tiek parādīts JavaScript uznirstošais paskaidrojums ar tekstu "Mantotā birka". Ja mantotā birka pastāv arī kā parastā birka, tiek rādīts cits paskaidrojuma teksts atkarībā no saraksta, kurā tā parādās (piemēram, "Mantotā un veidnes birka" veidņu sarakstā vai "Mantotā un hosta birka" hostu sarakstā). Citās lietotāja saskarnes vietās parastās un mantotās birkas tiek rādītas kopā (dublikāti tiek noņemti), bez ikonām un bez papildu paskaidrojuma teksta.

Skatiet oficiālās Zabbix vadlīnijas par vispārīgiem ieteikumiem birku definēšanai, kā arī konkrētas norādes par veidnēm, vienumiem, trigeriem un zemā līmeņa atklāšanas noteikumiem.

Birkām ir vairāki mērķi, jo īpaši notikumu marķēšana. Ja entītijas ir marķētas ar birkām, jebkurš jauns notikums, kas saistīts ar marķētu entītiju, mantos tās birkas. Piemēram:

  • ar marķētām veidnēm — jebkura hosta problēma (ko izveidojuši trigeri no veidnes) mantos veidnes birkas.
  • ar marķētiem hostiem — jebkura hosta problēma mantos hosta birkas.
  • ar marķētiem vienumiem/tīmekļa scenārijiem — jebkura vienuma/tīmekļa scenārija problēma mantos vienuma/tīmekļa scenārija birkas.
  • ar marķētiem trigeriem — jebkura problēma, ko izveidojis trigeris, mantos trigeru birkas.

Problēmas notikums manto visas birkas no visas entītiju ķēdes — veidnēm, hostiem, vienumiem/tīmekļa scenārijiem, trigeriem. Identiskas tag:value kombinācijas (pēc makrosu atrisināšanas) tiek apvienotas vienā, tādējādi novēršot dublēšanos.

Atkopšanas notikumi, kas ģenerēti ar manuālu aizvēršanu, ietver arī atrisinātās notikuma birkas, kas mantotas no veidnēm, hostiem, vienumiem/tīmekļa scenārijiem un trigeriem. Šīs birkas ir pieejamas paziņojumos un ar makrosiem, piemēram, {EVENT.RECOVERY.TAGS} un {EVENT.RECOVERY.TAGSJSON}.

Pielāgotās notikumu birkas nodrošina lielāku elastību. Piemēram:

  • notikumu korelāciju var konfigurēt, pamatojoties uz notikumu birkām.
  • darbību nosacījumus var konfigurēt, pamatojoties uz notikumu birkām.
  • vienumu problēmas var grupēt, pamatojoties uz notikumu birkām.
  • problēmu birkas var izmantot, lai piesaistītu problēmas pakalpojumiem.

Entītijas var marķēt ar vienādu birkas nosaukumu, bet atšķirīgām birkas vērtībām (piemēram, component:memory un component:storage). Līdzīgi entītijai var būt birka bez vērtības un tā pati birka ar vērtību (piemēram, database un database:postgresql). Šādas birkas netiek uzskatītas par dublikātiem.

Lietošanas gadījumi

Daži biežāk sastopami tagu izmantošanas gadījumi ir šādi:

  1. Atzīmēt trigeru notikumus:

    • Definējiet trigera tagu (piemēram, scope:performance).
    • Problēmām, ko izveidos šis trigeris, būs trigera tags.

  2. Atzīmēt no veidnes mantotās problēmas:

    • Definējiet veidnes tagu (piemēram, target:mysql).
    • Problēmām, ko izveidos trigeri no šīs veidnes, būs veidnes tags.

  3. Atzīmēt hosta problēmas:

    • Definējiet hosta tagu (piemēram, service:jira).
    • Problēmām, ko izveidos trigeri no šī hosta, būs hosta tags.

  4. Filtrēt saistītos vienumus:

    • Definējiet vienuma tagu (piemēram, component:cpu).
    • Sadaļā Monitoring > Latest data vienumus var filtrēt pēc taga component:cpu.

  5. Izmantot no vienuma vērtības iegūtu informāciju kā taga vērtību:

    • Definējiet tagu ar makro kā taga vērtību (piemēram, tag-name:{{ITEM.VALUE<N>}.regsub()} ).
    • Sadaļā Monitoring > Problems problēmām taga vērtība tiks aizstāta ar datiem, kas iegūti no vienuma vērtības.

  6. Identificēt problēmas žurnālfailā un aizvērt tās atsevišķi:

    • Definējiet trigera tagu žurnāla monitoringa vienuma trigerim, kas, izmantojot makro, no vienuma vērtības iegūs vērtības (piemēram, service:{{ITEM.VALUE<N>}.regsub()} ).
    • Trigera konfigurācijā iestatiet notikumu korelāciju:
      • iestatiet PROBLEM event generation mode uz "Multiple";
      • iestatiet OK event closes uz "All problems if tag values match";
      • iestatiet atbilstības tagu.
    • Problēmām, ko izveidos žurnāla vienuma trigeris, būs trigera tags, un tās tiks aizvērtas atsevišķi.

  7. Filtrēt paziņojumus:

    • Definējiet trigera tagus (piemēram, scope:security trigera1 un scope:availability trigera2).
    • Izmantojiet tagu filtrēšanu darbību nosacījumos, lai saņemtu paziņojumus tikai par notikumiem, kas atbilst tagu datiem.

  8. Identificēt problēmas paziņojumos:

    • Definējiet trigera tagus.
    • Paziņojumā par problēmu izmantojiet makro {EVENT.TAGS}.
    • Paziņojums par problēmu saturēs trigera tagus, kas atvieglos noteikt, kurai lietotnei/pakalpojumam paziņojums pieder.

  9. Vienkāršot konfigurācijas uzdevumus, izmantojot veidnes tagus:

    • Definējiet veidnes trigera tagu.
    • Trigeriem, kas izveidoti no šī veidnes trigera, būs tā tags.

  10. Izveidot trigerus ar tagiem no zemā līmeņa atklāšanas (LLD):

    • Definējiet trigera prototipa tagu ar LLD makro taga nosaukumā vai vērtībā (piemēram, scope:{#FSNAME}).
    • Trigeriem, kas izveidoti no trigera prototipa, būs tā tags.

  11. Saskaņot pakalpojumus, izmantojot pakalpojumu tagus:

  12. Saistīt pakalpojumus ar problēmām, izmantojot pakalpojumu problēmu tagus:

    • Definējiet problēmas tagu pakalpojuma konfigurācijā (piemēram, target:mysql).
    • Problēmas ar atbilstošu tagu tiks automātiski korelētas ar pakalpojumu, un pakalpojuma statuss mainīsies atbilstoši konfigurētajiem pakalpojuma statusa aprēķina noteikumiem.

  13. Slāpēt problēmas, kad hosts ir uzturēšanas režīmā:

  14. Piešķirt piekļuvi lietotāju grupām:

Konfigurācija

Tagus var definēt īpašā cilnē, piemēram, trigera konfigurācijā:

Makrosu atbalsts

Built-in un lietotāja makrosi tagos tiek atrisināti notikuma brīdī. Līdz notikuma iestāšanās brīdim šie makrosi Zabbix lietotāja saskarnē tiks rādīti neatrisināti.

Zema līmeņa atklāšanas makrosi tiek atrisināti atklāšanas procesa laikā.

Tālāk norādītos makrosus var izmantot trigeru tagu nosaukumos un vērtībās:

  • {ITEM.VALUE}, {ITEM.VALUE.AGE}, {ITEM.VALUE.DATE}, {ITEM.VALUE.TIME}, {ITEM.VALUE.TIMESTAMP}, {ITEM.LASTVALUE}, {ITEM.LASTVALUE.AGE}, {ITEM.LASTVALUE.DATE}, {ITEM.LASTVALUE.TIME}, {ITEM.LASTVALUE.TIMESTAMP}, {HOST.HOST}, {HOST.NAME}, {HOST.CONN}, {HOST.DNS}, {HOST.IP}, {HOST.PORT}, un {HOST.ID} iebūvētie makrosi
  • {INVENTORY.*} iebūvētie makrosi (lai atsauktos uz hosta inventāra vērtībām no viena vai vairākiem hostiem trigera izteiksmē)
  • Lietotāja makrosi un lietotāja makrosi ar kontekstu (konteksts var ietvert zema līmeņa atklāšanas makrosus)
  • Zema līmeņa atklāšanas makrosi (tikai trigera prototipa tagos)

Tālāk norādītos makrosus var izmantot veidnes, hosta un vienuma/tīmekļa scenārija tagu nosaukumos un vērtībās:

  • {HOST.HOST}, {HOST.NAME}, {HOST.CONN}, {HOST.DNS}, {HOST.IP}, {HOST.PORT} un {HOST.ID} iebūvētie makrosi
  • {INVENTORY.*} iebūvētie makrosi
  • Lietotāja makrosi
  • Zema līmeņa atklāšanas makrosi (tikai hosta un vienuma prototipu tagos)

Tālāk norādītos makrosus var izmantot uz trigeriem balstītos paziņojumos:

  • {EVENT.TAGS} un {EVENT.RECOVERY.TAGS} iebūvētie makrosi (šie makrosi tiks atrisināti kā ar komatiem atdalīts notikuma tagu vai atkopšanas notikuma tagu saraksts)
  • {EVENT.TAGSJSON} un {EVENT.RECOVERY.TAGSJSON} iebūvētie makrosi (šie makrosi tiks atrisināti kā JSON masīvs, kas satur notikuma taga objektus vai atkopšanas notikuma taga objektus)
Apakšvirknes izvilkšana trigeru tagos

Apakšvirknes izvilkšana tiek atbalstīta, lai aizpildītu taga nosaukumu vai taga vērtību, izmantojot makro funkciju. Funkcija piemēro regulāro izteiksmi vērtībai, kas iegūta no atbalstītā makro. Piemēram:

{{ITEM.VALUE}.regsub(pattern, output)}
{{ITEM.VALUE}.iregsub(pattern, output)}

{{#LLDMACRO}.regsub(pattern, output)}
{{#LLDMACRO}.iregsub(pattern, output)}

Ja taga nosaukums vai vērtība pēc makro atrisināšanas pārsniedz 255 rakstzīmes, tā tiks saīsināta līdz 255 rakstzīmēm.

Skatiet arī: Makro funkciju izmantošana zema līmeņa atklāšanas makros notikumu tagošanai.

Notikumu birku skatīšana

Birku, ja tās ir definētas, var skatīt kopā ar jauniem notikumiem šeit:

Parādīto birku secību un skaitu nosaka filtrēšanas opcijas Tag display priority un Show tags sadaļā Monitoring > Problems vai paneļa Problems logrīkā. Ņemiet vērā, ka var parādīt ne vairāk kā trīs birkas; ja birku ir vairāk, novietojot kursoru virs trim punktiem, visas birkas tiek parādītas uznirstošajā logā.