View a markdown version of this page

連接 DataDog - AWS DevOps 代理程式
內建的單向整合上線移除

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

連接 DataDog

內建的單向整合

目前， AWS DevOps Agent 支援具有內建的單向整合的 Datadog 使用者，啟用下列項目：

  • 自動化調查觸發 - 資料狗事件可設定為觸發透過 AWS DevOps 代理程式 Webhook 的 AWS DevOps 代理程式事件解決調查。

  • 遙測自我檢查 - AWS DevOps 代理程式可以在透過每個供應商的遠端 MCP 伺服器調查問題時自我檢查資料狗遙測。

上線

步驟 1：連線

使用帳戶存取憑證建立與 Datadog 遠端 MCP 端點的連線

組態

  1. 前往功能提供者頁面 （可從側邊導覽存取）

  2. 在遙測下的可用提供者區段中尋找 Datadog，然後選擇註冊

  3. 輸入您的 Datadog MCP 伺服器詳細資訊：

    • 伺服器名稱 - 唯一識別符 （例如 my-datadog-server)

    • 端點 URL - Datadog MCP 伺服器端點。端點 URL 會根據 Datadog 網站而有所不同。請參閱下面的 Datadog 網站端點表。

    • 描述 - 選用的伺服器描述

  4. 選擇下一步

  5. 檢閱並提交

Datadog 網站端點

MCP 端點 URL 會根據 Datadog 網站而有所不同。若要識別您的網站，請在登入 Datadog 時檢查瀏覽器中的 URL，或參閱存取 Datadog 網站。

Datadog 網站 網站網域 MCP 端點 URL
US1 （預設） datadoghq.com https://mcp.datadoghq.com/api/unstable/mcp-server/mcp
US3 us3.datadoghq.com https://mcp.us3.datadoghq.com/api/unstable/mcp-server/mcp
US5 us5.datadoghq.com https://mcp.us5.datadoghq.com/api/unstable/mcp-server/mcp
EU1 datadoghq.eu https://mcp.datadoghq.eu/api/unstable/mcp-server/mcp
AP1 ap1.datadoghq.com https://mcp.ap1.datadoghq.com/api/unstable/mcp-server/mcp
AP2 ap2.datadoghq.com https://mcp.ap2.datadoghq.com/api/unstable/mcp-server/mcp

Authorization

透過下列方式完成 OAuth 授權：

  • 在 Datadog OAuth 頁面上以您的使用者身分授權

  • 如果未登入，請選擇允許、登入，然後授權

設定完成後，Datadog 即可在所有客服人員空間中使用。

步驟 2：啟用

在特定客服人員空間中啟用 DataDog，並設定適當的範圍

組態

  1. 從客服人員空間頁面，選取客服人員空間並按下檢視詳細資訊 （如果您尚未建立客服人員空間，請參閱 建立 代理程式空間)

  2. 選取功能索引標籤

  3. 向下捲動至遙測區段

  4. 按下新增

  5. 選取 Datadog

  6. 下一頁

  7. 檢閱並按下儲存

  8. 複製 Webhook URL 和 API 金鑰 （在儲存時顯示一次；API 金鑰稍後無法檢視 - 如果您遺失它，請從功能索引標籤上的 Webhook 詳細資訊中重新產生它，這會使上一個金鑰失效）

步驟 3：設定 Webhook

使用步驟 2 的 Webhook URL 和 API 金鑰，您可以設定 Datadog 傳送觸發調查的事件，例如當監視器警示時。

Datadog Webhook 使用承載字符身分驗證。如需一般 Webhook 請求格式和承載結構描述，請參閱 透過 Webhook 叫用 DevOps 代理程式。下列各節提供ready-to-use Datadog 組態；您不需要自行建構承載。

步驟 3.1：在 Datadog 中建立 Webhook

  1. 在 Datadog 中，開啟整合、搜尋 Webhook，然後開啟整合圖磚。如需詳細資訊，請參閱 Datadog 文件中的 Webhook。

  2. 在 Webhooks 下，選擇新增。

  3. 針對名稱，輸入名稱，例如 devops-agent。您可以在監控訊息@webhook-devops-agent中將此名稱參考為 。

  4. 針對 URL，貼上步驟 2 中的 Webhook URL （可從客服人員空間功能索引標籤上的 Datadog 項目再次檢視）。

  5. 對於承載，請將預設承載取代為步驟 3.2 中的範本。

  6. 將驗證方法保持未設定狀態，並改為選取自訂標頭，然後輸入下列範例中顯示的標頭，<API_KEY_FROM_STEP_2>將 取代為步驟 2 中的 API 金鑰。

  7. 將編碼保留為表單清除。Webhook 端點需要原始 JSON 內文；形式編碼會導致承載處理失敗。

  8. 儲存 Webhook。

步驟 6 的自訂標頭值：

{"Authorization": "Bearer <API_KEY_FROM_STEP_2>"}

若要避免將金鑰儲存在純檢視中，請在 Webhook 圖磚中定義自訂變數 （例如 $DEVOPS_AGENT_API_KEY)，並選取隱藏檢視，然後改為參考標頭值中的變數。

步驟 3.2：監控觸發警示的承載範本

