View a markdown version of this page

Menghubungkan DataDog - AWS DevOps Agen
Built-in, Integrasi 1 arahOrientasiPenghapusan

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Menghubungkan DataDog

Built-in, Integrasi 1 arah

Saat ini, AWS DevOps Agen mendukung pengguna Datadog dengan integrasi 1 arah bawaan, memungkinkan yang berikut:

  • Pemicu Investigasi Otomatis - Peristiwa datadog dapat dikonfigurasi untuk memicu Investigasi resolusi insiden AWS DevOps Agen melalui webhook Agen. AWS DevOps

  • Introspeksi telemetri - AWS DevOps Agen dapat mengintrospeksi telemetri Datadog saat menyelidiki masalah melalui server MCP jarak jauh masing-masing penyedia.

Orientasi

Langkah 1: Connect

Buat koneksi ke endpoint MCP jarak jauh Datadog Anda dengan kredensyal akses akun

Konfigurasi

  1. Buka halaman Penyedia Kemampuan (dapat diakses dari navigasi samping)

  2. Temukan Datadog di bagian Penyedia yang tersedia di bawah Telemetri dan pilih Daftar

  3. Masukkan detail server MCP Datadog Anda:

    • Nama Server - Pengidentifikasi unik (misalnya, my-datadog-server)

    • URL Endpoint - Titik akhir server MCP Datadog Anda. URL endpoint bervariasi tergantung pada situs Datadog Anda. Lihat tabel endpoint situs Datadog di bawah ini.

    • Deskripsi - Deskripsi server opsional

  4. Pilih Berikutnya

  5. Tinjau dan kirimkan

Titik akhir situs Datadog

URL endpoint MCP bervariasi tergantung pada situs Datadog Anda. Untuk mengidentifikasi situs Anda, periksa URL di browser Anda saat masuk ke Datadog, atau lihat Akses situs Datadog.

Situs Datadog Domain Situs URL Titik Akhir MCP
US1 (default) 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

Otorisasi

Otorisasi OAuth lengkap dengan:

  • Otorisasi sebagai pengguna Anda di halaman Datadog OAuth

  • Jika tidak masuk, pilih Izinkan, masuk, lalu otorisasi

Setelah dikonfigurasi, Datadog menjadi tersedia di semua ruang Agen.

Langkah 2: Aktifkan

Aktifkan DataDog di ruang Agen tertentu dan konfigurasikan pelingkupan yang sesuai

Konfigurasi

  1. Dari halaman spasi agen, pilih ruang agen dan tekan detail tampilan (jika Anda belum membuat ruang agen lihatMembuat Ruang Agen)

  2. Pilih tab Kemampuan

  3. Gulir ke bawah ke bagian Telemetri

  4. Tekan Tambah

  5. Pilih Datadog

  6. Selanjutnya

  7. Tinjau dan tekan Simpan

  8. Salin URL Webhook dan Kunci API (ditampilkan sekali saat disimpan; Kunci API tidak dapat dilihat nanti — jika Anda kehilangannya, buat ulang dari detail webhook di tab Capabilities, yang membatalkan kunci sebelumnya)

Langkah 3: Konfigurasikan webhooks

Menggunakan URL Webhook dan API Key dari Langkah 2, Anda dapat mengonfigurasi Datadog untuk mengirim peristiwa yang memicu investigasi, seperti saat peringatan monitor.

Webhook Datadog menggunakan otentikasi token pembawa. Untuk format permintaan webhook umum dan skema payload, lihat. Memanggil DevOps Agen melalui Webhook Bagian berikut menyediakan konfigurasi Datadog siap pakai; Anda tidak perlu membuat payload sendiri.

Langkah 3.1: Buat webhook di Datadog

  1. Di Datadog, buka Integrasi, cari Webhooks, dan buka ubin integrasi. Untuk informasi selengkapnya, lihat Webhook di dokumentasi Datadog.

  2. Di bawah Webhooks, pilih Baru.

  3. Untuk Nama, masukkan nama sepertidevops-agent. Anda mereferensikan nama ini seperti @webhook-devops-agent pada pesan monitor.

  4. Untuk URL, rekatkan URL Webhook dari Langkah 2 (dapat dilihat lagi dari entri Datadog di tab Capabilities ruang agen Anda).

  5. Untuk Payload, ganti payload default dengan template di Langkah 3.2.

  6. Biarkan Metode Auth tidak dikonfigurasi, dan sebagai gantinya pilih Custom Header dan masukkan header yang ditunjukkan pada contoh berikut, ganti <API_KEY_FROM_STEP_2> dengan Kunci API dari Langkah 2.

  7. Tinggalkan Encode sebagai formulir dihapus. Titik akhir webhook membutuhkan badan JSON mentah; pengkodean formulir menyebabkan payload gagal diproses.

  8. Simpan webhook.

Nilai header kustom untuk langkah 6:

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

Untuk menghindari menyimpan kunci dalam tampilan biasa, tentukan variabel kustom (misalnya,$DEVOPS_AGENT_API_KEY) di ubin webhook dengan Sembunyikan dari tampilan dipilih, dan rujuk variabel dalam nilai header sebagai gantinya.

Langkah 3.2: Template payload untuk peringatan yang dipicu monitor

Template berikut berfungsi untuk peringatan monitor standar, termasuk monitor metrik, log, APM, dan Synthetics. Datadog menggantikan $VARIABLE placeholder saat mengirim webhook; biarkan seperti yang tertulis.

