Telemetrijas vaicājums

Šis vienuma tips ļauj izgūt vai apkopot telemetrijas datus. Telemetrijas dati tiek izmantoti lietojumprogrammu veiktspējas uzraudzībai (APM), kas palīdz noskaidrot, kā pieprasījumi plūst caur jūsu lietojumprogrammām un pakalpojumiem, izmērīt to veiktspēju un atrast lēnu vai neveiksmīgu darbību cēloni.

Telemetrijas dati ir trīs veidu: trasējumi (ceļš, ko pieprasījums veic caur jūsu lietojumprogrammām un pakalpojumiem), metrikas (mērījumi, piemēram, atbildes laiks) un žurnāli (notikumu teksta ieraksti). Izmantojot telemetrijas vaicājuma vienumu, varat, piemēram, atrast visus trasējumus, kuros pakalpojums atgrieza kļūdu, iegūt vidējo atbildes laiku no metrikām vai meklēt žurnālos konkrētu kļūdas ziņojumu.

Konfigurējot telemetrijas vaicājuma vienumu, jūs definējat instrukciju kopu (vaicājumu), kas norāda Zabbix, kādus telemetrijas datus pieprasīt, kā tos filtrēt un kā apkopot. Kad tiek izpildīta vienuma pārbaude, Zabbix nosūta šo vaicājumu telemetrijas datu avotam un izgūst rezultātu, pamatojoties uz vaicājumu.

Lai izmantotu šo vienumu, norādiet telemetrijas datu avotu un iestatiet parametru StartTelemetryQueryPollers Zabbix servera vai Zabbix starpniekservera konfigurācijā atkarībā no tā, kurš no tiem uzrauga vienuma hostu.

Konfigurācija

Izveidojot vienumu, iestatiet tā tipu uz Telemetry query:

Parametrs Apraksts
Name Skatiet parametrus, kas ir kopīgi visiem vienumiem.
Type Atlasiet Telemetry query.
Key Skatiet parametrus, kas ir kopīgi visiem vienumiem.
Type of information
Category Atlasiet signāla tipu, par kuru vēlaties veikt vaicājumu: Traces, Metrics vai Logs.
Metric points Atlasiet mērījuma punkta tipu, par kuru vēlaties veikt vaicājumu: Sum, Gauge, Histogram vai Exponential histogram.

Šis parametrs ir pieejams, ja Category ir iestatīts uz Metrics.
Columns Pievienojiet telemetrijas datu kolonnas, par kurām vēlaties veikt vaicājumu. Kolonnām, kurās tiek glabāti atslēgu un vērtību pāri, ievadiet arī atslēgas nosaukumu. Šo kolonnu ieraksti tiks iekļauti vienuma vērtībā bez izmaiņām.
Aggregated columns Pievienojiet telemetrijas datu kolonnas, par kurām vēlaties veikt vaicājumu, un norādiet, kā aprēķināt vērtību no to ierakstiem:
Function - atlasiet funkciju, kas jāpiemēro kolonnas ierakstiem: min, max, avg, count, sum vai percentile.
Percentage - ievadiet procentili, kas jāaprēķina no kolonnas ierakstiem (ja Function ir iestatīts uz percentile).
Column - atlasiet kolonnu, no kuras jāveic aprēķins (ja Function nav iestatīts uz count).
Alias - ievadiet unikālu aprēķinātās vērtības nosaukumu, kas tiks izmantots tās identificēšanai vienuma vērtībā.
Type of calculation Atlasiet, kā novērtēt nosacījumus, kas iestatīti tālāk norādītajā parametrā Conditions:
And/Or - jāizpilda visi nosacījumi; nosacījumi ar vienādu Type un Attribute key tiek apvienoti ar Or.
And - jāizpilda visi nosacījumi.
Or - jāizpilda vismaz viens nosacījums.
Custom expression - nosacījumi jāizpilda atbilstoši formulā norādītajam, piemēram, A and (B or C).

Šis parametrs ir pieejams, ja esat iestatījis divus vai vairākus nosacījumus.
Conditions Pievienojiet nosacījumus telemetrijas datu kolonnu ierakstu filtrēšanai:
Type - atlasiet telemetrijas datu kolonnu, kurai tiks piemērots nosacījums.
Attribute key - ievadiet atslēgu, kurai tiks piemērots nosacījums (ja Type ir iestatīts uz kolonnu ar atslēgu un vērtību pāriem).
Operator - atlasiet salīdzināšanas veidu (skatiet tālāk), kas tiks izmantots starp ieraksta vērtību un Attribute value.
Attribute value - ievadiet vērtību, ar kuru jāsalīdzina ieraksta vērtība (ja Operator nav iestatīts uz Exists).

