Metryki

Przegląd

Sekcja APM > Metrics wyświetla punkty danych metryk zebrane z aplikacji i usług.

Metryka to pomiar (np. czas trwania żądania, liczba przetworzonych zamówień lub użycie pamięci). Aplikacje wysyłają swoje wartości jako punkty danych, które zawierają wartość (lub zagregowane wartości) zmierzoną w określonym czasie. Metryka jest podobna do pozycji Zabbix, a punkt danych jest podobny do wartości tej pozycji.

Punkt danych może być jednego z następujących typów:

  • Gauge - wartość zmierzona w określonym czasie (np. bieżące użycie pamięci).
  • Sum - suma pomiarów w określonym przedziale czasu (np. łączna liczba żądań).
  • Histogram - liczba pomiarów w określonym przedziale czasu, które mieszczą się w każdym z kilku ustalonych zakresów wartości, nazywanych kubełkami (np. ile żądań trwało 0-100 ms, 100-250 ms lub 250-500 ms).
  • Histogram wykładniczy - podobnie jak histogram, ale każdy kubełek jest szerszy od poprzedniego o ten sam współczynnik (np. 1-2 ms, 2-4 ms, 4-8 ms).

Każdy punkt danych jest tworzony przez usługę (np. zabbix-frontend; nazwa jest określana przez atrybut zasobu OpenTelemetry service.name) oraz przez zakres instrumentacji, czyli część kodu, która go utworzyła (np. biblioteka mierząca czas trwania żądań HTTP).

Aby zapewnić kontekst dla każdego pomiaru, punkty danych mają również atrybuty klucz-wartość: atrybuty punktu danych opisują, co zostało zmierzone, i rozróżniają punkty danych tej samej metryki (np. http.request.method: POST), natomiast atrybuty zasobu opisują usługę i środowisko, w którym działa (np. host.name: eabf8c2a5ddc).

Więcej informacji na temat metryk można znaleźć w dokumentacji OpenTelemetry.

Sekcja APM > Metrics zawiera następujące elementy:

  • Przycisk trybu kiosku - wyświetla tylko zawartość strony, bez menu i nagłówka.
  • Selektor przedziału czasu - wybór przedziału czasu, dla którego mają być wyświetlane punkty danych.
  • Filtr - wyświetla tylko interesujące Cię punkty danych.
  • Lista metryk - wyświetlanie punktów danych.
  • Szczegóły metryki - wyświetlanie szczegółów wybranego punktu danych.

Lista metryk

Każdy wiersz na liście metryk reprezentuje punkt danych.

Punkty danych są wyświetlane w konfigurowalnej tabeli. Przycisk Dostosuj tabelę w nagłówku tabeli umożliwia wyświetlanie, ukrywanie lub zmianę kolejności kolumn oraz przywrócenie domyślnego układu. Można również zmienić szerokość każdej kolumny, przeciągając jej prawą krawędź; dwukrotne kliknięcie krawędzi przywraca domyślną szerokość. Wszystkie dostosowania są stosowane natychmiast i zapamiętywane dla bieżącego użytkownika.

Lista metryk może zawierać następujące kolumny:

Każda kolumna, 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; listę kolumn można znaleźć w sekcji Obsługiwane kolumny danych telemetrycznych. Większość kolumn ma taką samą nazwę jak w źródle danych (np. Metric name odpowiada kolumnie MetricName). Jeśli nazwy się różnią, nazwa kolumny źródła danych jest podana w poniższej tabeli.

