指标

概述

APM > 指标 部分显示从应用程序和服务收集的指标数据点。

指标是某项测量结果（例如，请求持续时间、已处理订单数或内存使用量）。 应用程序将其值作为数据点发送，其中包含在特定时间测量的值（或聚合值）。 指标类似于 Zabbix 监控项，数据点类似于该监控项的值。

数据点可以是以下类型之一：

  • 仪表盘（Gauge） - 在特定时间测量的值（例如，当前内存使用量）。
  • 总和（Sum） - 一段时间内测量值的总和（例如，请求总数）。
  • 直方图（Histogram） - 一段时间内落入多个固定值范围（称为桶）的测量值数量（例如，请求耗时分别为 0-100 毫秒、100-250 毫秒或 250-500 毫秒的数量）。
  • 指数直方图（Exponential histogram） - 类似于直方图，但每个桶的宽度都按相同的倍数递增（例如，1-2 毫秒、2-4 毫秒、4-8 毫秒）。

每个数据点由一个服务生成（例如，zabbix-frontend；由 OpenTelemetry 的 service.name 资源属性命名），并由一个检测范围生成，即创建该数据点的代码部分（例如，用于测量 HTTP 请求持续时间的库）。

为了提供每项测量的上下文，数据点还具有键值形式的属性：数据点属性描述测量的内容，并区分同一指标的数据点（例如，http.request.method: POST）；资源属性描述服务及其运行环境（例如，host.name: eabf8c2a5ddc）。

有关指标的更多详细信息，请参阅 OpenTelemetry 文档。

APM > 指标 部分包含以下元素：

指标列表

指标列表中的每一行代表一个数据点。

数据点显示在可自定义的表格中。 表头中的 自定义表格按钮可用于显示、隐藏或重新排列列，并将布局重置为默认设置。 您还可以通过拖动列的右边框来调整列宽；双击边框可将其重置。 所有自定义设置会立即应用，并为当前用户保存。

指标列表可以包含以下列：

除 类型 外，每一列都对应于遥测数据源的指标表（otel_metrics_gauge、otel_metrics_sum、otel_metrics_histogram 和 otel_metrics_exponential_histogram）中的一列；有关列列表，请参阅支持的遥测数据列。 大多数列的名称与数据源中的名称相同（例如，指标名称对应于 MetricName 列）。 如果名称不同，下表中会指定数据源列。

列 描述
指标名称 数据点所属的指标（例如，http.server.duration）。
类型 数据点的类型：Gauge、Sum、Histogram 或 Exponential histogram。
由包含该数据点的指标表确定。
单位 指标值的单位（如果有）（例如，s 或 By；请参阅 UCUM）。
数据源列：MetricUnit。
服务名称 生成该数据点的服务。
范围名称 生成该数据点的检测范围。
开始时间 数据点测量周期开始的日期和时间。
数据源列：StartTimeUnix。
总和/值 所有测量值的总和（Histogram、Exponential histogram），或数据点的值（Gauge、Sum）。
计数 Histogram 或 Exponential histogram 数据点中的测量值数量。
时间 数据点的日期和时间；对于 Sum、Histogram 和 Exponential histogram 数据点，表示测量周期的结束时间。
数据源列：TimeUnix。
标志 数据点的标志：
0 - 未设置任何标志。
1 - 未记录该数据点的值。
聚合临时性 Sum、Histogram 或 Exponential histogram 数据点的值如何随时间聚合：
未指定 - 未指定。
增量 - 聚合自上一个数据点以来期间的值。
累计 - 聚合自开始时间以来期间的值。
指标描述 指标的描述（如果有）。
属性 数据点属性。
单击 三点按钮可显示所有属性。
资源属性 数据点的资源属性。
单击 三点按钮可显示所有属性。
范围属性 检测范围的属性。
单击 三点按钮可显示所有属性。

指标详细信息

点击指标列表中的数据点，打开指标详细信息面板，其中显示有关该数据点的所有信息。

指标详细信息面板可能包含以下部分：

部分 描述
基本信息 指标名称、类型、单位、服务名称和开始时间。
直方图 存储桶（例如 > 5 - 10），以及每个存储桶中的测量数量。
仅对 直方图 数据点显示。
指数直方图 存储桶（例如 >= 249.7885 - 249.7887），以及每个存储桶中的测量数量。
仅对 指数直方图 数据点显示。
指标信息 数据点的值（取决于其类型），以及指标描述、时间、标志和资源架构 URL。
属性 数据点属性。
资源属性 资源属性。
范围属性 检测范围的属性（如果有）。
范围 检测范围的名称、版本和架构 URL。

使用筛选器

您可以使用筛选器，仅显示感兴趣的数据点。

要按属性筛选，请输入属性键，选择运算符，然后输入属性值。

支持以下运算符：

  • 包含 - (默认) 属性值包含输入的字符串。
  • 等于 - 属性值等于输入的字符串。
  • 不包含 - 属性值不包含输入的字符串。
  • 不等于 - 属性值不等于输入的字符串。
  • 存在 - 存在具有输入键的属性。
  • 不存在 - 不存在具有输入键的属性。

如果添加多个条件，请选择评估这些条件的方式：

  • And/Or - (默认) 必须满足所有条件；具有相同属性键的条件使用 Or 组合。
  • Or - 至少满足一个条件。