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 |
Each of the metrics retrieved from AWS is assigned the same tags that appear in the AWS console, including but not limited to host name, security-groups, and more.
AWS から取得される各メトリクスには、ホスト名やセキュリティ グループなど、AWS コンソールに表示されるのと同じタグが割り当てられます。
イベント
Amazon SNS インテグレーションには、トピックサブスクリプションのイベントが含まれます。下のイベント例を参照してください。
サービスのチェック
Amazon SNS インテグレーションには、サービスのチェック機能は含まれません。
トラブルシューティング
Datadog では、Datadog から中国のトピックへの SNS 通知をサポートしていません。
ご不明な点は、Datadog のサポートチームまでお問合せください。