Ja Type ir iestatīts uz kolonnu ar vienu vērtību, nosacījums tiks piemērots kolonnas ierakstam; ja kolonnā tiek glabāts vērtību masīvs, nosacījums atbildīs ierakstam, ja vismaz viena masīva vērtība atbildīs nosacījumam.

Ja Type ir iestatīts uz kolonnu, kurā tiek glabāti atslēgu un vērtību pāri, nosacījums tiks piemērots atslēgas vērtībai, kas norādīta laukā Attribute key; ja kolonnā tiek glabāts atslēgu un vērtību pāru masīvs, nosacījums atbildīs ierakstam, ja vismaz viens pāris ar norādīto Attribute key atbildīs nosacījumam.

Kolonnām ar vienu vērtību varat izmantot šādus operatorus:
Equals - atlasa ierakstus, kas ir vienādi ar Attribute value (reģistrjutīgi).
Does not equal - atlasa ierakstus, kas nav vienādi ar Attribute value (reģistrjutīgi).
Contains - atlasa ierakstus, kas satur Attribute value (reģistrjutīgi).
Does not contain - atlasa ierakstus, kas nesatur Attribute value (reģistrjutīgi).

Kolonnām, kurās tiek glabāti atslēgu un vērtību pāri, varat izmantot šādus operatorus:
Equals - atlasa ierakstus, kuros Attribute key pastāv un tā vērtība ir vienāda ar Attribute value (reģistrjutīgi).
Does not equal - atlasa ierakstus, kuros Attribute key pastāv un tā vērtība nav vienāda ar Attribute value (reģistrjutīgi).
Exists - atlasa ierakstus, kuros Attribute key pastāv (reģistrjutīgi).
Units Skatiet parametrus, kas ir kopīgi visiem vienumiem.
Update interval
Custom intervals
Time shift Ievadiet minimālo laiku starp vaicājuma laika diapazona beigām un pašreizējo laiku.

Atbalsta sekunžu skaitu (piemēram, 1, 60, 300), vērtību ar laika sufiksu (piemēram, 30s, 1m, 2h, 1d) vai lietotāja makro.
Lookback limit Ievadiet, cik tālu atpakaļ (pirms vaicājuma laika diapazona beigām) jāsāk vaicājuma laika diapazons, ja:
- nav iepriekšēja vaicājuma, no kura turpināt (piemēram, vienuma pirmās izpildes laikā);
- turpinot iepriekšējo vaicājumu, vaicājuma laika diapazons būtu garāks par Lookback limit (piemēram, tāpēc, ka Zabbix serveris nedarbojās).

Atbalsta sekunžu skaitu (piemēram, 1, 60, 300), vērtību ar laika sufiksu (piemēram, 30s, 1m, 2h, 1d) vai lietotāja makro.

Ja šī vienuma hosts tiek uzraudzīts ar citu entītiju (piemēram, citu starpniekserveri no starpniekserveru grupas), vienums var vairs nezināt, kad beidzās iepriekšējais vaicājums. Tas var izraisīt dublētas vērtības.
Granularity Ievadiet segmenta ilgumu, kurā tiek sadalīts vaicājuma laika diapazons.

Atbalsta sekunžu skaitu (piemēram, 1, 60, 300), vērtību ar laika sufiksu (piemēram, 30s, 1m, 2h, 1d) vai lietotāja makro.

Vērtība nedrīkst būt lielāka par Lookback limit.
Timeout Skatiet parametrus, kas ir kopīgi visiem vienumiem.
History
Trends
Value mapping
Populates host inventory field
Description
Enabled

Vaicājuma laika diapazons

Kad tiek izpildīta telemetrijas vaicājuma vienuma pārbaude, vienums vaicā datus noteiktā laika diapazonā:

  • Vaicājuma laika diapazons parasti sākas tur, kur beidzās iepriekšējā vaicājuma laika diapazons (ar izņēmumiem, skatiet tālāk sniegtos piemērus).
  • Vaicājuma laika diapazons beidzas ne vēlāk kā Time shift pirms pašreizējā laika.
  • Vaicājuma laika diapazons tiek sadalīts Granularity garos segmentos (tas ietver tikai pilnus segmentus; atlikušais laiks tiek vaicāts pēc tam).

Atkarībā no parametru vērtībām secīgu vienuma pārbaužu vaicājumu laika diapazoni var sekot cits citam (slīdošā loga agregācija), pārklāties (pārklājošā agregācija) vai atstāt atstarpes (pārklājošā agregācija ar atstarpēm). Tālāk sniegtajos piemēros pieņemts, ka vienuma pārbaudes tiek izpildītas laikā, ik pēc Update interval. Aizkavētas vai manuāli izpildītas pārbaudes var radīt atstarpes vai pārklāšanos.

