资源 · 113

采集故障：核对日志与缺失事件

区分已生成、已接收和可用事件，不把沉默当作没有事故的证据。

已更新 · 2 min

本指南有助于实现的目标

  • 定义可观察的参考集合
  • 演练受控中断
  • 比较标识并明确未知

快速检查

  • 参考序列和核对规则。
  • 故障时间线和边界行为。
  • 差异列表和明确覆盖状态。

分步指南

  1. 1

    定义可观察的参考集合

    梳理应用、采集器、存储和负责人。准备有限的虚构事件序列，使用稳定标识，不含秘密或客户数据。保存事件时间和观察时间；采集延迟不自动等于丢失。

    参考序列和核对规则。

  2. 2

    演练受控中断

    在测试中中断目标后恢复。观察队列填充、重试、拒绝和重启。持久队列能限制部分损失，但容量有限且依赖存储；定义满队列行为。检查采集不会悄悄阻塞服务。

    故障时间线和边界行为。

  3. 3

    比较标识并明确未知

    在相同观察截止点核对参考集合和实际可读事件。分别统计重复、延迟和缺失；网络确认不证明最终可用。没有可靠参考时明确覆盖未知，不能写成零丢失或零事故。

    差异列表和明确覆盖状态。

可复现的验收案例

虚构示例：数据不代表客户或实际观察结果。

查看案例输入
{
    "expected_ids": [
        "E1",
        "E2",
        "E3"
    ],
    "received_ids": [
        "E1",
        "E1",
        "E3"
    ],
    "received_rows": 3,
    "unique_received": 2,
    "missing_ids": [
        "E2"
    ],
    "observation_cutoff": "same_for_both_sets"
}

预期判断

虚构例：预期E1、E2、E3，却收到E1、E1、E3。三行不能证明完整：E1重复，截止点仍缺E2。

OpenTelemetry — Collector resiliency

您的验收笔记

按本指南的标准记录观察。记录不等于认证。

笔记不会自动保存。离开前请导出。

管理指标

指标衡量内容首要行动
已知缺失事件目标中缺少的预期标识相同参考集合与截止点
接收重复行数 − 唯一标识数不衡量未知丢失

常见错误

    常见问题解答

    收到三行能证明保留了三个事件吗？

    不能。两行可能重复同一标识并掩盖缺失。比较标识、观察窗口和链路阶段。

    官方参考文献

    参考文献支持该方法。 请根据您的实际情况调整检查；它们并非认证。 原始参考文献标题和源文档可能使用其他语言。

    参考资料查阅日期 .

    继续探索

    所有指南了解服务

    相关分析