Azure Web Apps に配置した ASP.NET Web アプリで、捕捉されない例外が発生したら、メールで通知を受け取る

Azure Web Apps での捕捉されない例外

前回の投稿で、Microsoft Azure Web Apps (旧称 Websites) に配置した ASP.NET Web アプリにおいて、捕捉されない例外発生時のログ記録について取り上げた。

標準のログ記録だと発生時刻が UTC で記録されて閲覧性能が低いとか、referer と user agent がわからないなどの課題を残しつつ、Diagnostics as a Service for Azure Web Sites という拡張機能であるとか、ELMAH はどうだ、などの情報をお寄せいただいた。

さて、実はまだ、諸事情により Diagnostics as a Service for Azure Web Sites と ELMAH の評価・確認はできていないのだが、先に、タイトルのとおり、例外発生時の通知メールを受け取る方法について触れておく。

HTTP Server Error が発生したらメールで通知

Azure Web Apps には「アラート」と呼ばれる機能がある。
このアラート機能は、応答時間や CPU 使用率、データ転送量等々といった各種計測結果に閾値を設定した「アラートルール」を作成しておき、その「アラートルール」の閾値を超えた時に通知を送ることができる、という機能だ。

「HTTP ステータス 500番台が1回以上発生したら通知」というアラートルールを設けておくことで、"ASP.NET での例外発生" を通知メールにて受信できるという寸法である。

設定手順

以下に設定手順を記そう。

まずは Microsoft Azure の新ポータルサイトにサインイン。
目的の Web App のブレードまで開く。

ブレードの中を探すと「アラート ルール」というアイコンがあるのでこれをクリック。
アラートルールのブレードが開く。
続けてアラートブレードの「アラートの追加」ボタンをクリックすると「アラートルールの追加」ブレードが開く。
今回の目的は、"捕捉されない例外" が発生したとき、すなわち HTTP server Error 5xx が発生したときにメールで通知させることなので、アラート対象はメトリック、かつ、メトリックの対象は「Http Server Errors」を選んでおく。

続けて、条件に「以上」、しきい値に「1」を設定。
ここまでで、HTTP 5xx の発生、すなわち ASP.NET Web アプリにおける捕捉されない例外の発生により、このアラートルールが該当することとなる。

最後に「サービスの管理者/共同管理者に電子メールを送信」のチェックを入れておくことで、このアラートルールに該当した際に、この Azure サブスクリプションの管理者及び共同管理者のメールアドレスに宛てて、メールによる通知を受け取れるようになる。

あるいは「サービスの管理者/共同管理者に電子メールを送信」チェックとは別に、「追加する管理者の電子メール」のテキストボックス欄に、メールアドレスを即値で入れておくことでも、そのメアドで通知を受け取ることが可能だ。

以上の設定を済ませておくことで、アラートルールの該当発生時に、メールによる通知が送信される（下図は HTTP 5xx 系ではなく、HTTP 404 のアラートルールを作成して、それに該当したときの通知メールだが、HTTP 5xx 系の通知もほぼ同じ体裁のメールが通知される）。

まとめ

Azure Web Apps のアラート機能は、必ずしも "捕捉されない例外" 発生の通知のためだけに使うものではないが、アラート機能はそのような用途にも使う・使えるということである。

このように、Azure Web Apps のアラート機能によって HTTP 5xx なエラーの発生をメール通知で準リアルタイムで受け取ることにより、利用者からの苦情が殺到する・もしくは苦情を申し立てるのも億劫でそのまま利用をやめてしまう、といった状況をより未然に防ぐ・より早く解消する・より小さく抑えることができるものと思われる。