リソース · 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

受け入れ確認ノート

このガイドの基準に沿って観測を記録します。記録は認証ではありません。

自動保存されません。離れる前に書き出してください。

管理指標

指標測定対象最初のアクション
既知の欠落宛先にない期待する識別子同じ参照集合と観測締切
受信した重複行数 − 固有識別子数未知の喪失の測定ではない

よくある間違い

    よくある質問

    三行受信したら三イベントを保持した証拠ですか?

    いいえ。同じ識別子の二行が欠落を隠すことがあります。識別子、観測期間、各段階を比較します。

    公式参照文献

    参照文献はメソッドを裏付けるものです。 チェックは状況に合わせて調整してください。 これらは認証ではありません。 元の参照文献のタイトルやソース文書は別の言語で書かれている場合があります。

    参照資料の確認日 .