Column Description
Metric name Metryka, do której należy punkt danych (np. http.server.duration).
Type Typ punktu danych: Gauge, Sum, Histogram lub Exponential histogram.
Określany na podstawie tabeli metryk zawierającej punkt danych.
Unit Jednostka, jeśli została określona, wartości metryki (np. s lub By; zobacz UCUM).
Kolumna źródła danych: MetricUnit.
Service name Usługa, która utworzyła punkt danych.
Scope name Zakres instrumentacji, który utworzył punkt danych.
Start time Data i czas rozpoczęcia okresu pomiarowego punktu danych.
Kolumna źródła danych: StartTimeUnix.
Sum/Value Suma wszystkich pomiarów (Histogram, Exponential histogram) lub wartość (Gauge, Sum) punktu danych.
Count Liczba pomiarów w punkcie danych typu Histogram lub Exponential histogram.
Time Data i czas punktu danych; w przypadku punktów danych typu Sum, Histogram i Exponential histogram koniec okresu pomiarowego.
Kolumna źródła danych: TimeUnix.
Flags Flagi punktu danych:
0 - nie ustawiono żadnych flag.
1 - dla punktu danych nie zarejestrowano żadnej wartości.
Aggregation temporality Sposób agregowania w czasie wartości punktu danych typu Sum, Histogram lub Exponential histogram:
Unspecified - nie określono.
Delta - agregowane w okresie od poprzedniego punktu danych.
Cumulative - agregowane w okresie od czasu rozpoczęcia.
Metric description Opis metryki, jeśli został określony.
Attributes Atrybuty punktu danych.
Kliknij przycisk z trzema kropkami , aby wyświetlić wszystkie atrybuty.
Resource attributes Atrybuty zasobu punktu danych.
Kliknij przycisk z trzema kropkami , aby wyświetlić wszystkie atrybuty.
Scope attributes Atrybuty zakresu instrumentacji.
Kliknij przycisk z trzema kropkami , aby wyświetlić wszystkie atrybuty.

Szczegóły metryki

Kliknij punkt danych na liście metryk, aby otworzyć panel szczegółów metryki, w którym wyświetlane są wszystkie informacje o punkcie danych.

Panel szczegółów metryki może zawierać następujące sekcje:

Sekcja Opis
Podstawowe informacje Nazwa metryki, typ, jednostka, nazwa usługi i czas rozpoczęcia.
Histogram Przedziały (np. > 5 - 10), z których każdy zawiera liczbę pomiarów w danym przedziale.
Wyświetlane tylko dla punktów danych typu Histogram.
Histogram wykładniczy Przedziały (np. >= 249.7885 - 249.7887), z których każdy zawiera liczbę pomiarów w danym przedziale.
Wyświetlane tylko dla punktów danych typu Histogram wykładniczy.
Informacje o metryce Wartości punktu danych, zależne od jego typu, a także opis metryki, czas, flagi i adres URL schematu zasobu.
Atrybuty Atrybuty punktu danych.
Atrybuty zasobu Atrybuty zasobu.
Atrybuty zakresu Atrybuty zakresu instrumentacji, jeśli istnieją.
Zakres Nazwa, wersja i adres URL schematu zakresu instrumentacji.

Korzystanie z filtra

Filtr umożliwia wyświetlanie tylko interesujących Cię punktów danych.

Aby filtrować według atrybutów, wprowadź klucz atrybutu, wybierz operator i wprowadź wartość atrybutu.

Obsługiwane są następujące operatory:

  • Zawiera - (domyślnie) wartość atrybutu zawiera wprowadzony ciąg znaków.
  • Równa się - wartość atrybutu jest równa wprowadzonemu ciągowi znaków.
  • Nie zawiera - wartość atrybutu nie zawiera wprowadzonego ciągu znaków.
  • Nie równa się - wartość atrybutu nie jest równa wprowadzonemu ciągowi znaków.
  • Istnieje - atrybut o wprowadzonym kluczu istnieje.
  • Nie istnieje - atrybut o wprowadzonym kluczu nie istnieje.

Jeśli dodasz kilka warunków, wybierz sposób ich oceny:

  • And/Or - (domyślnie) wszystkie warunki muszą być spełnione; warunki z tym samym kluczem atrybutu są łączone operatorem Or.
  • Or - musi być spełniony co najmniej jeden warunek.