Mengkonfigurasi Pengembang Amazon Q Datadog plugin

Datadog adalah platform pemantauan dan keamanan yang menyediakan infrastruktur, aplikasi, dan pemantauan dan analitik jaringan. Jika Anda menggunakan Datadog untuk memantau AWS aplikasi Anda, Anda dapat menggunakan Datadog plugin di obrolan Pengembang Amazon Q untuk mengakses informasi pemantauan tanpa meninggalkan AWS Management Console.

Anda dapat menggunakan Datadog Plugin untuk mempelajari Datadog, pahami cara kerjanya dengan AWS layanan, dan tanyakan tentang Anda Datadog kasing dan monitor. Setelah Anda menerima tanggapan, Anda dapat mengajukan pertanyaan tindak lanjut, termasuk cara mengatasi masalah atau untuk detail tentang Datadog sumber daya.

Untuk mengkonfigurasi plugin, Anda memberikan kredensi otentikasi dari Datadog akun untuk mengaktifkan koneksi antara Amazon Q dan Datadog. Setelah Anda mengkonfigurasi plugin, Anda dapat mengakses Datadog metrik dengan menambahkan @datadog ke awal pertanyaan Anda di obrolan Amazon Q.

Awas

Datadog izin pengguna tidak terdeteksi oleh Datadog Plugin di Amazon Q. Ketika administrator mengkonfigurasi Datadog plugin di AWS akun, pengguna dengan izin plugin di akun itu memiliki akses ke sumber daya apa pun di Datadog akun dapat diambil oleh plugin.

Anda dapat mengonfigurasi kebijakan IAM untuk membatasi plugin mana yang dapat diakses pengguna. Untuk informasi selengkapnya, lihat Konfigurasikan izin pengguna.

Prasyarat

Tambahkan izin

Untuk mengkonfigurasi plugin, izin tingkat administrator berikut diperlukan:

• Izin untuk mengakses konsol Pengembang Amazon Q. Untuk contoh kebijakan IAM yang memberikan izin yang diperlukan, lihat. Izinkan administrator menggunakan konsol Pengembang Amazon Q

• Izin untuk mengkonfigurasi plugin. Untuk contoh kebijakan IAM yang memberikan izin yang diperlukan, lihat. Izinkan administrator untuk mengkonfigurasi plugin

Memperoleh kredensi

Sebelum Anda mulai, perhatikan informasi berikut dari Datadog akun. Kredensi otentikasi ini akan disimpan secara AWS Secrets Manager rahasia saat Anda mengkonfigurasi plugin.

• URL situs — URL dari Datadog situs yang Anda gunakan. Misalnya, https://us3.datadoghq.com. Untuk informasi selengkapnya, lihat Memulai Datadog Situs di Datadog dokumentasi.

• Kunci API dan kunci aplikasi - Kunci akses yang memungkinkan Amazon Q memanggil Datadog API untuk mengakses peristiwa dan metrik. Anda dapat menemukannya di Pengaturan Organisasi di Datadog akun. Untuk informasi selengkapnya, lihat API dan Kunci Aplikasi di Datadog dokumentasi.

Rahasia dan peran layanan

AWS Secrets Manager rahasia

Saat Anda mengonfigurasi plugin, Amazon Q menciptakan AWS Secrets Manager rahasia baru untuk Anda simpan Datadog kredensi otentikasi. Atau, Anda dapat menggunakan rahasia yang ada yang Anda buat sendiri.

Jika Anda membuat rahasia sendiri, pastikan itu menyertakan kredensil berikut dan menggunakan format JSON berikut:

{ 
   "ApiKey": "<your-api-key>", 
   "AppKey": "<your-applicaiton-key>" 
}

Untuk informasi selengkapnya tentang membuat rahasia, lihat Membuat rahasia di Panduan AWS Secrets Manager Pengguna.

Peran layanan

Untuk mengkonfigurasi Datadog Plugin di Amazon Q Developer, Anda perlu membuat peran layanan yang memberikan izin Amazon Q untuk mengakses rahasia Secrets Manager Anda. Amazon Q mengasumsikan peran ini untuk mengakses rahasia di mana Anda Datadog kredensi disimpan.

Saat Anda mengonfigurasi plugin di AWS konsol, Anda memiliki opsi untuk membuat rahasia baru atau menggunakan yang sudah ada. Jika Anda membuat rahasia baru, peran layanan terkait dibuat untuk Anda. Jika Anda menggunakan rahasia yang ada dan peran layanan yang ada, pastikan peran layanan Anda berisi izin berikut, dan terlampir kebijakan kepercayaan berikut. Peran layanan yang diperlukan tergantung pada metode enkripsi rahasia Anda.

