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 | ✓ | – | ✓ |