Na tej stronie

Obiekt span APM

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

Każda właściwość odpowiada kolumnie w tabeli otel_traces źródła danych telemetrycznych. Listę kolumn można znaleźć w sekcji Obsługiwane kolumny danych telemetrycznych.

Span APM

Obiekt span APM reprezentuje span (pojedynczą operację w ramach śladu, taką jak żądanie HTTP, zapytanie do bazy danych lub wywołanie funkcji).

Spany tworzą hierarchię rozpoczynającą się od spanu głównego, który reprezentuje pierwszą operację żądania. Każdy inny span jest spanem podrzędnym spanu, podczas którego rozpoczęto jego operację.

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

Właściwość Typ Opis
timestamp integer Czas uniksowy (w nanosekundach), w którym rozpoczął się span.

Zachowanie właściwości:
- tylko do odczytu
traceid string Identyfikator śladu, do którego należy span.

Zachowanie właściwości:
- tylko do odczytu
spanid string Identyfikator spanu.

Zachowanie właściwości:
- tylko do odczytu
parent_spanid string Identyfikator spanu nadrzędnego.
Pusty dla spanu głównego.

Zachowanie właściwości:
- tylko do odczytu
trace_state string Dodatkowe dane, jeśli istnieją, dołączane do śladu przez narzędzia śledzenia (zobacz W3C Trace Context).

Zachowanie właściwości:
- tylko do odczytu
span_name string Nazwa operacji reprezentowanej przez span (np. mysqli_query).

Zachowanie właściwości:
- tylko do odczytu
span_kind string Rola spanu.

Możliwe wartości:
Unspecified - rodzaj spanu nie został określony;
Internal - operacja wykonana w aplikacji;
Server - obsługa przychodzącego żądania;
Client - żądanie wychodzące;
Producer - utworzenie operacji asynchronicznej (np. wysłanie wiadomości);
Consumer - przetwarzanie operacji asynchronicznej.

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

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

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

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

Zachowanie właściwości:
- tylko do odczytu
span_attributes object Atrybuty spanu w postaci klucz-wartość (np. db.system: mysql).

Zachowanie właściwości:
- tylko do odczytu
duration integer Czas trwania spanu w nanosekundach.

Zachowanie właściwości:
- tylko do odczytu
status_code string Stan operacji reprezentowanej przez span.

Możliwe wartości:
Unset - spanowi nie przypisano jawnego stanu;
Ok - operacja została ukończona pomyślnie;
Error - operacja została ukończona z błędem.

Zachowanie właściwości:
- tylko do odczytu
status_message string Dodatkowe informacje, jeśli istnieją, dotyczące stanu spanu.

Zachowanie właściwości:
- tylko do odczytu
events array Tablica obiektów zdarzeń spanu, czyli istotnych momentów podczas operacji (np. wyjątków).

Zachowanie właściwości:
- tylko do odczytu
links array Tablica obiektów łączy spanu wskazujących powiązane spany w tym samym lub innym śladzie.

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