Jika rahasia Anda dienkripsi dengan kunci KMS AWS terkelola, peran layanan IAM berikut diperlukan:

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "secretsmanager:GetSecretValue"
            ],
            "Resource": [
                "arn:aws:secretsmanager:{{your-region}}:{{your-account-id}}:secret:[[secret-id]]"
            ]
        }
    ]
}

Jika rahasia Anda dienkripsi dengan AWS KMS kunci yang dikelola pelanggan, peran layanan IAM berikut diperlukan:

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "secretsmanager:GetSecretValue"
            ],
            "Resource": "arn:aws:secretsmanager:{{region}}:{{accountId}}:secret:{{secretId}}"
        },
        {
            "Effect": "Allow",
            "Action": [
                "kms:Decrypt"
            ],
            "Resource": "arn:aws:kms:{{region}}:{{accountId}}:key/{{keyId}}",
            "Condition": {
                "StringEquals": {
                    "kms:ViaService": "secretsmanager.{{region}}.amazonaws.com"
                }
            }
        }
    ]
}

Untuk mengizinkan Amazon Q mengambil peran layanan, peran layanan memerlukan kebijakan kepercayaan berikut:

catatan

codewhispererAwalan adalah nama lama dari layanan yang digabungkan dengan Amazon Q Developer. Untuk informasi selengkapnya, lihat Ganti nama Pengembang Amazon Q - Ringkasan perubahan.

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": {
        "Service": "q.amazonaws.com"
      },
      "Action": ["sts:AssumeRole", "sts:SetContext"],
      "Condition": {
        "StringEquals": {
          "aws:SourceAccount": "{{accountId}}",
          "aws:SourceArn": "arn:aws:codewhisperer:{{region}}:{{accountId}}:profile/{{profileId}}"
        }
      }
    }
  ]
}

Untuk informasi selengkapnya tentang peran layanan, lihat Membuat peran untuk mendelegasikan izin ke AWS layanan di AWS Identity and Access Management Panduan Pengguna.

Konfigurasikan Datadog plugin

Anda mengonfigurasi plugin di konsol Pengembang Amazon Q. Amazon Q menggunakan kredensil yang disimpan AWS Secrets Manager untuk mengaktifkan interaksi dengan Datadog.

Untuk mengkonfigurasi Datadog plugin, selesaikan prosedur berikut:

1. Buka konsol Pengembang Amazon Q di https://console.aws.amazon.com/amazonq/pengembang/rumah

2. Di halaman beranda konsol Pengembang Amazon Q, pilih Pengaturan.

3. Di bilah navigasi, pilih Plugin.

4. Pada halaman plugin, pilih tanda plus pada Datadogpanel. Halaman konfigurasi plugin terbuka.

5. Untuk URL Situs, masukkan URL Datadog situs yang Anda gunakan.

6. Untuk Konfigurasi AWS Secrets Manager, pilih Buat rahasia baru atau Gunakan rahasia yang ada. Rahasia Secrets Manager adalah tempat Anda Datadog kredensi otentikasi akan disimpan.

   Jika Anda membuat rahasia baru, masukkan informasi berikut:

   1. Untuk Datadog Kunci API, masukkan kunci API untuk Anda Datadog organisasi.

   2. Untuk Datadog kunci aplikasi, masukkan kunci aplikasi untuk Anda Datadog akun.

   3. Peran layanan akan dibuat yang akan digunakan Amazon Q untuk mengakses rahasia tempat Anda Datadog kredensi disimpan. Jangan mengedit peran layanan yang dibuat untuk Anda.

   Jika Anda menggunakan rahasia yang ada, pilih rahasia dari menu dropdown AWS Secrets Manager rahasia. Rahasianya harus mencakup Datadog kredensi otentikasi yang ditentukan pada langkah sebelumnya.

   Untuk informasi selengkapnya tentang kredensil yang diperlukan, lihat. Memperoleh kredensi

