概要
StackPulse インテグレーションは、Datadog のアラートに応答する形で自動プレイブックをトリガーし、アラートの強化、インシデントの軽減、そしてコラボレーションをサポートします。トリガー後は実行中のプレイブックから直接、イベントを Datadog のイベントストリームと専用の StackPulse ダッシュボードに返送することができます。
セットアップ
このインテグレーションを設定するには、アクティブな StackPulse アカウントと、そのアカウント所有者のロールが必要です。また、Datadog の適切な管理者権限も必要となります。
StackPulse
Monitoring 下の Integrations ページで、Datadog カードにアクセスして New をクリックします。
インテグレーションに意味のある名前を入力し、Add をクリックします。
新規作成した Webhook エンドポイントをコピーします。
Datadog
Integrations に移動して Webhooks カードを選択します。
New をクリックして新しい Webhook インテグレーションを追加します。
新しい Webhook インテグレーションの名前 (特定の Datadog モニターで StackPulse をトリガーするために後に使用します) と、ひとつ前のステップで確認した Webhook の URL を入力します。
StackPulse は以下のコンフィギュレーションの一部を使用してアラート情報を追加し、ペイロードを拡張することを推奨しています。
{
"body": "$EVENT_MSG",
"title": "$EVENT_TITLE",
"date": "$DATE",
"id": "$ID",
"metadata": {
"AGGREG_KEY": "$AGGREG_KEY",
"ALERT_CYCLE_KEY": "$ALERT_CYCLE_KEY",
"ALERT_ID": "$ALERT_ID",
"ALERT_METRIC": "$ALERT_METRIC",
"ALERT_QUERY": "$ALERT_QUERY",
"ALERT_SCOPE": "$ALERT_SCOPE",
"ALERT_STATUS": "$ALERT_STATUS",
"ALERT_TITLE": "$ALERT_TITLE",
"ALERT_TRANSITION": "$ALERT_TRANSITION",
"ALERT_TYPE": "$ALERT_TYPE",
"EMAIL": "$EMAIL",
"EVENT_MSG": "$EVENT_MSG",
"EVENT_TITLE": "$EVENT_TITLE",
"EVENT_TYPE": "$EVENT_TYPE",
"HOSTNAME": "$HOSTNAME",
"ID": "$ID",
"LAST_UPDATED": "$LAST_UPDATED",
"LINK": "$LINK",
"METRIC_NAMESPACE": "$METRIC_NAMESPACE",
"ORG_ID": "$ORG_ID",
"ORG_NAME": "$ORG_NAME",
"PRIORITY": "$PRIORITY",
"SNAPSHOT": "$SNAPSHOT",
"TAGS": "$TAGS",
"TEXT_ONLY_MSG": "$TEXT_ONLY_MSG",
"USER": "$USER",
"USERNAME": "$USERNAME",
"LOGS_SAMPLE": "$LOGS_SAMPLE"
}
}
StackPulse プレイブックをトリガーするモニターを選択し、Alert Your Team フィールドに新規作成した Webhook インテグレーションへの参照を追加します。詳しくはモニターの管理を参照してください。
Integrations -> APIs に移動して API Keys カードを選択します。New API Key 下で新しいキーに対して意味のある名前を入力し、Create API Key をクリックした後に新しいキーをコピーします。
StackPulse での追加設定
Secrets 下の Integrations ページで Datadog API Keys カードにアクセスし、Add をクリックします。
インテグレーションに意味のある名前を入力し、Add をクリックします。
収集データ
メトリクス
StackPulse インテグレーションは、メトリクスを提供しません。
イベント
StackPulse インテグレーションでは、Datadog ポストイベントステップを使用して Datadog のイベントストリームにイベントを送信することができます。このステップをプレイブックと併用し、問題の軽減に成功した場合や実行に失敗した場合に Datadog に通知したり、加工したアラートデータを Datadog に返送することもできます。
サービスチェック
StackPulse インテグレーションには、サービスのチェック機能は含まれません。
トラブルシューティング
ご不明な点は、Datadog のサポートチームまでお問い合わせください。