Slīdošā loga agregācija notiek, ja Update interval nav īsāks par Granularity un nav garāks par Lookback limit. Piemēram, ja Update interval ir iestatīts uz 1m, Time shift uz 15s, Lookback limit uz 10m un Granularity uz 15s, katrs vaicājuma laika diapazons ir 1 minūti garš un tiek sadalīts četros 15 sekunžu segmentos:

                                                   Time shift (15s)        Time shift (15s)
      11:58:00                11:59:00             |  12:00:00 (Check 1)   |  12:01:00 (Check 2)
      ↓                       ↓                    ↓  ↓                    ↓  ↓
| 15s | 15s | 15s | 15s | 15s | 15s | 15s | 15s | 15s | 15s | 15s | 15s | 15s | 15s |
                        |<------ Range 1 ------>|<------ Range 2 ------>|

Pārklājošā agregācija notiek, ja Granularity ir garāks par Update interval. Piemēram, ja Update interval ir iestatīts uz 1m, Time shift uz 15s, Lookback limit uz 10m un Granularity uz 2m, katrs vaicājuma laika diapazons ir 2 minūtes garš (viens segments) un pārklājas ar iepriekšējo par 1 minūti:

                                                   Time shift (15s)        Time shift (15s)
      11:58:00                11:59:00             |  12:00:00 (Check 1)   |  12:01:00 (Check 2)
      ↓                       ↓                    ↓  ↓                    ↓  ↓
| 15s | 15s | 15s | 15s | 15s | 15s | 15s | 15s | 15s | 15s | 15s | 15s | 15s | 15s |
|<------------------ Range 1 ------------------>|                       |
                        |<------------------ Range 2 ------------------>|

Pārklājošā agregācija ar atstarpēm notiek, ja Update interval ir garāks par Lookback limit. Piemēram, ja Update interval ir iestatīts uz 1m, Time shift uz 15s, Lookback limit uz 45s un Granularity uz 15s, katrs vaicājuma laika diapazons ir 45 sekundes garš (trīs segmenti) un pēc iepriekšējā atstāj 15 sekunžu atstarpi:

                                                   Time shift (15s)        Time shift (15s)
      11:58:00                11:59:00             |  12:00:00 (Check 1)   |  12:01:00 (Check 2)
      ↓                       ↓                    ↓  ↓                    ↓  ↓
| 15s | 15s | 15s | 15s | 15s | 15s | 15s | 15s | 15s | 15s | 15s | 15s | 15s | 15s |
                              |<--- Range 1 --->|     |<--- Range 2 --->|

Konfigurējot vaicājuma laika diapazonu, ņemiet vērā tālāk norādīto:

  • Vairumā gadījumu iestatiet Update interval, Lookback limit un Granularity uz vienādu vērtību (piemēram, 1m). Vienāds Lookback limit un Granularity nodrošina, ka katrā pārbaudē tiek vaicāts viens segments, savukārt vienāds Update interval nodrošina, ka secīgie vaicājumu laika diapazoni seko cits citam bez pārklāšanās vai atstarpēm.
  • Iestatiet Time shift, lai tas aptvertu aizkavi pirms telemetrijas datu ierakstīšanas datu avotā. Pretējā gadījumā vienums var vaicāt laika diapazonu, pirms tajā ir ierakstīti visi tā dati, un trūkstošie dati var netikt vaicāti atkārtoti.
  • Iestatiet Lookback limit garāku par Update interval tikai tad, ja vienumam ir jāvaicā dati, kurus tas nav saņēmis (piemēram, kamēr Zabbix serveris nedarbojās). Garāks Lookback limit var samazināt veiktspēju, kad vienums to izmanto, īpaši tad, ja telemetrijas datu avotā ir liels datu apjoms (piemēram, vairāk nekā miljons ierakstu stundā).

Atbalstītās telemetrijas datu kolonnas

Šajā sadaļā ir uzskaitītas kolonnas, kas tiek atbalstītas šādos vienuma parametros: Columns, Aggregated columns un Conditions. Tās ir kolonnas, ko ClickHouse izmanto telemetrijas datu glabāšanai saskaņā ar OpenTelemetry ClickHouse eksportētāja shēmu.

Atlasiet Category:

Izsekojumi

Kolonna Kolonnas Apkopotās kolonnas Nosacījumi
Ilgums ✓ ✓ –
Events.Attributes – – ✓
Events.Name – – ✓
ParentSpanId ✓ – ✓
ResourceAttributes ✓ – ✓
ScopeName ✓ – ✓
ScopeVersion ✓ – ✓
ServiceName ✓ – ✓
SpanAttributes ✓ – ✓
SpanId ✓ – ✓
SpanKind ✓ – ✓
SpanName ✓ – ✓
StatusCode ✓ – ✓
StatusMessage ✓ – ✓
Laikspiedogs ✓ ✓ –
TraceId ✓ – ✓
TraceState ✓ – ✓

