Amazon CloudWatch メトリクスとログを使用した Amazon SNSSMS配信モニタリング - Amazon Simple Notification Service

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

Amazon CloudWatch メトリクスとログを使用した Amazon SNSSMS配信モニタリング

Amazon CloudWatch および Amazon CloudWatch Logs を使用して、SMSメッセージ配信をモニタリングできます。

Amazon CloudWatch メトリクスの表示

Amazon は、SMSメッセージ配信に関するメトリクスSNSを自動的に収集し、Amazon にプッシュします CloudWatch。 CloudWatch を使用して、これらのメトリクスをモニタリングし、メトリクスがしきい値を超えたときに警告するアラームを作成できます。例えば、 CloudWatch メトリクスをモニタリングして、SMS配送率と month-to-dateSMS料金を確認できます。

CloudWatch メトリクスのモニタリング、 CloudWatch アラームの設定、使用可能なメトリクスのタイプについては、「」を参照してくださいを使用した Amazon SNSトピックのモニタリング CloudWatch

CloudWatch ログの表示

Amazon が Amazon CloudWatch Logs SNS に書き込むようにすることで、成功したSMSメッセージ配信と失敗したメッセージ配信に関する情報を収集できます。送信するSMSメッセージごとに、Amazon はメッセージ料金、成功または失敗のステータス、失敗の理由 (メッセージが失敗した場合)、メッセージ滞留時間、その他の情報を含むログをSNS書き込みます。

SMS メッセージの CloudWatch ログを有効にして表示するには
  1. Amazon SNSコンソール にサインインします。

  2. コンソールメニューで、リージョンセレクタをSMSメッセージング をサポートするリージョンに設定します。

  3. ナビゲーションパネルで、テキストメッセージ (SMS) を選択します。

  4. モバイルテキストメッセージ (SMS) ページで、テキストメッセージの設定セクションで、「 の編集」を選択します。

  5. 次のページで、[Delivery status logging] セクションに追加します。

  6. 成功サンプルレート では、Amazon が CloudWatch ログにログをSNS書き込む成功SMS配信の割合を指定します。例:

    • 失敗した配信のみをログを書き込むには、この値を 0 に設定します。

    • 正常な配信の 10% に対してログを書き込むには、10 に設定します。

    パーセンテージを指定しない場合、Amazon は成功したすべての配信のログをSNS書き込みます。

  7. 必要なアクセス権限を提供するには、次のいずれかを行います。

    • 新しいサービスロールを作成するには、[新しいサービスロールの作成]を選択 し、[新しいロールの作成] を選択します。次のページで、アカウントのリソースへの Amazon SNS書き込みアクセスを許可する を選択します。

    • 既存のサービスロールを使用するには、「既存のサービスロールを使用」を選択し、IAM配信が成功および失敗したロールにARN名前を貼り付けます。

      指定するサービスロールは、アカウントのリソースへの書き込みアクセスを許可する必要があります。IAM ロールの作成の詳細については、IAM「 ユーザーガイド」の AWS 「 サービスのロールの作成」を参照してください。

  8. [Save changes] (変更の保存) をクリックします。

  9. モバイルテキストメッセージ (SMS) ページに戻り、配信ステータスログセクションに移動して、使用可能なログを表示します。

    注記

    送信先の電話番号の通信事業者によっては、配信ログが Amazon SNSコンソールに表示されるまでに最大 72 時間かかる場合があります。

SMS 配信を成功させるためのログの例

配信が成功した場合のSMS配信ステータスログは、次の例に似ています。

{ "notification": { "messageId": "34d9b400-c6dd-5444-820d-fbeb0f1f54cf", "timestamp": "2016-06-28 00:40:34.558" }, "delivery": { "phoneCarrier": "My Phone Carrier", "mnc": 270, "numberOfMessageParts": 1, "destination": "+1XXX5550100", "priceInUSD": 0.00645, "smsType": "Transactional", "mcc": 310, "providerResponse": "Message has been accepted by phone carrier", "dwellTimeMs": 599, "dwellTimeMsUntilDeviceAck": 1344 }, "status": "SUCCESS" }

失敗したSMS配信のログ例

失敗した配信のSMS配信ステータスログは次の例のようになります。

{ "notification": { "messageId": "1077257a-92f3-5ca3-bc97-6a915b310625", "timestamp": "2016-06-28 00:40:34.559" }, "delivery": { "mnc": 0, "numberOfMessageParts": 1, "destination": "+1XXX5550100", "priceInUSD": 0.00645, "smsType": "Transactional", "mcc": 0, "providerResponse": "Unknown error attempting to reach phone", "dwellTimeMs": 1420, "dwellTimeMsUntilDeviceAck": 1692 }, "status": "FAILURE" }

SMS 配信失敗の理由

失敗の理由は、providerResponse 属性で提供されます。SMS 以下の理由により、メッセージは配信されない場合があります。

  • 電話業者がスパムとしてブロック

  • 送信先がブロックリストにある

  • 無効な電話番号

  • メッセージ本文が無効

  • 電話業者がこのメッセージをブロック

  • 電話業者が現在、到達不可能/使用不可能

  • 電話がブロックされました SMS

  • 電話がブロックリストにある

  • 電話が現在、到達不可能/使用不可能

  • 電話番号はオプトアウトしている

  • この配信が上限価格を超えている

  • 電話に達する際の原因不明なエラー