APM 监控项对象

以下对象与 apmmetric API 直接相关。

除 type 外，每个属性都对应于遥测数据源的监控项表（otel_metrics_gauge、otel_metrics_sum、otel_metrics_histogram 和 otel_metrics_exponential_histogram）中的一列。 大多数属性对应于名称相同的列（例如，metric_name 属性对应于 MetricName 列）。 如果名称不同，下表将指定数据源中的列名。 有关列的列表，请参阅支持的遥测数据列。

APM 指标

APM 指标对象表示指标的一个数据点（某个特定时间的测量值或聚合值）。

APM 指标对象具有以下属性：

属性 类型 描述
type integer 数据点的类型。

可能的值：
0 - 仪表盘；
1 - 总和；
2 - 直方图；
3 - 指数直方图。

类型由存储数据点的表决定：otel_metrics_gauge、otel_metrics_sum、otel_metrics_histogram 或 otel_metrics_exponential_histogram。

属性行为：
- 只读
resource_attributes object 数据点的键值对资源属性（例如 host.name: eabf8c2a5ddc）。

属性行为：
- 只读
resource_schema_url string 资源属性对应的 OpenTelemetry 架构 URL（如果有）。

属性行为：
- 只读
scope_name string 生成数据点的检测范围名称。

属性行为：
- 只读
scope_version string 检测范围的版本（如果有）。

属性行为：
- 只读
scope_attributes object 检测范围的键值对属性。

属性行为：
- 只读
scope_schema_url string 检测范围及其属性对应的 OpenTelemetry 架构 URL（如果有）。

属性行为：
- 只读
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 时间（以纳秒为单位）。
对于总和、直方图和指数直方图数据点，这是测量周期的结束时间。

属性行为：
- 只读
value float 数据点的值。
适用于仪表盘和总和数据点。

默认值：0。

属性行为：
- 只读
flags integer 数据点标志的位掩码。
如果最低有效位已设置（值为 1），则未记录该数据点的值。

属性行为：
- 只读
exemplars array 示例对象数组，即作为示例保留的单独测量值，以及记录这些测量值期间的跟踪和跨度。

属性行为：
- 只读
aggregation_temporality integer 数据点的值随时间聚合的方式。
适用于总和、直方图和指数直方图数据点。

可能的值：
0 - （默认）未指定；
1 - 增量（聚合自上一个数据点以来的周期）；
2 - 累积（聚合自 start_time_unix 以来的周期）。

属性行为：
- 只读
is_monotonic boolean 总和是否只能随时间增加或保持不变。
适用于总和数据点。

默认值：false。

属性行为：
- 只读
count integer 数据点中的测量值数量。
适用于直方图和指数直方图数据点。

默认值：0。

属性行为：
- 只读
sum float 数据点中所有测量值的总和。
适用于直方图和指数直方图数据点。

默认值：0。

属性行为：
- 只读
bucket_counts array 整数数组，表示每个直方图桶中的测量值数量。
桶由 explicit_bounds 定义。
适用于直方图数据点。

默认值：[]。

属性行为：
- 只读
explicit_bounds array 浮点数数组，表示直方图桶之间的边界。
适用于直方图数据点。

默认值：[]。

属性行为：
- 只读
min float 数据点中测量值的最小值。
适用于直方图和指数直方图数据点。

默认值：0。

属性行为：
- 只读
max float 数据点中测量值的最大值。
适用于直方图和指数直方图数据点。

默认值：0。

属性行为：
- 只读
scale integer 指数直方图的缩放比例，用于确定桶边界和分辨率。
较高的缩放比例会产生更窄的桶和更高的分辨率；较低的缩放比例会产生更宽的桶和更低的分辨率。
适用于指数直方图数据点。

默认值：0。

属性行为：
- 只读
zero_count integer 指数直方图零值桶中的测量值数量。
适用于指数直方图数据点。

默认值：0。

属性行为：
- 只读
positive_bucket_counts array 整数数组，表示每个指数直方图桶中的正测量值数量。
桶边界由 scale 确定；第一个桶的索引在 positive_offset 中设置。
适用于指数直方图数据点。

默认值：[]。

属性行为：
- 只读
positive_offset integer positive_bucket_counts 中第一个桶的索引。
适用于指数直方图数据点。

默认值：0。

属性行为：
- 只读
negative_bucket_counts array 整数数组，表示每个指数直方图桶中的负测量值数量。
桶边界由 scale 确定；第一个桶的索引在 negative_offset 中设置。
适用于指数直方图数据点。

默认值：[]。

属性行为：
- 只读
negative_offset integer negative_bucket_counts 中第一个桶的索引。
适用于指数直方图数据点。

默认值：0。

属性行为：
- 只读

示例

示例对象具有以下属性：

Property Type Description
traceid string 记录测量值时所在跟踪的 ID（如果有）。
数据源列：Exemplars.TraceId。
spanid string 记录测量值时所在跨度的 ID（如果有）。
数据源列：Exemplars.SpanId。
value float 测量值。
数据源列：Exemplars.Value。
time_unix integer 记录测量值时的 Unix 时间（以纳秒为单位）。
数据源列：Exemplars.TimeUnix。
filtered_attributes object 测量值的键值属性，这些属性未包含在数据点的 attributes 中。
数据源列：Exemplars.FilteredAttributes。