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 hal berikut:

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

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

Orientasi

Langkah 1: Hubungkan

Buat koneksi ke titik akhir MCP jarak jauh Datadog Anda dengan kredenSIAL akses akun

Konfigurasi

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

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

  3. Masukkan detail server Datadog MCP Anda:

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

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

    • Deskripsi - Deskripsi server opsional

  4. Pilih Berikutnya

  5. Tinjau dan kirimkan

Titik akhir situs Datadog

URL titik akhir 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

Lengkapi otorisasi OAuth dengan:

  • Mengotorisasi sebagai pengguna Anda di halaman OAuth Datadog

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

Setelah dikonfigurasi, Datadog menjadi tersedia di semua ruang Agen.

Setiap pendaftaran terhubung ke satu organisasi Datadog. Untuk menghubungkan organisasi Datadog tambahan, ulangi proses ini untuk masing-masing organisasi dan berikan setiap pendaftaran Nama Servernya sendiri.

Langkah 2: Aktifkan

Aktif DataDog kan di ruang Agen tertentu dan konfigurasikan pelingkupan yang sesuai

Konfigurasi

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

  2. Pilih tab Capabilities

  3. Gulir ke bawah ke bagian Telemetri

  4. Tekan Tambah

  5. Pilih pendaftaran Datadog yang ingin Anda aktifkan.

  6. Selanjutnya

  7. Tinjau dan tekan Simpan

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

Satu Ruang Agen dapat menggunakan lebih dari satu pendaftaran Datadog. Untuk menambahkan pendaftaran lain, ulangi langkah-langkah ini.

Langkah 3: Konfigurasikan webhook

Menggunakan URL Webhook dan Kunci API dari Langkah 2, Anda dapat mengonfigurasi Datadog untuk mengirim peristiwa yang memicu penyelidikan, seperti ketika monitor memperingatkan.

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

Langkah 3.1: Buat webhook di Datadog

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

  2. Di bawah Webhook, pilih Baru.

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

  4. Untuk URL, tempel 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 Header K ustom dan masukkan header yang ditunjukkan dalam contoh berikut, ganti <API_KEY_FROM_STEP_2> dengan Kunci API dari Langkah 2.

  7. Biarkan Encode sebagai formulir dibersihkan. Titik akhir webhook memerlukan 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 penyimpanan kunci dalam tampilan biasa, tentukan variabel khusus (misalnya,$DEVOPS_AGENT_API_KEY) di ubin webhook dengan Sem bunyikan dari tampilan dipilih, dan referensi variabel dalam nilai header sebagai gantinya.

Langkah 3.2: Template muatan untuk peringatan yang dipicu monitor

Template berikut berfungsi untuk peringatan monitor standar, termasuk metrik, log, APM, dan monitor 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 dipetakan ke skema webhook

Bidang Webhook Nilai untuk digunakan Catatan
eventType String literal incident Diperlukan konstan.
incidentId datadog-$ALERT_CYCLE_KEY $ALERT_CYCLE_KEYtetap sama sejak monitor dipicu hingga teratasi, jadi pemberitahuan ulang diduplikasi menjadi satu penyelidikan. Gunakan $ID (ID per peristiwa) 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) bukanlah action nilai yang valid. Kontrol kapan webhook diaktifkan dari pesan monitor sebagai gantinya (lihat Langkah 3.3).
priority Salah satu string literalCRITICAL,HIGH,MEDIUM,LOW, atau MINIMAL Jangan gunakan $ALERT_PRIORITY di sini. Ini diperluas ke prioritas monitor Datadog (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 pemformatan Markdown-nya menambah noise.
service Nama layanan literal Tidak wajib. String statis yang mengidentifikasi sumber, seperti datadog atau nama layanan Anda.
timestamp Menghilangkan Tidak wajib. Variabel tanggal Datadog ($DATE,$DATE_POSIX) adalah nilai zaman, bukan format ISO 8601 yang diharapkan bidang ini, jadi hilangkan bidang tersebut.
data Variabel konteks Datadog Opsional tetapi direkomendasikan. Semua yang data masuk diteruskan ke agen sebagai peristiwa asli, memberikan penyelidikan kueri monitor, ruang lingkup, tag, dan tautan kembali ke peristiwa Datadog.

Langkah 3.3: Referensikan webhook dari monitor Anda

Di setiap monitor yang peringatannya harus memicu penyelidikan, tambahkan penyebutan webhook ke pesan monitor, dengan cakupan sehingga hanya transisi peringatan yang menjalankannya:

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

Tanpa pemberitahuan {{#is_alert}} kondisional, peringatan dan pemulihan juga mengirim webhook. Peristiwa pemulihan mendeduplikasi terhadap penyelidikan 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 yang berikut:

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

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

Untuk pemecahan masalah webhook umum, lihatMemanggil A DevOps gen 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 spasi agen, pilih ruang agen dan tekan lihat detail

  2. Pilih tab Capabilities

  3. Gulir ke bawah ke bagian Telemetri

  4. Pilih Datadog

  5. Tekan hapus

Langkah 2: Deregister dari akun

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

  2. Gulir ke bagian Terdaftar saat ini.

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

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