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ži sastopami marķēšanas lietošanas gadījumi ir šādi:

  1. Atzīmēt trigeru notikumus:

    • Definējiet trigera birku (piemēram, scope:performance).
    • Problēmām, kas izveidotas ar šo trigeri, būs trigera birka.

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

    • Definējiet veidnes birku (piemēram, target:mysql).
    • Problēmām, kas izveidotas ar trigeriem no šīs veidnes, būs veidnes birka.

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

    • Definējiet hosta birku (piemēram, service:jira).
    • Problēmām, kas izveidotas ar trigeriem no šī hosta, būs hosta birka.

  4. Filtrēt saistītos vienumus:

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

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

    • Definējiet birku ar makrosu kā birkas vērtību (piemēram, tag-name:{{ITEM.VALUE<N>}.regsub()} ).
    • Sadaļā Monitoring > Problems problēmām birkas vērtība tiks atrisināta uz 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 birku žurnāla uzraudzības vienuma trigerim, kas izmantos makrosu, lai iegūtu vērtības no vienuma 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 birku atbilstības noteikšanai.
    • Problēmām, kas izveidotas ar žurnāla vienuma trigeri, būs trigera birka, un tās tiks aizvērtas individuāli.

  7. Filtrēt paziņojumus:

    • Definējiet trigeru birkas (piemēram, scope:security trigerim1 un scope:availability trigerim2).
    • Izmantojiet birku filtrēšanu darbību nosacījumos, lai saņemtu paziņojumus tikai par notikumiem, kas atbilst birku datiem.

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

    • Definējiet trigeru birkas.
    • Izmantojiet {EVENT.TAGS} makrosu problēmas paziņojumā.
    • Problēmas paziņojumā būs iekļautas trigeru birkas, tādējādi atvieglojot noteikšanu, kurai lietojumprogrammai/pakalpojumam paziņojums pieder.

  9. Vienkāršot konfigurācijas uzdevumus, izmantojot veidņu birkas:

    • Definējiet veidnes trigera birku.
    • Trigeriem, kas izveidoti no šī veidnes trigera, būs šī birka.

  10. Izveidot trigerus ar birkām no zema līmeņa atklāšanas (LLD):

    • Definējiet trigera prototipa birku ar LLD makrosu birkas nosaukumā vai vērtībā (piemēram, scope:{#FSNAME}).
    • Trigeriem, kas izveidoti no trigera prototipa, būs šī birka.

  11. Saskaņot pakalpojumus, izmantojot pakalpojumu birkas:

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

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

  13. Apspiest 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 makro 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ā.