イベントのテスト、可観測性、障害復旧

イベントとイベントストリームのテストおよび管理について説明します。

以下のセクションでは、イベントストリームのテスト方法とイベントの管理方法について説明します。

​

イベントストリームをテストする

イベントストリームを作成して有効にすると、新しいストリームをテストできます。現在、Auth0 は無効化されたイベントストリームへのイベント送信をサポートしていません。

イベントストリームをテストするには、まず次のコマンドを実行し、任意の認証情報を指定してアプリケーション用のユーザーを作成します。

Auth0 CLI

auth0 users create # プロンプトに従ってテストユーザーを作成します

cURL

curl -s \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -X POST https://$TENANT/api/v2/users \
  -d '{
        "email": "[e-mail]",
        "password": "Password123!",
        "connection": "Username-Password-Authentication"
      }'

ユーザーが作成されると、イベントストリームで user.created イベントがトリガーされ、レスポンスが返されるはずです。この例では、イベントストリームの送信先としてウェブフックを使用しています。

"Webhook received": {
  "id": "evt_6SfwXrtm8nVcjzzNCFFH1L",
  "source": "urn:auth0:",
  "specversion": "1.0",
  "type": "user.created",
  "time": "2025-02-02T17:56:01.573Z",
  "data": {
    "object": {
      "created_at": "2025-02-02T17:56:01.566Z",
      "email": "[e-mail]",
      "email_verified": false,
      "identities": [
        {
          "connection": "Username-Password-Authentication",
          "isSocial": false,
          "provider": "auth0",
          "user_id": "679fb1b1e809445f129bc18d"
        }
      ],
      "name": "[e-mail]",
      "nickname": "nick-testing-21",
      "picture": "test.png",
      "updated_at": "2025-02-02T17:56:01.566Z",
      "user_id": "auth0|679fb1b1e809445f129bc18d"
    }
  },
  "a0tenant": "acme",
  "a0stream": "est_38ANnv8pQhqsZrX2VFbftv",
  "a0purpose": "test"
}

次を実行すると、特定のイベントストリームのイベント配信失敗を一覧表示できます。

Auth0 CLI

auth0 api get event-streams/$EVENT_STREAM_ID/deliveries

cURL

curl -s -H "Authorization: Bearer $TOKEN" \
  "https://$TENANT/api/v2/event-streams/${EVENT_STREAM_ID}/deliveries" | jq .

空の配信失敗配列が返された場合、イベントストリームは正常に動作しています。

​

可観測性

イベントストリームの信頼性を確保するため、配信失敗を定期的に確認し、必要に応じてアラートを発報する監視プロセスを実装します。

配信失敗は、次の原因で発生する可能性があります。

• イベントストリームが無効になっている。
• イベントストリームが利用できない。
• 接続エラー。

​

Deliveries エンドポイントのポーリング

失敗したイベントを確認するため、5 分ごとに Deliveries エンドポイントをポーリングします。最近のイベント配信を取得するには、次の API 呼び出しを使用します。

Auth0 CLI

auth0 api get event-streams/$EVENT_STREAM_ID/deliveries

cURL

curl -s -H "Authorization: Bearer $TOKEN" \
  "https://$TENANT/api/v2/event-streams/${EVENT_STREAM_ID}/deliveries" | jq .

失敗が検出された場合:

• 失敗したイベントの詳細をログに記録します。
• 問題を確認して原因を特定できるよう、適切なチームまたはシステムに通知します。

​

復旧

イベント配信は自動的に再試行されます。詳しくは、ベストプラクティスを参照してください。

配信に失敗した場合は、Redelivery API を使用してイベント配信を再度試行できます。

​

失敗した単一のイベントを再配信する

特定の失敗したイベントを再試行するには、次を使用します。

Auth0 CLI

EVENT_ID=<your event id>
auth0 api POST event-streams/$EVENT_STREAM_ID/redeliver/$EVENT_ID --data '{}'

cURL

curl -s -X POST -H "Authorization: Bearer $TOKEN" \
  "https://<your-domain>/api/v2/event-streams/$EVENT_STREAM_ID/redeliver/$EVENT_ID"

​

失敗したイベントの一括再配信

イベントストリーム内の失敗したすべてのイベントを再試行するには、次のようにします。

Auth0 CLI

auth0 api POST event-streams/$EVENT_STREAM_ID/redeliver --data '{}'

cURL

curl -s -X POST -H "Authorization: Bearer $TOKEN" \
  "https://<your-tenant>.auth0.com/api/v2/event-streams/<event_stream_id>/redeliver"

​

自動無効化の仕組み

Auth0 は、失敗が過剰に発生した場合、イベントストリームを自動的に無効化します。

条件	実行されるアクション
500 回連続で失敗	イベントストリームは自動的に無効化されます。
合計 5000 回失敗	イベントストリームは自動的に無効化されます。

• イベントストリームが自動的に無効化された場合、失敗したイベントを処理するには、必ず Redelivery API を使用する必要があります。
• 合計失敗数が 5000 未満になるまで、イベントストリームを手動で再有効化することはできません。
• 失敗数が減ったら、API を使用してストリームを再有効化できます。

​

詳細情報

• イベントタイプ
• イベントストリームを作成する
• イベントのベストプラクティス