概要
Error Tracking は、取り込むエラーを細かく制御することで、ノイズを減らし予期せぬコストを避けるのに役立ちます。
Error Tracking に含まれるデータは以下の 2 つの方法で定義できます。
Error Tracking > Settings ページでは、ルールとレート制限の両方を設定できます。
ルール
ルールでは、どのエラーを Error Tracking に取り込むかを選択できます。ルールは、課金対象と非課金対象のエラーの両方に適用されます。
各ルールは以下で構成されます。
- スコープ: 検索クエリ (例:
service:my-web-store) を含む包含フィルター。 - 任意で、1 つ以上のネストされた除外フィルターを追加してルールをさらに絞り込み、一致したイベントの一部を無視できます。たとえば、除外フィルターで
env:staging を使い、ステージング環境のエラーを除外できます。
各ルールは有効/無効を切り替えられます。エラー イベントは、アクティブな包含フィルターのいずれかのクエリに一致し、かつアクティブなネストされた除外クエリのどれにも一致しない場合に取り込まれます。
各エラー イベントは、ルールの順番どおりに照合されます。イベントは、一致した最初の有効なルールだけで処理され、それ以降のルールはすべて無視されます。一致したルールに除外フィルターがある場合、そのイベントは除外されます。除外フィルターがなければ、イベントは取り込まれます。
注: 必須属性が欠けている場合、ルールによって受け入れられたエラーイベントは、Error Tracking から除外される可能性があります。
評価順序
ルールは順番に評価され、最初に一致したルールで評価が停止します。ルールとそのネストされたフィルターの優先順位は、リスト内の順序に依存します。
ルールの一覧が次のとおりの場合:
処理フローは次のとおりです:
env:prod service:my-service status:warn のイベントは、
- ルール 1 に一致し、その除外フィルターへ進みます
- 除外フィルター 1-1 には一致しないため、除外フィルター 1-2 へ進みます
- 除外フィルター 1-2 で一致するので、このイベントは破棄されます
env:staging service:web のイベントは、
デフォルトのルール
デフォルトでは、Error Tracking には * の包含フィルターがあり、除外フィルターはありません。つまり、フィンガープリント化の 要件 を満たすすべてのエラーが Error Tracking に取り込まれます。
ルールの追加
ルール (包含フィルター) を追加するには
- Error Tracking Settings に移動します。
- Add New Rule をクリックします。
- ルールを適用する Error Tracking source を選択します。
- Define scope フィールドに検索クエリを入力します。
- 必要に応じて、Add Exclusion フィルターと説明をルールに追加します。
- Save Changes をクリックします。
- オプションで、評価順序を変更するには、ルールを並べ替えます。指定したルールの 6 つの点のアイコンをクリックしてドラッグすると、そのルールがリスト内で上下に移動します。
レート制限
レート制限を使うと、1 日あたり Error Tracking に含める課金対象エラー数を制御できます。この上限は、ルール のフィルターに一致するすべてのエラーに適用されます。
1 日の上限に達すると、翌日まで取り込みが止まります。上限はいつでも変更・解除できます。
レート制限の設定
レート制限を設定するには
- Error Tracking > Settings に移動します。
- Rate Limits をクリックします。
- errors/day フィールドを編集します。
- Save Rate Limit をクリックします。
レート制限に到達すると、Rate limit applied イベントが生成されます。イベントの表示と活用方法の詳細は、Event Management ドキュメント を参照してください。
使用量の監視
取り込まれたエラー ログ数を追跡するメトリクス datadog.estimated_usage.error_tracking.logs.events に対してモニターとアラートを設定すると、Logs 上の Error Tracking の使用量を監視できます。
このメトリクスは追加費用なしでデフォルトで利用でき、データは 15 か月間保持されます。
動的サンプリング
Error Tracking の課金はエラー数に基づいているため、単一の issue でエラーが大幅に増加すると、Error Tracking の予算が急速に消費される可能性があります。Dynamic Sampling は、日次レート制限と過去のエラー数に基づいて issue ごとのエラー レートのしきい値を設定し、そのしきい値に達した場合にエラーをサンプリングすることで、保護します。issue のエラー レートが指定のしきい値を下回ると、Dynamic Sampling は自動的に無効化されます。
セットアップ
Dynamic Sampling は Error Tracking と共に自動的に有効化され、日次レート制限と過去のボリュームに基づくデフォルトの取り込みしきい値が設定されます。
より確実に運用するには、Error Tracking Rate Limits ページ で日次のレート制限を設定してください: Edit Rate Limit をクリックし、新しい値を入力します。
Dynamic Sampling の無効化
Dynamic Sampling は Error Tracking の設定ページ で無効化できます。
Dynamic Sampling の監視
issue に Dynamic Sampling が適用されると、Dynamic Sampling activated イベントが生成されます。イベントの表示と活用方法の詳細は、Event Management ドキュメント を参照してください。
調査および緩和手順
Dynamic Sampling が適用された場合、次の手順を推奨します:
- どの issue がクォータを消費しているかを確認します。Dynamic Sampling が適用された issue へのリンクは、Event Management で生成されたイベント内に含まれています。
- この issue のサンプルを追加で収集したい場合は、Error Tracking Rate Limits ページ で日次クォータを増やしてください。
- 今後この issue のサンプル収集を避けたい場合は、除外フィルターを作成して、追加のイベントが Error Tracking に取り込まれないようにすることを検討してください。
その他の参考資料
