アラートトリガー
アラートトリガーを使用して、エラー数が 1 日、1 ヶ月、または 1 年あたりのしきい値を超えたときに、webhook 経由で通知を受けることができます。コンソールのデベロッパーセンターで、アラートトリガーを作成および設定できます。
たとえば、1 日の最初のエラーまたは 100 件目のエラーが発生したときにアラートトリガーに webhook を送信するように、アラートトリガーを設定できます。さらに、特定のエラーコードが発生した場合にさらにきめ細かく監視できるように、トリガーを設定できます。
エラー数が TriggerValue
を超えたらすぐにトリガーが発動し、Twilio は非同期の HTTP リクエストをアラートトリガーの webhook URL に送信します。このリクエストは一般的にしきい値を超えて 1 分以内に送信されます。
リクエストパラメーター
下記のパラメーターはTwilioによってApp Monitor Trigger URLに渡されます。
パラメーター | 概要 |
---|---|
AccountSid | ユーザーの Twilio アカウント ID です。アカウント ID は 34 文字で、必ず AC から始まります。 |
AppMonitorTriggerSid | 発動された App Monitorトリガーを特定するユニークなSID |
DateFired | App Monitorトリガーが発動された時間、UTC時間。 |
TimePeriod | トリガーがエラーをカウントする時間の期間はdaily 、monthly 、yearly です。例として、日のTimePeriod を設定した場合、エラーカウントは毎日リセットされます。時間周期はUTCです。 |
Log | エントリーに記載されたログレベル。0 はERROR 。1 はWARNING です。 |
ErrorCode | エラーの状態を示すユニークなエラー コードです。 Twilio の エラー コード リファレンスで、エラーとその原因や解決策を調べることができます。 |
概要 | トリガーが観測された時のエラーの記述。 |
TriggerValue | App Monitorトリガーが発動された時のエラー数 |
CurrentValue | App Monitorトリガーが監視する指定期間(日、月、年)で定義されたエラー数。 |
IdempotencyToken | Twilioが発行知ったランダムなトークン。特定のApp Monitorが発動された時のユニーク性は保証されいます。App Monitor Trigger Webhookのベストプラクティスを御覧ください。 |
App Monitor Trigger Webhook のベストプラクティス
アラートトリガー URL ハンドラーを実装する際、HTTP リクエストを複数回受信する可能性があることを考慮します。重複するリクエストを処理して同じレスポンスを返すサービスは冪等(べきとう)と呼ばれます。Twilio は IdempotencyToken
を用意しており、それぞれの App Monitor Trigger webhook リクエストのユニーク性を保証します。
例として daily
の 利用上限トリガー IdempotencyToken
が 2012-10-04に発動しています。
ACed70abd024d3f57a4027b5dc2ca88d5b-FIRES-ATc142bed7b38c4f8186ef41a309814fd2-2013-10-04
IdempotencyToken
をトラックすることにより、あなたのサービスで適切にリクエストをハンドリングでき2度実行することを防ぐことができます。例として、App Monitor Triggerはアプリケーションから必要な人間にアラートの通知を送ることができます。複数の渓谷を送っていないことを確認できます。
冪等を持ったサービスをテストして実装できます。アプリケーションロジックで実行する前にIdempotencyToken
の存在を手短にテストすることができます。すでに存在するトークンをハンドリングし、次の適切なステップへとつなげることができます。
ヘルプが必要ですか?
We all do sometimes; code is hard. Get help now from our support team, or lean on the wisdom of the crowd by visiting Twilio's Stack Overflow Collective or browsing the Twilio tag on Stack Overflow.