Amazon Simple Notification Service (SNS)

Docs > インテグレーション > Amazon Simple Notification Service (SNS)

概要

Amazon Simple Notification Service (SNS) を Datadog に接続すると、次のことが可能になります。

SNS メッセージをイベントとしてストリームに表示できます。
アラートおよびイベント通知を SNS に送信できます。

セットアップ

インストール

Amazon Web Services インテグレーションをまだセットアップしていない場合は、最初にセットアップします。

メトリクスの収集

AWS インテグレーションページで、Metric Collection タブの下にある SNS が有効になっていることを確認します。

Amazon SNS のメトリクスを収集するには、次のアクセス許可を Datadog IAM ポリシーに追加します。詳細については、AWS ウェブサイト上の SNS ポリシーを参照してください。

AWS アクセス許可	説明
`sns:ListTopics`	取得可能なトピックを一覧表示するために使用されます。
`sns:Publish`	通知 (モニターまたはイベントフィード) を公開するために使用されます。

Datadog - Amazon SNS インテグレーションをインストールします。

イベント収集

Datadog Event Stream の 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 をクリックします。

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 から GovCloud または中国のトピックへの SNS 通知をサポートしていません。

ご不明な点は、Datadog のサポートチームまでお問合せください。