Obiekt metryki APM

Poniższe obiekty są bezpośrednio powiązane z API apmmetric.

Każda właściwość, z wyjątkiem type, odpowiada kolumnie w tabelach metryk (otel_metrics_gauge, otel_metrics_sum, otel_metrics_histogram i otel_metrics_exponential_histogram) źródła danych telemetrycznych. Większość właściwości odpowiada kolumnie o tej samej nazwie (np. właściwość metric_name odpowiada kolumnie MetricName). Jeśli nazwy się różnią, kolumny źródła danych są określone w poniższych tabelach. Listę kolumn można znaleźć w sekcji Obsługiwane kolumny danych telemetrycznych.

Metryka APM

Obiekt metryki APM reprezentuje punkt danych metryki (wartość lub zagregowane wartości pomiaru w określonym czasie).

Obiekt metryki APM ma następujące właściwości:

Właściwość Typ Opis
type integer Typ punktu danych.

Możliwe wartości:
0 - Gauge;
1 - Sum;
2 - Histogram;
3 - Histogram wykładniczy.

Typ jest określany przez tabelę przechowującą punkt danych: otel_metrics_gauge, otel_metrics_sum, otel_metrics_histogram lub otel_metrics_exponential_histogram.

Zachowanie właściwości:
- tylko do odczytu
resource_attributes object Atrybuty zasobu punktu danych w postaci klucz-wartość (np. host.name: eabf8c2a5ddc).

Zachowanie właściwości:
- tylko do odczytu
resource_schema_url string Adres URL, jeśli istnieje, schematu zasobu OpenTelemetry dla atrybutów zasobu.

Zachowanie właściwości:
- tylko do odczytu
scope_name string Nazwa zakresu instrumentacji, który wygenerował punkt danych.

Zachowanie właściwości:
- tylko do odczytu
scope_version string Wersja zakresu instrumentacji, jeśli istnieje.

Zachowanie właściwości:
- tylko do odczytu
scope_attributes object Atrybuty zakresu instrumentacji w postaci klucz-wartość.

Zachowanie właściwości:
- tylko do odczytu
scope_schema_url string Adres URL, jeśli istnieje, schematu zakresu instrumentacji OpenTelemetry i jego atrybutów.

Zachowanie właściwości:
- tylko do odczytu
service_name string Nazwa usługi, która wygenerowała punkt danych (np. zabbix-frontend), pobrana z atrybutu zasobu OpenTelemetry service.name.

Zachowanie właściwości:
- tylko do odczytu
metric_name string Nazwa metryki, do której należy punkt danych (np. http.server.request.duration).

Zachowanie właściwości:
- tylko do odczytu
metric_description string Opis metryki, jeśli istnieje.

Zachowanie właściwości:
- tylko do odczytu
metric_unit string Jednostka wartości metryki, jeśli istnieje (np. s lub By; zobacz UCUM).

Zachowanie właściwości:
- tylko do odczytu
attributes object Atrybuty punktu danych w postaci klucz-wartość (np. http.request.method: POST).

Zachowanie właściwości:
- tylko do odczytu
start_time_unix integer Czas uniksowy (w nanosekundach), w którym rozpoczął się okres pomiaru punktu danych.

Zachowanie właściwości:
- tylko do odczytu
time_unix integer Czas uniksowy (w nanosekundach) punktu danych.
W przypadku punktów danych typu Sum, Histogram i Histogram wykładniczy jest to koniec okresu pomiaru.

Zachowanie właściwości:
- tylko do odczytu
value float Wartość punktu danych.
Dotyczy punktów danych typu Gauge i Sum.

Wartość domyślna: 0.

Zachowanie właściwości:
- tylko do odczytu
flags integer Maska bitowa flag punktu danych.
Jeśli ustawiony jest najmniej znaczący bit (wartość 1), dla punktu danych nie zarejestrowano żadnej wartości.

Zachowanie właściwości:
- tylko do odczytu
exemplars array Tablica obiektów exemplar, czyli pojedynczych pomiarów zachowanych jako przykłady wraz z identyfikatorem śladu i rozpiętością, podczas których zostały zarejestrowane.

Zachowanie właściwości:
- tylko do odczytu
aggregation_temporality integer Sposób agregowania wartości punktu danych w czasie.
Dotyczy punktów danych typu Sum, Histogram i Histogram wykładniczy.

Możliwe wartości:
0 - (domyślnie) Nieokreślony;
1 - Delta (agregowane w okresie od poprzedniego punktu danych);
2 - Skumulowane (agregowane w okresie od start_time_unix).

