Amazon Simple Notification Service (SNS)

SNS ダッシュボード

概要

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

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

セットアップ

インストール

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

メトリクスの収集

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

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

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

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

イベント収集

SNS メッセージの受信

Datadog Event Stream の SNS メッセージは、HTTPS と Email の両方のプロトコルで受け取ることができます。HTTPS プロトコルを使用すると、Webhook URL で自動的にサブスクリプションを確認することができます。

Email プロトコルを使用する場合、Datadog がこの目的のために自動的に生成したメールアドレスの確認ステップを手動で行う必要があります。詳しくは Amazon SNS のメールから Datadog のイベントを作成するのガイドをお読みください。

Datadog Event Explorer で SNS メッセージを HTTPS で受信するには

  1. SNS マネジメントコンソールの Topics セクションで、目的のトピックを選択し、Create Subscription をクリックします。

  2. プロトコルとして 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>

  3. Enable raw message delivery のチェックは外したままにします。

  4. Create subscription をクリックします。

SNS 通知の送信

Datadog から SNS 通知を送信するには

  1. AWS インテグレーションページで、SNS サービスと関連付けられている AWS アカウントを構成します。
  2. SNS インテグレーションをインストールします。
  3. これで、Datadog は構成された SNS トピックを検出し、@notifications (例: @sns-topic-name) を有効にします。

ログの収集

SNS はログを提供しません。SNS に送信されるログとイベントが処理されます。

ログを Datadog に送信する方法

  1. 新しい SNS サブスクリプションを構成します。
  2. メッセージの送信元のトピックを選択します。
  3. Protocol には、AWS Lambda を選択します。
  4. 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 イベント

サービスのチェック

Amazon SNS インテグレーションには、サービスのチェック機能は含まれません。

トラブルシューティング

Datadog では、Datadog から GovCloud または 中国のトピックへの SNS 通知をサポートしていません。

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