跳转到内容
Telemetry
API 可靠性 SQL查询示例

按计划衡量事件对客户的影响

按计划计算受影响的帐户和平均影响持续时间,而无需暴露客户名称或原始请求数据。

中级incident_account_impact_events已审核 2026-07-28测试用 阿帕奇 DataFusion 45.2.0

审阅者 Telemetry产品团队 . SQL 兼容性、事件契约、合成输出和操作注意事项. 审查标准和所有权

问题已回答

每个计划中有多少个账户受到该事件的影响?

服务级别错误率并不能说明谁受到了影响。有限影响事件将一个事件与匿名帐户、计划、受控影响类型和持续时间连接起来,以便响应团队可以优先考虑恢复和沟通。

活动合约

查询期望的字段

字段类型为什么存在
timestamp_utcTimestamp影响评估时间(UTC)。
incident_idUtf8稳定的事件标识符。
account_idUtf8批准的假名帐户标识符。
planUtf8有界计划或服务级别。
impact_typeUtf8受控的客户可见影响类别。
affectedBoolean该帐户是否符合记录的影响定义。
impact_duration_msInt64测量的影响持续时间(以毫秒为单位)。
environmentUtf8部署环境。
DataFusion SQL

复制查询

sql
SELECT
  incident_id,
  plan,
  COUNT(*) AS assessed_accounts,
  SUM(CASE WHEN affected THEN 1 ELSE 0 END) AS affected_accounts,
  100.0 * SUM(CASE WHEN affected THEN 1 ELSE 0 END)
    / NULLIF(COUNT(*), 0) AS affected_accounts_pct,
  AVG(CASE WHEN affected THEN impact_duration_ms ELSE NULL END)
    AS avg_impact_duration_ms
FROM incident_account_impact_events
WHERE timestamp_utc >= now() - INTERVAL '7 days'
  AND environment = 'production'
GROUP BY incident_id, plan
ORDER BY affected_accounts DESC, plan;

此只读查询是针对空类型表计划和执行的 阿帕奇 DataFusion 45.2.0。确定性样本输出是综合的并单独审查;根据您自己的数据验证字段类型、阈值和业务定义。 阅读测试方法。

查询结果

按计划受影响的账户

三个企业帐户和两个入门帐户符合综合事件影响定义。

incident_idplanassessed_accountsaffected_accountsaffected_accounts_pctavg_impact_duration_ms
incident-checkout-42enterprise437540,000
incident-checkout-42starter524020,000

综合示例输出。在将其用于操作决策之前,针对您自己的事件架构和阈值运行查询。

Affected accounts by plan:来自 Measure Incident Customer Impact by Plan 示例结果的合成 affected_accounts 值的静态图表
确定性示例输出的可索引 SVG。下载它以获取带有归属的文章、操作手册或设计评论。

重现示例

下载公共装置

JSON 包包含类型化事件契约, reproducible 输入行、确切的 SQL、预期输出、审阅注释和引擎版本。 CSV 包含显示的结果。

SQL 是如何工作的

  1. 1分摊账户分母可防止不完整的连接伪装成低影响率。
  2. 2计划是一个有界的优先级维度;该查询不会公开客户名称。
  3. 3仅针对受影响的帐户计算影响持续时间,因此未受影响的行不会将平均值拉向零。

需要决定的边缘情况

  • 使用用户可见的结果来定义受影响的一次,而不仅仅是相关的内部错误。
  • 一个账号可能有多个用户或多个地区;在发出行之前选择报告单位。
  • 限制帐户级别的向下钻取,并仅将聚合用于已批准的响应工作流程。

推荐仪表板

  • 钢筋:按计划 affected_accounts
  • 趋势:新受影响和恢复的账户
  • 限制表:批准的账户标识符和影响类型

警报指导

使用此查询在事件检测后确定范围和升级;不要为每个帐户级行创建第二页。

读取警报设置

让查询示例发挥作用

相关埋点和指南

继续分析

在真实事件中运行它

创建表,调整字段并保存结果

免费开始,发送结构化事件,并将查询结果用作图表、共享仪表板小部件或警报输入。

获取 API 密钥