7. Untuk Mengonfigurasi peran layanan AWS IAM, pilih Buat peran layanan baru atau Gunakan peran layanan yang ada.

   catatan

   Jika Anda memilih Buat rahasia baru untuk langkah 6, Anda tidak dapat menggunakan peran layanan yang ada. Peran baru akan dibuat untuk Anda.

   Jika Anda membuat peran layanan baru, peran layanan akan dibuat yang akan digunakan Amazon Q untuk mengakses rahasia tempat Anda Datadog kredensi disimpan. Jangan mengedit peran layanan yang dibuat untuk Anda.

   Jika Anda menggunakan peran layanan yang ada, pilih peran dari menu tarik-turun yang muncul. Pastikan peran layanan Anda memiliki izin dan kebijakan kepercayaan yang ditentukan. Peran layanan

8. Pilih Simpan konfigurasi.

9. Setelah Datadog panel plugin muncul di bagian Plugin yang dikonfigurasi pada halaman Plugin, pengguna akan memiliki akses ke plugin.

Jika Anda ingin memperbarui kredensi untuk sebuah plugin, Anda harus menghapus plugin Anda saat ini dan mengkonfigurasi yang baru. Menghapus plugin menghapus semua spesifikasi sebelumnya. Setiap kali Anda mengkonfigurasi plugin baru, plugin ARN baru dihasilkan.

Konfigurasikan izin pengguna

Untuk menggunakan plugin, izin berikut diperlukan:

• Izin untuk mengobrol dengan Amazon Q di konsol. Untuk contoh kebijakan IAM yang memberikan izin yang diperlukan untuk mengobrol, lihat. Izinkan pengguna untuk mengobrol dengan Amazon Q

• q:UsePluginIzin.

Saat Anda memberikan akses identitas IAM ke konfigurasi Datadog plugin, identitas memperoleh akses ke sumber daya apa pun di Datadog akun dapat diambil oleh plugin. Datadog izin pengguna tidak terdeteksi oleh plugin. Jika Anda ingin mengontrol akses ke plugin, Anda dapat melakukannya dengan menentukan plugin ARN dalam kebijakan IAM.

Setiap kali Anda membuat atau menghapus dan mengkonfigurasi ulang plugin, itu diberi ARN baru. Jika Anda menggunakan plugin ARN dalam kebijakan, itu perlu diperbarui jika Anda ingin memberikan akses ke plugin yang baru dikonfigurasi.

Untuk menemukan Datadog plugin ARN, buka halaman Plugin di konsol Pengembang Amazon Q dan pilih yang dikonfigurasi Datadog plugin. Pada halaman detail plugin, salin plugin ARN. Anda dapat menambahkan ARN ini ke kebijakan untuk mengizinkan atau menolak akses ke Datadog plugin.

Jika Anda membuat kebijakan untuk mengontrol akses Datadog plugin, Datadog tentukan nama plugin dalam kebijakan.

Untuk contoh kebijakan IAM yang mengontrol akses plugin, lihatIzinkan pengguna untuk mengobrol dengan plugin dari satu penyedia.

Mengobrol dengan Datadog plugin

Untuk menggunakan Datadog plugin, masukkan @datadog di awal pertanyaan tentang Datadog atau monitor dan kasing AWS aplikasi Anda. Menindaklanjuti pertanyaan atau tanggapan atas pertanyaan dari Amazon Q juga harus disertakan@datadog.

Berikut adalah beberapa contoh kasus penggunaan dan pertanyaan terkait yang dapat Anda tanyakan untuk mendapatkan hasil maksimal dari Amazon Q Datadog plugin:

• Pelajari tentang menggunakan Datadog fitur dalam AWS beban kerja Anda - Tanyakan tentang caranya Datadog fitur bekerja dengan AWS layanan tertentu. Amazon Q mungkin meminta Anda untuk informasi lebih lanjut tentang apa yang Anda coba lakukan untuk memberikan jawaban terbaik.

  • @datadog how do I use APM on EC2?

• Mengambil dan meringkas kasus dan monitor — Tanyakan tentang kasus atau monitor tertentu, atau tentukan properti untuk mendapatkan informasi tentang monitor dan kasus seperti tanggal pembuatan, status, atau penulis. Untuk informasi selengkapnya tentang properti, lihat Properti di Datadog dokumentasi.

  • @datadog summarize the global outage case

  • @datadog summarize my top cases

• Periksa monitor yang berada dalam keadaan alarm - Tanyakan Amazon Q Datadog plugin untuk menemukan monitor AWS aplikasi Anda yang dalam alarm. Anda dapat menindaklanjuti dengan pertanyaan tentang monitor yang dicantumkannya.

  • @datadog what monitors are in alarm?

  • @datadog what is the status for monitor <monitor ID>?