Zachowanie właściwości:
- tylko do odczytu
is_monotonic boolean Określa, czy suma może z czasem tylko rosnąć lub pozostać bez zmian.
Dotyczy punktów danych typu Sum.

Wartość domyślna: false.

Zachowanie właściwości:
- tylko do odczytu
count integer Liczba pomiarów w punkcie danych.
Dotyczy punktów danych typu Histogram i Histogram wykładniczy.

Wartość domyślna: 0.

Zachowanie właściwości:
- tylko do odczytu
sum float Suma wszystkich pomiarów w punkcie danych.
Dotyczy punktów danych typu Histogram i Histogram wykładniczy.

Wartość domyślna: 0.

Zachowanie właściwości:
- tylko do odczytu
bucket_counts array Tablica liczb całkowitych określających liczbę pomiarów w każdym przedziale histogramu.
Przedziały są definiowane przez explicit_bounds.
Dotyczy punktów danych typu Histogram.

Wartość domyślna: [].

Zachowanie właściwości:
- tylko do odczytu
explicit_bounds array Tablica liczb zmiennoprzecinkowych określających granice między przedziałami histogramu.
Dotyczy punktów danych typu Histogram.

Wartość domyślna: [].

Zachowanie właściwości:
- tylko do odczytu
min float Najmniejszy z pomiarów w punkcie danych.
Dotyczy punktów danych typu Histogram i Histogram wykładniczy.

Wartość domyślna: 0.

Zachowanie właściwości:
- tylko do odczytu
max float Największy z pomiarów w punkcie danych.
Dotyczy punktów danych typu Histogram i Histogram wykładniczy.

Wartość domyślna: 0.

Zachowanie właściwości:
- tylko do odczytu
scale integer Skala histogramu wykładniczego, która określa granice przedziałów i rozdzielczość.
Wyższa skala zapewnia węższe przedziały i większą rozdzielczość, natomiast niższa skala zapewnia szersze przedziały i mniejszą rozdzielczość.
Dotyczy punktów danych typu Histogram wykładniczy.

Wartość domyślna: 0.

Zachowanie właściwości:
- tylko do odczytu
zero_count integer Liczba pomiarów w zerowym przedziale histogramu wykładniczego.
Dotyczy punktów danych typu Histogram wykładniczy.

Wartość domyślna: 0.

Zachowanie właściwości:
- tylko do odczytu
positive_bucket_counts array Tablica liczb całkowitych określających liczbę dodatnich pomiarów w każdym przedziale histogramu wykładniczego.
Granice przedziałów są określane przez scale; indeks pierwszego przedziału jest ustawiany w positive_offset.
Dotyczy punktów danych typu Histogram wykładniczy.

Wartość domyślna: [].

Zachowanie właściwości:
- tylko do odczytu
positive_offset integer Indeks pierwszego przedziału w positive_bucket_counts.
Dotyczy punktów danych typu Histogram wykładniczy.

Wartość domyślna: 0.

Zachowanie właściwości:
- tylko do odczytu
negative_bucket_counts array Tablica liczb całkowitych określających liczbę ujemnych pomiarów w każdym przedziale histogramu wykładniczego.
Granice przedziałów są określane przez scale; indeks pierwszego przedziału jest ustawiany w negative_offset.
Dotyczy punktów danych typu Histogram wykładniczy.

Wartość domyślna: [].

Zachowanie właściwości:
- tylko do odczytu
negative_offset integer Indeks pierwszego przedziału w negative_bucket_counts.
Dotyczy punktów danych typu Histogram wykładniczy.

Wartość domyślna: 0.

Zachowanie właściwości:
- tylko do odczytu

Obiekt Exemplar

Obiekt exemplar ma następujące właściwości:

Property Type Description
traceid string Identyfikator (jeśli istnieje) śladu, podczas którego zarejestrowano pomiar.
Kolumna źródła danych: Exemplars.TraceId.
spanid string Identyfikator (jeśli istnieje) zakresu, podczas którego zarejestrowano pomiar.
Kolumna źródła danych: Exemplars.SpanId.
value float Wartość pomiaru.
Kolumna źródła danych: Exemplars.Value.
time_unix integer Czas uniksowy (w nanosekundach), w którym zarejestrowano pomiar.
Kolumna źródła danych: Exemplars.TimeUnix.
filtered_attributes object Atrybuty pomiaru w postaci klucz-wartość, które nie są uwzględnione w attributes punktu danych.
Kolumna źródła danych: Exemplars.FilteredAttributes.