下列範本適用於標準監視器警示，包括指標、日誌、APM 和 Synthetics 監視器。Datadog 會在傳送 Webhook 時取代$VARIABLE預留位置；將預留位置保留為寫入狀態。

{
  "eventType": "incident",
  "incidentId": "datadog-$ALERT_CYCLE_KEY",
  "action": "created",
  "priority": "HIGH",
  "title": "$ALERT_TITLE",
  "description": "$TEXT_ONLY_MSG",
  "service": "datadog",
  "data": {
    "monitorId": "$ALERT_ID",
    "eventType": "$EVENT_TYPE",
    "alertQuery": "$ALERT_QUERY",
    "alertScope": "$ALERT_SCOPE",
    "alertMetric": "$ALERT_METRIC",
    "alertTransition": "$ALERT_TRANSITION",
    "alertPriority": "$ALERT_PRIORITY",
    "tags": "$TAGS",
    "eventUrl": "$LINK",
    "hostname": "$HOSTNAME"
  }
}

Datadog 變數如何對應至 Webhook 結構描述

Webhook 欄位 將使用的值 備註
eventType 常值字串 incident 必要常數。
incidentId datadog-$ALERT_CYCLE_KEY $ALERT_CYCLE_KEY 從監視器觸發到解決為止， 會保持不變，因此重新通知重複資料刪除為單一調查。只有在您希望每個通知開始個別調查時，才改用 $ID（每個事件 ID)。
action 常值字串 created 請勿對應$ALERT_TRANSITION至此欄位。其值 （例如 Triggered和 Recovered) 不是有效的action值。改為控制 Webhook 從監控訊息觸發的時間 （請參閱步驟 3.3)。
priority 其中一個常值字串 CRITICAL、HIGH、LOW、 MEDIUM或 MINIMAL 此處請勿使用 $ALERT_PRIORITY。它擴展到 Datadog 監控優先順序 (P1–P5)，這不是此欄位的有效值。Webhook 會傳回 200 回應，但不會開始調查。若要傳送不同的優先順序，請為每個優先順序層級建立一個 Webhook （例如， devops-agent-critical 和 devops-agent-high)，並從每個監視器參考適當的 Webhook。
title $ALERT_TITLE 監視器的提醒標題。
description $TEXT_ONLY_MSG Markdown 已分割的事件文字。優先於 $EVENT_MSG，其 Markdown 格式會增加雜訊。
service 常值服務名稱 選用。識別來源的靜態字串，例如 datadog或您的服務名稱。
timestamp 省略 選用。Datadog 的日期變數 ($DATE、$DATE_POSIX) 是 epoch 值，而不是此欄位預期的 ISO 8601 格式，因此請省略 欄位。
data Datadog 內容變數 可選，但建議使用。中的所有內容data都會做為原始事件傳遞給代理程式，為調查提供監控查詢、範圍、標籤，以及傳回 Datadog 事件的連結。

步驟 3.3：從您的監視器參考 Webhook

在警示應觸發調查的每個監視器中，將 Webhook 提及新增至監視器訊息的範圍，以便只有警示轉換會觸發它：

{{#is_alert}}
@webhook-devops-agent
{{/is_alert}}

如果沒有{{#is_alert}}條件式，警告和復原通知也會傳送 Webhook。復原事件會透過 刪除開放調查的重複資料$ALERT_CYCLE_KEY，但警告會開始調查您可能不希望調查的閾值。

驗證組態

從監視器傳送測試通知 (監視器編輯器中的測試通知)，並確認下列事項：

  1. Webhook 傳回 200 回應。您可以在 Datadog Webhook 整合的事件串流中查看交付狀態。4xx 回應表示Authorization標頭錯誤。重新檢查 API 金鑰並確認編碼為表單已清除。

  2. 調查會在您的客服人員空間中開始。（測試通知的調查會在沒有根本原因的情況下關閉，這是預期的。) 沒有調查的 200 回應表示接受承載後驗證失敗。檢查 Datadog 事件串流中的 Webhook 回應內文：無效的承載會傳回 200 回應，其內文會列出驗證錯誤 （例如，'P2' is not one of ['CRITICAL', 'HIGH', ...])，而有效的承載會傳回 {"message": "Webhook received"}。最常見的原因是非常值 （請參閱上述映射表），以及相同警示週期中先前測試incidentId的重複priority項目。

如需一般 Webhook 疑難排解，請參閱 透過 Webhook 叫用 DevOps 代理程式。

進一步了解：Datadog 遠端 MCP 伺服器

移除

遙測來源在客服人員空間層級和帳戶層級的兩個層級上連接。若要完全移除它，您必須先從使用它的所有代理程式空間中移除它，然後可以取消註冊。

步驟 1：從客服人員空間移除

  1. 從客服人員空間頁面，選取客服人員空間並按下檢視詳細資訊

  2. 選取功能索引標籤

  3. 向下捲動至遙測區段

  4. 選取 Datadog

  5. 按移除

步驟 2：從帳戶取消註冊

  1. 前往能力提供者頁面 （可從側邊導覽存取）

  2. 捲動至目前註冊的區段。

  3. 檢查客服人員空間計數為零 （如果不是在其他客服人員空間中重複上述步驟 1)

  4. 選取 Datadog，然後從動作功能表中選擇取消註冊。