Obiekt śladu APM
Poniższe obiekty są bezpośrednio powiązane z API apmtrace.
Każda właściwość, z wyjątkiem span_count i error_count, odpowiada kolumnie w tabeli otel_traces źródła danych telemetrycznych.
Większość właściwości odpowiada kolumnie o tej samej nazwie (np. właściwość span_name odpowiada kolumnie SpanName).
Jeśli nazwy się różnią, kolumny źródła danych określono w poniższych tabelach.
Listę kolumn można znaleźć w sekcji Obsługiwane kolumny danych telemetrycznych.
Ślad APM
Obiekt śladu APM reprezentuje ślad (ścieżkę, którą żądanie przebywa przez aplikacje i usługi). Ślad składa się z co najmniej jednego zakresu; każdy zakres reprezentuje pojedynczą operację.
Obiekt śladu APM jest oparty na głównym zakresie śladu (zakresie, który rozpoczyna ślad i nie ma zakresu nadrzędnego).
Wszystkie właściwości zawierają dane głównego zakresu, z wyjątkiem span_count i error_count, które są obliczane na podstawie wszystkich zakresów śladu.
Obiekt śladu 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ę główny zakres. Zachowanie właściwości: - tylko do odczytu |
| traceid | string | Identyfikator śladu współdzielony przez wszystkie zakresy należące do śladu. Zachowanie właściwości: - tylko do odczytu |
| spanid | string | Identyfikator głównego zakresu. 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 główny zakres (np. POST /zabbix.php).Zachowanie właściwości: - tylko do odczytu |
| span_kind | string | Rola głównego zakresu. Możliwe wartości: Unspecified - rodzaj zakresu nie został określony;Internal - operacja wykonana wewnątrz 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 główny zakres (np. zabbix-nginx), pobrana z atrybutu zasobu OpenTelemetry service.name.Zachowanie właściwości: - tylko do odczytu |
| resource_attributes | object | Atrybuty zasobu klucz-wartość głównego zakresu (np. host.name: eabf8c2a5ddc).Zachowanie właściwości: - tylko do odczytu |
| scope_name | string | Nazwa zakresu instrumentacji, który utworzył główny zakres. 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 zakresu klucz-wartość głównego zakresu (np. http.method: POST).Zachowanie właściwości: - tylko do odczytu |
| duration | integer | Czas trwania śladu w nanosekundach. Zachowanie właściwości: - tylko do odczytu |
| status_code | string | Stan operacji reprezentowanej przez główny zakres. Możliwe wartości: Unset - głównemu zakresowi 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 głównego zakresu. Zachowanie właściwości: - tylko do odczytu |
| events | array | Tablica obiektów zdarzeń głównego zakresu, czyli istotnych momentów podczas operacji (np. wyjątków). Zachowanie właściwości: - tylko do odczytu |
| links | array | Tablica obiektów łączy głównego zakresu wskazujących powiązane zakresy w tym samym lub innym śladzie. Zachowanie właściwości: - tylko do odczytu |
| span_count | integer | Łączna liczba zakresów w śladzie. Zachowanie właściwości: - tylko do odczytu |
| error_count | integer | Liczba zakresów w śladzie, dla których status_code ma wartość Error.Zachowanie właściwości: - tylko do odczytu |
Zdarzenie
Obiekt zdarzenia ma następujące właściwości.
| Właściwość | Typ | Opis |
|---|---|---|
| timestamp | integer | Czas uniksowy (w nanosekundach), w którym wystąpiło zdarzenie. Kolumna źródła danych: Events.Timestamp |
| name | string | Nazwa zdarzenia. Kolumna źródła danych: Events.Name |
| attributes | object | Atrybuty klucz-wartość zawierające dodatkowe informacje o zdarzeniu, jeśli są dostępne. Kolumna źródła danych: Events.Attributes |
Link
Obiekt linku ma następujące właściwości.
| Property | Type | Description |
|---|---|---|
| traceid | string | ID śladu zawierającego połączony span. Kolumna źródła danych: Links.TraceId |
| spanid | string | ID połączonego spanu. Wraz z traceid jednoznacznie identyfikuje połączony span.Kolumna źródła danych: Links.SpanId |
| trace_state | string | Stan śladu, jeśli istnieje, połączonego spanu (zobacz W3C Trace Context). Kolumna źródła danych: Links.TraceState |
| attributes | object | Atrybuty klucz-wartość zawierające dodatkowe informacje o linku. Kolumna źródła danych: Links.Attributes |