{
  "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"
  }
}

Bagaimana variabel Datadog memetakan ke skema webhook

Bidang webhook Nilai untuk digunakan Catatan
eventType String literal incident Diperlukan konstan.
incidentId datadog-$ALERT_CYCLE_KEY $ALERT_CYCLE_KEYtetap sama dari saat monitor dipicu hingga selesai, jadi notifikasi ulang dihilangkan duplikat menjadi satu penyelidikan. Gunakan $ID (ID per acara) sebagai gantinya hanya jika Anda ingin setiap pemberitahuan memulai penyelidikan terpisah.
action String literal created Jangan memetakan $ALERT_TRANSITION ke bidang ini. Nilai-nilainya (seperti Triggered danRecovered) bukan action nilai yang valid. Kontrol saat webhook menyala dari pesan monitor sebagai gantinya (lihat Langkah 3.3).
priority Salah satu string literalCRITICAL,,HIGH, MEDIUMLOW, atau MINIMAL Jangan gunakan $ALERT_PRIORITY di sini. Ini meluas ke Datadog memantau prioritas (P1-P5), yang bukan nilai yang valid untuk bidang ini. Webhook mengembalikan respons 200, tetapi tidak ada penyelidikan yang dimulai. Untuk mengirim prioritas yang berbeda, buat satu webhook per tingkat prioritas (misalnya, devops-agent-critical dandevops-agent-high) dan referensi webhook yang sesuai dari setiap monitor.
title $ALERT_TITLE Judul peringatan monitor.
description $TEXT_ONLY_MSG Teks acara dengan Markdown dilucuti. Lebih suka ini daripada$EVENT_MSG, yang format Markdown-nya menambah noise.
service Nama layanan literal Tidak wajib. String statis yang mengidentifikasi sumber, seperti datadog atau nama layanan Anda.
timestamp Hilangkan Tidak wajib. Variabel tanggal Datadog ($DATE,$DATE_POSIX) adalah nilai epoch, bukan format ISO 8601 yang diharapkan bidang ini, jadi hilangkan bidangnya.
data Variabel konteks datadog Opsional tetapi direkomendasikan. Semua yang data ada di diteruskan ke agen sebagai acara asli, memberikan penyelidikan permintaan monitor, ruang lingkup, tag, dan tautan kembali ke acara Datadog.

Langkah 3.3: Referensikan webhook dari monitor Anda

Di setiap monitor yang peringatannya harus memicu penyelidikan, tambahkan penyebutan webhook ke pesan monitor, dicakup sehingga hanya transisi peringatan yang mengaktifkannya:

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

Tanpa pemberitahuan {{#is_alert}} bersyarat, peringatan dan pemulihan juga mengirim webhook. Peristiwa pemulihan mengalami deduplikasi terhadap investigasi terbuka$ALERT_CYCLE_KEY, tetapi peringatan memulai penyelidikan untuk ambang batas yang mungkin tidak ingin Anda selidiki.

Verifikasi konfigurasi

Kirim pemberitahuan pengujian dari monitor (Pemberitahuan Uji di editor monitor) dan konfirmasikan hal berikut:

  1. Webhook mengembalikan respons 200. Anda dapat melihat status pengiriman di aliran acara integrasi webhook Datadog. Respons 4xx berarti Authorization header salah. Re-check Kunci API dan konfirmasikan bahwa Encode sebagai formulir dihapus.

  2. Investigasi dimulai di Ruang Agen Anda. (Investigasi pemberitahuan pengujian ditutup tanpa akar penyebab — itu yang diharapkan.) Tanggapan 200 tanpa investigasi berarti payload gagal validasi setelah diterima. Periksa badan respons webhook di aliran peristiwa Datadog: muatan yang tidak valid mengembalikan respons 200 yang badannya mencantumkan kesalahan validasi (misalnya,'P2' is not one of ['CRITICAL', 'HIGH', ...]), sementara muatan yang valid kembali. {"message": "Webhook received"} Penyebab paling umum adalah priority nilai non-literal (lihat tabel pemetaan sebelumnya) dan duplikat incidentId dari tes sebelumnya dalam siklus peringatan yang sama.

Untuk pemecahan masalah webhook umum, lihat. Memanggil DevOps Agen melalui Webhook

Pelajari lebih lanjut: Datadog Remote MCP Server

Penghapusan

Sumber telemetri terhubung pada dua tingkat di tingkat ruang agen dan di tingkat akun. Untuk menghapusnya sepenuhnya, Anda harus terlebih dahulu menghapus dari semua ruang agen tempat ia digunakan dan kemudian dapat tidak terdaftar.

Langkah 1: Hapus dari ruang agen

  1. Dari halaman ruang agen, pilih ruang agen dan tekan detail tampilan

  2. Pilih tab Kemampuan

  3. Gulir ke bawah ke bagian Telemetri

  4. Pilih Datadog

  5. Tekan hapus

Langkah 2: Deregister dari akun

  1. Buka halaman Penyedia Kemampuan (dapat diakses dari navigasi samping)

  2. Gulir ke bagian Saat ini terdaftar.

  3. Periksa jumlah ruang agen adalah nol (jika tidak ulangi Langkah 1 di atas di ruang agen Anda yang lain)

  4. Pilih Datadog, lalu pilih Deregister dari menu Actions.