量度端点

可观察性指标可为Adobe Experience Platform中的各种功能提供使用统计数据、历史趋势和绩效指标的洞察。 此 /metrics 中的端点 Observability Insights API 允许您以编程方式检索您组织活动的量度数据,位置在 Platform.

NOTE
已弃用先前版本的量度端点(V1)。 本文档仅侧重于当前版本(V2)。 有关旧版实施的V1端点的详细信息,请参阅 API参考.

快速入门

本指南中使用的API端点是 Observability Insights API. 在继续之前,请查看 快速入门指南 有关相关文档的链接,请参阅本文档中的示例API调用指南,以及有关成功调用任何组件所需的所需标头的重要信息 Experience Platform API。

检索可观察性指标

您可以通过向以下网站发出POST请求来检索量度数据: /metrics 端点,指定要在有效负载中检索的量度。

API格式

POST /metrics

请求

curl -X POST \
  https://platform.adobe.io/data/infrastructure/observability/insights/metrics \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -d '{
        "start": "2020-07-14T00:00:00.000Z",
        "end": "2020-07-22T00:00:00.000Z",
        "granularity": "day",
        "metrics": [
          {
            "name": "timeseries.ingestion.dataset.recordsuccess.count",
            "filters": [
              {
                "name": "dataSetId",
                "value": "5edcfb2fbb642119194c7d94|5eddb21420f516191b7a8dad",
                "groupBy": true
              }
            ],
            "aggregator": "sum",
            "downsample": "sum"
          },
          {
            "name": "timeseries.ingestion.dataset.dailysize",
            "filters": [
              {
                "name": "dataSetId",
                "value": "5eddb21420f516191b7a8dad",
                "groupBy": false
              }
            ],
            "aggregator": "sum",
            "downsample": "sum"
          }
        ]
      }'
属性
描述
start
检索量度数据的最早日期/时间。
end
从中检索量度数据的最新日期/时间。
granularity
一个可选字段,指示指标数据除以的时间间隔。 例如,值 DAY 返回介于以下日期之间的每天的指标: startend 日期,而值为 MONTH 将改为按月对指标结果进行分组。 使用此字段时, downsample 还必须提供属性以指示用于对数据进行分组的聚合函数。
metrics
一个对象数组,每个对象对应一个要检索的指标。
name
可观察性分析识别的指标的名称。 请参阅 附录 以获取已接受的量度名称的完整列表。
filters

一个可选字段,允许您按特定数据集筛选量度。 字段是一个对象数组(每个过滤器对应一个对象),每个对象包含以下属性:

  • name:要筛选量度的实体类型。 当前,仅限 dataSets 受支持。
  • value:一个或多个数据集的ID。 可以将多个数据集ID作为单个字符串提供,每个ID均以垂直条形字符(|)。
  • groupBy:设置为true时,指示相应的 value 表示多个数据集,这些数据集的量度结果应单独返回。 如果设置为false,则将这些数据集的量度结果分组在一起。
aggregator
指定应将多个时间序列记录分组为单个结果的聚合函数。 有关可用聚合的详细信息,请参阅 OpenTSDB文档.
downsample
一个可选字段,可让您指定聚合函数,通过按间隔(或“分段”)对字段进行排序,降低量度数据的采样率。 缩减采样的间隔由 granularity 属性。 有关缩减取样的详细信息,请参阅 OpenTSDB文档.

响应

成功响应将返回请求中指定的量度和过滤器的结果数据点。

