アラートトリガー
アラートトリガーを使用して、エラー数が 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の存在を手短にテストすることができます。すでに存在するトークンをハンドリングし、次の適切なステップへとつなげることができます。
ヘルプが必要ですか？
誰しもが一度は考える「コーディングって難しい」。そんな時は、お問い合わせフォームから質問してください。 または、Stack Overflow でTwilioタグのついた情報から欲しいものを探してみましょう。