На странице
Объект метрики APM
Следующие объекты напрямую связаны с API apmmetric.
Каждое свойство, кроме type, соответствует столбцу в таблицах метрик (otel_metrics_gauge, otel_metrics_sum, otel_metrics_histogram и otel_metrics_exponential_histogram) источника данных телеметрии.
Большинство свойств соответствуют столбцу с таким же именем (например, свойство metric_name соответствует столбцу MetricName).
Если имена отличаются, столбцы источника данных указаны в таблицах ниже.
Список столбцов см. в разделе Поддерживаемые столбцы данных телеметрии.
Метрика APM
Объект метрики APM представляет точку данных метрики (значение или агрегированные значения измерения в определенный момент времени).
Объект метрики APM имеет следующие свойства:
| Свойство | Тип | Описание |
|---|---|---|
| type | integer | Тип точки данных. Возможные значения: 0 - Gauge; 1 - Sum; 2 - Histogram; 3 - Exponential histogram. Тип определяется таблицей, в которой хранится точка данных: otel_metrics_gauge, otel_metrics_sum, otel_metrics_histogram или otel_metrics_exponential_histogram.Поведение свойства: - только для чтения |
| resource_attributes | object | Атрибуты ресурса точки данных в формате «ключ-значение» (например, host.name: eabf8c2a5ddc).Поведение свойства: - только для чтения |
| resource_schema_url | string | URL, если указан, схемы OpenTelemetry для атрибутов ресурса. Поведение свойства: - только для чтения |
| scope_name | string | Имя области инструментирования, создавшей точку данных. Поведение свойства: - только для чтения |
| scope_version | string | Версия области инструментирования, если указана. Поведение свойства: - только для чтения |
| scope_attributes | object | Атрибуты области инструментирования в формате «ключ-значение». Поведение свойства: - только для чтения |
| scope_schema_url | string | URL, если указан, схемы OpenTelemetry для области инструментирования и ее атрибутов. Поведение свойства: - только для чтения |
| service_name | string | Имя сервиса, создавшего точку данных (например, zabbix-frontend), полученное из атрибута ресурса OpenTelemetry service.name.Поведение свойства: - только для чтения |
| metric_name | string | Имя метрики, к которой относится точка данных (например, http.server.request.duration).Поведение свойства: - только для чтения |
| metric_description | string | Описание метрики, если указано. Поведение свойства: - только для чтения |
| metric_unit | string | Единица измерения значений метрики, если указана (например, s или By; см. UCUM).Поведение свойства: - только для чтения |
| attributes | object | Атрибуты точки данных в формате «ключ-значение» (например, http.request.method: POST).Поведение свойства: - только для чтения |
| start_time_unix | integer | Время Unix (в наносекундах), когда начался период измерения точки данных. Поведение свойства: - только для чтения |
| time_unix | integer | Время Unix (в наносекундах) точки данных. Для точек данных Sum, Histogram и Exponential histogram это конец периода измерения. Поведение свойства: - только для чтения |
| value | float | Значение точки данных. Применяется к точкам данных Gauge и Sum. По умолчанию: 0.Поведение свойства: - только для чтения |
| flags | integer | Битовая маска флагов точки данных. Если установлен младший значащий бит (значение 1), для точки данных значение не записывалось.Поведение свойства: - только для чтения |
| exemplars | array | Массив объектов exemplar, то есть отдельных измерений, сохраненных в качестве примеров, с трассировкой и спаном, во время которых они были записаны. Поведение свойства: - только для чтения |
| aggregation_temporality | integer | Способ агрегирования значений точки данных во времени. Применяется к точкам данных Sum, Histogram и Exponential histogram. Возможные значения: 0 - (по умолчанию) Не указано; 1 - Delta (агрегирование за период с момента предыдущей точки данных); 2 - Cumulative (агрегирование за период с момента start_time_unix).Поведение свойства: - только для чтения |
| is_monotonic | boolean | Указывает, может ли сумма только увеличиваться или оставаться неизменной с течением времени. Применяется к точкам данных Sum. По умолчанию: false.Поведение свойства: - только для чтения |
| count | integer | Количество измерений в точке данных. Применяется к точкам данных Histogram и Exponential histogram. По умолчанию: 0.Поведение свойства: - только для чтения |
| sum | float | Сумма всех измерений в точке данных. Применяется к точкам данных Histogram и Exponential histogram. По умолчанию: 0.Поведение свойства: - только для чтения |
| bucket_counts | array | Массив целых чисел с количеством измерений в каждой корзине гистограммы. Корзины определяются параметром explicit_bounds.Применяется к точкам данных Histogram. По умолчанию: [].Поведение свойства: - только для чтения |
| explicit_bounds | array | Массив чисел с плавающей точкой, задающих границы между корзинами гистограммы. Применяется к точкам данных Histogram. По умолчанию: [].Поведение свойства: - только для чтения |
| min | float | Наименьшее из измерений в точке данных. Применяется к точкам данных Histogram и Exponential histogram. По умолчанию: 0.Поведение свойства: - только для чтения |
| max | float | Наибольшее из измерений в точке данных. Применяется к точкам данных Histogram и Exponential histogram. По умолчанию: 0.Поведение свойства: - только для чтения |
| scale | integer | Масштаб экспоненциальной гистограммы, определяющий границы корзин и разрешение. Более высокий масштаб обеспечивает более узкие корзины и более высокое разрешение; более низкий масштаб обеспечивает более широкие корзины и более низкое разрешение. Применяется к точкам данных Exponential histogram. По умолчанию: 0.Поведение свойства: - только для чтения |
| zero_count | integer | Количество измерений в нулевой корзине экспоненциальной гистограммы. Применяется к точкам данных Exponential histogram. По умолчанию: 0.Поведение свойства: - только для чтения |
| positive_bucket_counts | array | Массив целых чисел с количеством положительных измерений в каждой корзине экспоненциальной гистограммы. Границы корзин определяются параметром scale; индекс первой корзины задается в positive_offset.Применяется к точкам данных Exponential histogram. По умолчанию: [].Поведение свойства: - только для чтения |
| positive_offset | integer | Индекс первой корзины в positive_bucket_counts.Применяется к точкам данных Exponential histogram. По умолчанию: 0.Поведение свойства: - только для чтения |
| negative_bucket_counts | array | Массив целых чисел с количеством отрицательных измерений в каждой корзине экспоненциальной гистограммы. Границы корзин определяются параметром scale; индекс первой корзины задается в negative_offset.Применяется к точкам данных Exponential histogram. По умолчанию: [].Поведение свойства: - только для чтения |
| negative_offset | integer | Индекс первой корзины в negative_bucket_counts.Применяется к точкам данных Exponential histogram. По умолчанию: 0.Поведение свойства: - только для чтения |
Экземпляр
Объект экземпляра имеет следующие свойства:
| Свойство | Тип | Описание |
|---|---|---|
| traceid | string | Идентификатор трассировки, если он есть, во время которой была записана измеренная величина. Столбец источника данных: Exemplars.TraceId. |
| spanid | string | Идентификатор интервала, если он есть, во время которого была записана измеренная величина. Столбец источника данных: Exemplars.SpanId. |
| value | float | Значение измеренной величины. Столбец источника данных: Exemplars.Value. |
| time_unix | integer | Время Unix (в наносекундах), когда была записана измеренная величина. Столбец источника данных: Exemplars.TimeUnix. |
| filtered_attributes | object | Атрибуты измеренной величины в формате «ключ-значение», которые не включены в attributes точки данных.Столбец источника данных: Exemplars.FilteredAttributes. |