{
  "metricResponses": [
    {
      "metric": "timeseries.ingestion.dataset.recordsuccess.count",
      "filters": [
        {
          "name": "dataSetId",
          "value": "5edcfb2fbb642119194c7d94|5eddb21420f516191b7a8dad",
          "groupBy": true
        }
      ],
      "datapoints": [
        {
          "groupBy": {
            "dataSetId": "5edcfb2fbb642119194c7d94"
          },
          "dps": {
            "2020-07-14T00:00:00Z": 44.0,
            "2020-07-15T00:00:00Z": 46.0,
            "2020-07-16T00:00:00Z": 36.0,
            "2020-07-17T00:00:00Z": 50.0,
            "2020-07-18T00:00:00Z": 38.0,
            "2020-07-19T00:00:00Z": 40.0,
            "2020-07-20T00:00:00Z": 42.0,
            "2020-07-21T00:00:00Z": 42.0,
            "2020-07-22T00:00:00Z": 50.0
          }
        },
        {
          "groupBy": {
            "dataSetId": "5eddb21420f516191b7a8dad"
          },
          "dps": {
            "2020-07-14T00:00:00Z": 44.0,
            "2020-07-15T00:00:00Z": 46.0,
            "2020-07-16T00:00:00Z": 36.0,
            "2020-07-17T00:00:00Z": 50.0,
            "2020-07-18T00:00:00Z": 38.0,
            "2020-07-19T00:00:00Z": 40.0,
            "2020-07-20T00:00:00Z": 42.0,
            "2020-07-21T00:00:00Z": 42.0,
            "2020-07-22T00:00:00Z": 50.0
          }
        }
      ],
      "granularity": "DAY"
    },
    {
      "metric": "timeseries.ingestion.dataset.dailysize",
      "filters": [
        {
          "name": "dataSetId",
          "value": "5eddb21420f516191b7a8dad",
          "groupBy": false
        }
      ],
      "datapoints": [
        {
          "groupBy": {},
          "dps": {
            "2020-07-14T00:00:00Z": 38455.0,
            "2020-07-15T00:00:00Z": 40213.0,
            "2020-07-16T00:00:00Z": 31476.0,
            "2020-07-17T00:00:00Z": 43705.0,
            "2020-07-18T00:00:00Z": 33227.0,
            "2020-07-19T00:00:00Z": 34977.0,
            "2020-07-20T00:00:00Z": 36735.0,
            "2020-07-21T00:00:00Z": 36737.0,
            "2020-07-22T00:00:00Z": 43715.0
          }
        }
      ],
      "granularity": "DAY"
    }
  ]
}
属性
描述
metricResponses
一个数组,其对象表示请求中指定的每个度量。 每个对象都包含有关过滤器配置和返回的量度数据的信息。
metric
请求中提供的某个指标的名称。
filters
指定量度的过滤器配置。
datapoints
一个数组,其对象表示指定量度和过滤器的结果。 数组中的对象数取决于请求中提供的过滤器选项。 如果未提供任何筛选器,则数组将仅包含表示所有数据集的单个对象。
groupBy
如果在 filter 量度的属性,以及 groupBy 选项在请求中设置为true,此对象将包含相应数据集的ID dps 属性应用于。

如果此对象在响应中显示为空,则相应的 dps 属性适用于 filters 数组(或中的所有数据集) Platform (如果未提供过滤器)。
dps
为给定的量度、过滤器和时间范围返回的数据。 此对象中的每个键都表示一个时间戳,该时间戳具有指定量度的相应值。 每个数据点之间的时间段取决于 granularity 请求中指定的值。

附录

以下部分包含有关使用的其他信息 /metrics 端点。

可用量度 available-metrics

下表列出了由以下对象公开的所有指标 Observability Insights,划分依据 Platform 服务。 每个量度都包含一个描述和接受的ID查询参数。

NOTE
除非另有说明,否则列出的所有ID查询参数都是可选的。

Data Ingestion ingestion

下表概述了Adobe Experience Platform的量度 Data Ingestion. 中的量度 粗体 是流式摄取量度。

分析量度
描述
ID查询参数
timeseries.ingestion.dataset.size
针对一个数据集或所有数据集摄取的所有数据的累积大小。
数据集 ID
timeseries.ingestion.dataset.dailysize
针对一个数据集或所有数据集按每日使用情况摄取的数据大小。
数据集 ID
timeseries.ingestion.dataset.batchfailed.count
一个数据集或所有数据集失败的批次数。
数据集 ID
timeseries.ingestion.dataset.batchsuccess.count
为一个数据集或所有数据集摄取的批次数。
数据集 ID
timeseries.ingestion.dataset.recordsuccess.count
为一个数据集或所有数据集摄取的记录数。
数据集 ID
timeseries.data.collection.validation.category.presence.count
一个数据集或所有数据集的无效“存在”消息总数。
数据集 ID
timeseries.data.collection.inlet.total.messages.received
针对一个数据入口或所有数据入口接收的消息总数。
入口编号
timeseries.data.collection.inlet.total.messages.size.received
为一个数据入口或所有数据入口接收的数据总大小。
入口编号
timeseries.data.collection.inlet.success
成功调用一个数据入口或所有数据入口的HTTP总数。
入口编号
timeseries.data.collection.inlet.failure
对一个数据入口或所有数据入口失败的HTTP调用总数。
入口编号

