Amazon Simple Notification Service (SNS)
概要
Amazon Simple Notification Service (SNS) を Datadog に接続すると、次のことが可能になります。
- SNS メッセージをイベントとして Event Explorer に表示できます。
- アラートおよびイベント通知を SNS に送信できます。
セットアップ
インストール
Amazon Web Services インテグレーションをまだセットアップしていない場合は、最初にセットアップします。
メトリクスの収集
AWS インテグレーションページで、Metric Collection
タブの下にある SNS
が有効になっていることを確認します。
Amazon SNS のメトリクスを収集するには、次のアクセス許可を Datadog IAM ポリシーに追加します。詳細については、AWS ウェブサイト上の SNS ポリシーを参照してください。
AWS アクセス許可 | 説明 |
---|
sns:ListTopics | 取得可能なトピックを一覧表示するために使用されます。 |
sns:Publish | 通知 (モニターまたはイベントフィード) を公開するために使用されます。 |
Datadog - Amazon SNS インテグレーションをインストールします。
イベント収集
SNS メッセージの受信
Datadog Event Explorer の SNS メッセージは、HTTPS
と Email
の両方のプロトコルで受け取ることができます。HTTPS
プロトコルを使用すると、Webhook URL で自動的にサブスクリプションを確認することができます。
Email
プロトコルを使用する場合、Datadog がこの目的のために自動的に生成したメールアドレスの確認ステップを手動で行う必要があります。詳しくは Amazon SNS のメールから Datadog のイベントを作成するのガイドをお読みください。
Datadog Event Explorer で SNS メッセージを HTTPS
で受信するには
SNS マネジメントコンソールの Topics セクションで、目的のトピックを選択し、Create Subscription をクリックします。
プロトコルとして HTTPS
を選択し、<API_KEY>
を有効な Datadog API キーの値に置き換えて、以下の Webhook URL を入力します。
## Datadog US site
https://app.datadoghq.com/intake/webhook/sns?api_key=<API_KEY>
## Datadog EU site
https://app.datadoghq.eu/intake/webhook/sns?api_key=<API_KEY>
Enable raw message delivery のチェックは外したままにします。
Create subscription をクリックします。
SNS 通知の送信
Datadog から SNS 通知を送信するには
- AWS インテグレーションページで、SNS サービスと関連付けられている AWS アカウントを構成します。
- SNS インテグレーションをインストールします。
- これで、Datadog は構成された SNS トピックを検出し、@notifications (例:
@sns-topic-name
) を有効にします。
ログの収集
SNS はログを提供しません。SNS に送信されるログとイベントが処理されます。
ログを Datadog に送信する方法
- 新しい SNS サブスクリプションを構成します。
- メッセージの送信元のトピックを選択します。
- Protocol には、AWS Lambda を選択します。
- Endpoint には、Datadog Forwarder Lambda 関数の ARN を入力します。
収集データ
メトリクス
aws.sns.dwell_time (gauge) | Time waited by a message before it was delivered. Shown as millisecond |
aws.sns.number_of_messages_published (count) | Number of messages published. Shown as message |
aws.sns.number_of_notifications_delivered (count) | Number of messages successfully delivered. Shown as message |
aws.sns.number_of_notifications_failed (count) | Number of messages that SNS failed to deliver. Shown as message |
aws.sns.number_of_notifications_filtered_out (count) | The number of messages that were rejected by subscription filter policies. A filter policy rejects a message when the message attributes don't match the policy attributes. Shown as message |
aws.sns.number_of_notifications_filtered_out_invalid_attributes (count) | The number of messages that were rejected by subscription filter policies because the messages have no attributes. Shown as message |
aws.sns.number_of_notifications_filtered_out_no_message_attributes (count) | The number of messages that were rejected by subscription filter policies. A filter policy rejects a message when the message attributes don't match the policy attributes. Shown as message |
aws.sns.publish_size (gauge) | Size of messages published. Shown as byte |
aws.sns.smssuccess_rate (gauge) | The percentage of successfully delivered sms. Shown as percent |
AWS から取得される各メトリクスには、ホスト名やセキュリティ グループなど、AWS コンソールに表示されるのと同じタグが割り当てられます。
イベント
Amazon SNS インテグレーションには、トピックサブスクリプションのイベントが含まれます。下のイベント例を参照してください。
サービスのチェック
Amazon SNS インテグレーションには、サービスのチェック機能は含まれません。
トラブルシューティング
Datadog では、Datadog から中国のトピックへの SNS 通知をサポートしていません。
ご不明な点は、Datadog のサポートチームまでお問合せください。