Metrikas: summa

Kolonna Kolonnas Apkopotās kolonnas Nosacījumi
AggregationTemporality ✓ – –
Attributes ✓ – ✓
Exemplars.FilteredAttributes – – ✓
Flags ✓ – –
IsMonotonic ✓ – –
MetricDescription ✓ – ✓
MetricName ✓ – ✓
MetricUnit ✓ – ✓
ResourceAttributes ✓ – ✓
ResourceSchemaUrl ✓ – ✓
ScopeAttributes ✓ – ✓
ScopeDroppedAttrCount ✓ ✓ –
ScopeName ✓ – ✓
ScopeSchemaUrl ✓ – ✓
ScopeVersion ✓ – ✓
ServiceName ✓ – ✓
StartTimeUnix ✓ ✓ –
TimeUnix ✓ ✓ –
Value ✓ ✓ –

Metrikas: mērinstruments

Kolonna Kolonnas Apkopotās kolonnas Nosacījumi
Atribūti ✓ – ✓
Exemplars.FilteredAttributes – – ✓
Karodziņi ✓ – –
MetricDescription ✓ – ✓
MetricName ✓ – ✓
MetricUnit ✓ – ✓
ResourceAttributes ✓ – ✓
ResourceSchemaUrl ✓ – ✓
ScopeAttributes ✓ – ✓
ScopeDroppedAttrCount ✓ ✓ –
ScopeName ✓ – ✓
ScopeSchemaUrl ✓ – ✓
ScopeVersion ✓ – ✓
ServiceName ✓ – ✓
StartTimeUnix ✓ ✓ –
TimeUnix ✓ ✓ –
Value ✓ ✓ –

Metrikas: histogramma

Kolonna Kolonnas Apkopotās kolonnas Nosacījumi
AggregationTemporality ✓ – –
Attributes ✓ – ✓
Count ✓ ✓ –
Exemplars.FilteredAttributes – – ✓
Flags ✓ – –
Max ✓ ✓ –
MetricDescription ✓ – ✓
MetricName ✓ – ✓
MetricUnit ✓ – ✓
Min ✓ ✓ –
ResourceAttributes ✓ – ✓
ResourceSchemaUrl ✓ – ✓
ScopeAttributes ✓ – ✓
ScopeDroppedAttrCount ✓ ✓ –
ScopeName ✓ – ✓
ScopeSchemaUrl ✓ – ✓
ScopeVersion ✓ – ✓
ServiceName ✓ – ✓
StartTimeUnix ✓ ✓ –
Sum ✓ ✓ –
TimeUnix ✓ ✓ –

Metrikas: eksponenciālā histogramma

Kolonna Kolonnas Apkopotās kolonnas Nosacījumi
AggregationTemporality ✓ – –
Attributes ✓ – ✓
Count ✓ ✓ –
Exemplars.FilteredAttributes – – ✓
Flags ✓ – –
Max ✓ ✓ –
MetricDescription ✓ – ✓
MetricName ✓ – ✓
MetricUnit ✓ – ✓
Min ✓ ✓ –
NegativeOffset ✓ ✓ –
PositiveOffset ✓ ✓ –
ResourceAttributes ✓ – ✓
ResourceSchemaUrl ✓ – ✓
Scale ✓ ✓ –
ScopeAttributes ✓ – ✓
ScopeDroppedAttrCount ✓ ✓ –
ScopeName ✓ – ✓
ScopeSchemaUrl ✓ – ✓
ScopeVersion ✓ – ✓
ServiceName ✓ – ✓
StartTimeUnix ✓ ✓ –
Sum ✓ ✓ –
TimeUnix ✓ ✓ –
ZeroCount ✓ ✓ –

Žurnāli

Kolonna Kolonnas Apkopotās kolonnas Nosacījumi
Body ✓ – ✓
EventName ✓ – ✓
LogAttributes ✓ – ✓
ResourceAttributes ✓ – ✓
ResourceSchemaUrl ✓ – ✓
ScopeAttributes ✓ – ✓
ScopeName ✓ – ✓
ScopeSchemaUrl ✓ – ✓
ScopeVersion ✓ – ✓
SpanId ✓ – ✓
ServiceName ✓ – ✓
SeverityNumber ✓ ✓ –
SeverityText ✓ – ✓
Timestamp ✓ ✓ –
TraceFlags ✓ – –
TraceId ✓ – ✓