Identity Service identity

下表概述了Adobe Experience Platform的量度 Identity Service.

分析量度
描述
ID查询参数
timeseries.identity.dataset.recordsuccess.count
写入其数据源的记录数 Identity Service,用于一个数据集或所有数据集。
数据集 ID
timeseries.identity.dataset.recordfailed.count
失败的记录数,失败者为 Identity Service、用于一个数据集或用于所有数据集。
数据集 ID
timeseries.identity.dataset.namespacecode.recordfailed.count
命名空间失败的身份记录数。
命名空间ID (必需)
timeseries.identity.dataset.namespacecode.recordskipped.count
命名空间跳过的身份记录数。
命名空间ID (必需)
timeseries.identity.graph.imsorg.uniqueidentities.count
存储在贵组织的身份图中的唯一身份数。
不适用
timeseries.identity.graph.imsorg.namespacecode.uniqueidentities.count
命名空间在身份图中存储的唯一身份数。
命名空间ID (必需)
timeseries.identity.graph.imsorg.graphstrength.uniqueidentities.count
组织中针对特定图形强度(“未知”、“弱”或“强”)存储在身份图中的唯一身份数。
图表强度(必需)

Real-Time Customer Profile profile

下表概述了以下各项的指标 Real-Time Customer Profile.

分析量度
描述
ID查询参数
timeseries.profiles.dataset.recordread.count
从读取的记录数 Data Lake 作者: Profile、用于一个数据集或用于所有数据集。
数据集 ID
timeseries.profiles.dataset.recordsuccess.count
写入其数据源的记录数 Profile、用于一个数据集或用于所有数据集。
数据集 ID
timeseries.profiles.dataset.batchsuccess.count
数量 Profile 为数据集或所有数据集摄取的批次。
数据集 ID

错误消息

来自 /metrics 端点可能会在某些情况下返回错误消息。 以下列格式返回这些错误消息:

{
    "type": "http://ns.adobe.com/aep/errors/INSGHT-1000-400",
    "title": "Bad Request - Start date cannot be after end date.",
    "status": 400,
    "report": {
        "tenantInfo": {
            "sandboxName": "prod",
            "sandboxId": "49f58060-5d47-34rd-aawf-a5384333ff12",
            "imsOrgId": "{ORG_ID}"
        },
        "additionalContext": null
    },
    "error-chain": [
        {
            "serviceId": "INSGHT",
            "errorCode": "INSGHT-1000-400",
            "invokingServiceId": "INSGHT",
            "unixTimeStampMs": 1602095177129
        }
    ]
}
属性
描述
title
一个字符串,其中包含错误消息及其可能发生的可能原因。
report
包含有关错误的上下文信息,包括触发该错误的操作中使用的沙盒和组织。

下表列出了API可返回的不同错误代码:

错误代码
标题
描述
INSGHT-1000-400
请求有效负载无效

请求有效负载出现问题。 确保与所示的有效负载格式完全匹配 以上. 任何可能的原因都会触发此错误:

  • 缺少必填字段,例如 aggregator
  • 量度无效
  • 该请求包含无效的汇总
  • 开始日期发生在结束日期之后
INSGHT-1001-400
量度查询失败
尝试查询量度数据库时出错,因为请求不正确或查询本身无法分析。 在重试之前,请确保您的请求格式正确。
INSGHT-1001-500
量度查询失败
由于服务器错误,尝试查询指标数据库时出错。 请再次尝试该请求,如果问题仍然存在,请联系Adobe支持。
INSGHT-1002-500
服务错误
由于内部错误,无法处理该请求。 请再次尝试该请求,如果问题仍然存在,请联系Adobe支持。
INSGHT-1003-401
沙盒验证错误
由于沙盒验证错误,无法处理该请求。 确保您在 x-sandbox-name 在重试请求之前,标头表示您的组织已启用的有效沙盒。
recommendation-more-help
d82ad670-3501-465b-afee-a91200fdc02c