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 のサポートチーム までお問合せください。