View a markdown version of this page

Log dan Metrik Terjual - AWS DevOps Agen

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

Log dan Metrik Terjual

Anda dapat memantau ruang agen dan operasi layanan Anda dengan menggunakan CloudWatch metrik dan log Amazon yang dijual. Topik ini menjelaskan CloudWatch metrik yang secara otomatis diterbitkan AWS DevOps Agen ke akun Anda dan log vended yang dapat Anda konfigurasikan untuk pengiriman ke tujuan pilihan Anda.

Metrik yang dijual CloudWatch

AWS DevOps Agen secara otomatis menerbitkan metrik ke Amazon CloudWatch di akun Anda. Metrik ini tersedia tanpa konfigurasi apa pun. Anda dapat menggunakannya untuk memantau penggunaan, melacak aktivitas operasional, dan membuat alarm.

peran tertaut layanan

Agar CloudWatch metrik Amazon dipublikasikan di akun Anda untuk layanan ini, AWS DevOps Agen akan secara otomatis membuat peran terkait layanan AWSServiceRoleForAIDevOps Peran Tertaut Layanan untuk Anda. Jika peran IAM yang menjalankan API tidak memiliki izin yang sesuai, pembuatan sumber daya akan gagal dengan file. InvalidParameterException

penting

Pelanggan yang membuat AgentSpace sebelum 13 Maret 2026 harus membuat Peran Tertaut Layanan AWSServiceRoleForAIDevOps secara manual agar CloudWatch metrik AWS DevOps Agen dipublikasikan di akun mereka.

Buat Peran Tertaut Layanan Secara Manual (Untuk pelanggan yang sudah ada)

Lakukan salah satu tindakan berikut:

  • Di konsol IAM, buat peran AWSServiceRoleForAIDevOps di bawah layanan AWS DevOps Agen.

  • Dari AWS CLI, jalankan perintah berikut:

aws iam create-service-linked-role --aws-service-name aidevops.amazonaws.com

Namespace

Semua metrik diterbitkan di bawah AWS/AIDevOps namespace.

Dimensi

Semua metrik mencakup dimensi berikut.

Dimensi Deskripsi
AgentSpaceUUID Pengidentifikasi unik dari ruang agen. Untuk menggabungkan metrik di semua ruang agen di akun Anda, gunakan ekspresi CloudWatch matematika atau hilangkan filter dimensi.

Referensi metrik

Nama metrik Deskripsi Unit Frekuensi penerbitan Statistik yang berguna
ConsumedChatRequests Jumlah permintaan obrolan yang dikonsumsi ruang agen. Untuk mendapatkan jumlah total akun Anda, gunakan SUM statistik di semua AgentSpaceUUID dimensi. Hitungan Setiap 5 menit Jumlah, Rata-rata
ConsumedInvestigationTime Waktu yang dihabiskan untuk menjalankan penyelidikan di ruang agen. Detik Setiap 5 menit Jumlah, Rata-rata, Maksimum
ConsumedEvaluationTime Waktu yang dihabiskan untuk menjalankan evaluasi di ruang agen. Detik Setiap 5 menit Jumlah, Rata-rata, Maksimum
TopologyCompletionCount Jumlah penyelesaian pemrosesan topologi. AWS DevOps Agen memancarkan metrik ini saat topologi selesai diproses, baik dari pembuatan awal selama orientasi, pembaruan manual, atau penyegaran harian terjadwal. Hitungan Event-driven (dipancarkan pada setiap penyelesaian) Jumlah, SampleCount

Melihat metrik di konsol CloudWatch

  1. Buka konsol CloudWatch .

  2. Pada panel navigasi, silakan pilih Metrik, dan kemudian pilih Semua metrik.

  3. Pilih namespace AWS/AIDevOps.

  4. Pilih By AgentSpace untuk melihat metrik ruang agen Anda.

catatan

Anda dapat membuat CloudWatch alarm pada metrik ini untuk menerima notifikasi saat penggunaan melebihi ambang batas. Misalnya, buat alarm ConsumedChatRequests untuk memantau konsumsi permintaan obrolan.

Prasyarat

Sebelum Anda mengonfigurasi pengiriman log, pastikan Anda memiliki yang berikut:

  • AWS Akun aktif dengan akses ke konsol AWS DevOps Agen

  • Prinsipal IAM dengan izin untuk CloudWatch pengiriman Log APIs

  • (Opsional) Bucket Amazon S3 atau aliran pengiriman Amazon Data Firehose, jika Anda berencana menggunakannya sebagai tujuan log

Log yang dipasok

AWS DevOps Agen mendukung log vended yang memberikan visibilitas ke peristiwa yang diproses oleh ruang agen dan pendaftaran layanan Anda. Log vended menggunakan infrastruktur Amazon CloudWatch Logs untuk mengirimkan log ke tujuan pilihan Anda.

Untuk menggunakan log vended, Anda harus mengonfigurasi tujuan pengiriman. Destinasi berikut didukung:

  • Amazon CloudWatch Logs - Grup log di akun Anda

  • Amazon S3 - Bucket S3 di akun Anda

  • Amazon Data Firehose - Aliran pengiriman Firehose di akun Anda

Jenis log yang didukung

Jenis log tunggal didukung:APPLICATION_LOGS. Jenis log ini mencakup semua peristiwa operasional yang dipancarkan layanan.

Jenis peristiwa log

Tabel berikut merangkum peristiwa yang dicatat AWS DevOps Agen.

Peristiwa Deskripsi Tingkat log
Agen inbound event diterima Agen dipicu oleh sumber terintegrasi dan menerima peristiwa masuk (misalnya, peristiwa PagerDuty insiden). INFO
Acara masuk agen dijatuhkan Peristiwa inbound dijatuhkan sebelum agen memprosesnya. Log mencakup alasannya (misalnya, data yang salah bentuk). Akan Ditentukan Kemudian
Kegagalan komunikasi keluar agen Komunikasi keluar ke integrasi pihak ketiga gagal. Log termasuk ID tugas dan pengidentifikasi tujuan (misalnya, kesalahan otentikasi). Akan Ditentukan Kemudian
Pembuatan topologi antri Pekerjaan pembuatan topologi diantrian untuk diproses. INFO
Pembuatan topologi dimulai Pekerjaan penciptaan topologi mulai diproses. INFO
Pembuatan topologi selesai Pekerjaan pembuatan topologi menyelesaikan pemrosesan. Acara ini berlaku untuk pembuatan awal, pembaruan, dan penyegaran harian. INFO
Penemuan sumber daya gagal Penemuan sumber daya selama pembuatan topologi mengalami kegagalan. ERROR
Registrasi layanan gagal Registrasi layanan mengalami kegagalan yang tidak dapat dipulihkan ERROR
Validasi Webhook gagal Ketika webhook diterima oleh agen Devops tidak cocok dengan skema yang diharapkan ERROR
Pembaruan status Validasi Asosiasi Ketika asosiasi ruang Agen ( primary/secondary akun tipikal), status validasi berubah dari valid menjadi tidak valid dan sebaliknya (misalnya, disebabkan oleh peran yang salah, yang tidak dapat diasumsikan oleh layanan). KESALAHAN/INFO

Izin

AWS DevOps Agen menggunakan log CloudWatch vended (izin V2) untuk mengirimkan log. Untuk mengatur pengiriman log, peran IAM yang mengonfigurasi pengiriman harus memiliki izin berikut:

  • aidevops:AllowVendedLogDeliveryForResource— Diperlukan untuk memungkinkan pengiriman log untuk sumber daya ruang agen.

  • Izin untuk pengiriman CloudWatch Log APIs (logs:PutDeliverySource,logs:PutDeliveryDestination,logs:CreateDelivery, dan operasi terkait).

  • Izin khusus untuk tujuan pengiriman yang Anda pilih.

Untuk kebijakan IAM lengkap yang diperlukan untuk setiap jenis tujuan, lihat topik berikut di Panduan Pengguna CloudWatch Log Amazon:

Konfigurasikan pengiriman log (konsol)

AWS DevOps Agen menyediakan dua lokasi di AWS Management Console untuk mengonfigurasi pengiriman log:

  • Halaman pengaturan Pendaftaran Layanan - Konfigurasikan pengiriman log untuk acara tingkat layanan. Log ini menggunakan layanan ARN (arn:aws:aidevops:<region>:<account-id>:service/<account-id>) sebagai sumber daya.

  • Halaman Ruang Agen - Konfigurasikan pengiriman log untuk acara yang khusus untuk ruang agen individu. Log ini menggunakan ruang agen ARN (arn:aws:aidevops:<region>:<account-id>:agentspace/<agent-space-id>) sebagai sumber daya.

Untuk mengonfigurasi pengiriman log untuk pendaftaran layanan

  1. Buka konsol AWS DevOps Agen di Konsol AWS Manajemen.

  2. Pada panel navigasi, silakan pilih Pengaturan.

  3. Di tab Penyedia Kemampuan > Log, pilih Konfigurasi.

  4. Untuk tipe Tujuan, pilih salah satu dari berikut ini:

  5. CloudWatch Log — Pilih atau buat grup log.

  6. Amazon S3 — Masukkan ember S3 ARN.

  7. Amazon Data Firehose — Pilih atau buat aliran pengiriman Firehose.

  8. Untuk Pengaturan tambahan - opsional, Anda dapat menentukan opsi berikut:

    1. Untuk pemilihan Bidang, pilih nama bidang log yang ingin Anda kirimkan ke tujuan Anda. Anda dapat memilih bidang log akses dan subset bidang log akses real-time.

    2. (Hanya Amazon S3) Untuk Partisi, tentukan jalur untuk mempartisi data file log Anda.

    3. (Hanya Amazon S3) Untuk format file yang kompatibel dengan HIVE, Anda dapat memilih kotak centang untuk menggunakan jalur S3 yang kompatibel dengan HIVE. Ini membantu menyederhanakan pemuatan data baru ke alat yang kompatibel dengan HIVE Anda.

    4. Untuk format Output, tentukan format pilihan Anda.

    5. Untuk pembatas bidang, tentukan cara memisahkan bidang log.

  9. Pilih Simpan.

  10. Verifikasi bahwa status pengiriman menunjukkan Aktif.

Untuk mengonfigurasi pengiriman log untuk ruang agen

  1. Buka konsol AWS DevOps Agen di Konsol AWS Manajemen.

  2. Pilih ruang agen yang ingin Anda konfigurasikan.

  3. Di tab Konfigurasi, pilih Konfigurasi.

  4. Untuk tipe Tujuan, pilih salah satu dari berikut ini:

  5. CloudWatch Log — Pilih atau buat grup log.

  6. Amazon S3 — Masukkan ember S3 ARN.

  7. Amazon Data Firehose — Pilih atau buat aliran pengiriman Firehose.

  8. Untuk Pengaturan tambahan — * opsional *, Anda dapat menentukan opsi berikut:

    1. Untuk pemilihan Bidang, pilih nama bidang log yang ingin Anda kirimkan ke tujuan Anda. Anda dapat memilih bidang log akses dan subset bidang log akses real-time.

    2. (Hanya Amazon S3) Untuk Partisi, tentukan jalur untuk mempartisi data file log Anda.

    3. (Hanya Amazon S3) Untuk format file yang kompatibel dengan HIVE, Anda dapat memilih kotak centang untuk menggunakan jalur S3 yang kompatibel dengan HIVE. Ini membantu menyederhanakan pemuatan data baru ke alat yang kompatibel dengan HIVE Anda.

    4. Untuk format Output, tentukan format pilihan Anda.

    5. Untuk pembatas bidang, tentukan cara memisahkan bidang log.

  9. Pilih Simpan.

  10. Verifikasi bahwa status pengiriman menunjukkan Aktif.

Konfigurasikan pengiriman log (CloudWatch API)

Anda juga dapat menggunakan CloudWatch Logs API untuk mengonfigurasi pengiriman log secara terprogram. Pengiriman log kerja terdiri dari tiga elemen:

  • A DeliverySource- Merupakan sumber daya ruang AWS DevOps Agen yang menghasilkan log.

  • A DeliveryDestination- Merupakan tujuan di mana log ditulis.

  • Pengiriman — Menghubungkan sumber pengiriman ke tujuan pengiriman.

Langkah 1: Buat sumber pengiriman

Gunakan PutDeliverySourceoperasi untuk membuat sumber pengiriman. Lewati ARN sumber daya ruang AWS DevOps Agen Anda dan tentukan APPLICATION_LOGS sebagai jenis log.

Contoh berikut membuat sumber pengiriman untuk ruang agen:

{ "name": "my-agent-space-delivery-source", "resourceArn": "arn:aws:aidevops:us-east-1:123456789012:agentspace/my-agent-space-id", "logType": "APPLICATION_LOGS" }

Contoh berikut membuat sumber pengiriman untuk layanan:

{ "name": "my-service-delivery-source", "resourceArn": "arn:aws:aidevops:us-east-1:123456789012:service", "logType": "APPLICATION_LOGS" }

Langkah 2: Buat tujuan pengiriman

Gunakan PutDeliveryDestinationoperasi untuk mengonfigurasi tempat log disimpan. Anda dapat memilih Amazon CloudWatch Log, Amazon S3, atau Amazon Data Firehose.

Contoh berikut membuat tujuan CloudWatch Log:

{ "name": "my-cwl-destination", "deliveryDestinationConfiguration": { "destinationResourceArn": "arn:aws:logs:us-east-1:123456789012:log-group:/aws/aidevops/my-agent-space" }, "outputFormat": "json" }

Contoh berikut membuat tujuan Amazon S3:

{ "name": "my-s3-destination", "deliveryDestinationConfiguration": { "destinationResourceArn": "arn:aws:s3:::my-aidevops-logs-bucket" }, "outputFormat": "json" }

Contoh berikut membuat tujuan Amazon Data Firehose:

{ "name": "my-firehose-destination", "deliveryDestinationConfiguration": { "destinationResourceArn": "arn:aws:firehose:us-east-1:123456789012:deliverystream/my-aidevops-log-stream" }, "outputFormat": "json" }
catatan

Jika Anda mengirimkan log lintas akun, Anda harus menggunakan PutDeliveryDestinationPolicydi akun tujuan untuk mengotorisasi pengiriman.

Jika Anda ingin menggunakan CloudFormation, Anda dapat menggunakan yang berikut ini:

ResourceArnIni adalahAgentSpaceArn, dan LogType harus APPLICATION_LOGS sebagai jenis log yang didukung.

Langkah 3: Buat pengiriman

Gunakan CreateDeliveryoperasi untuk menautkan sumber pengiriman ke tujuan pengiriman.

{ "deliverySourceName": "my-agent-space-delivery-source", "deliveryDestinationArn": "arn:aws:logs:us-east-1:123456789012:delivery-destination:my-cwl-destination" }

AWS CloudFormation

Anda juga dapat mengonfigurasi pengiriman log AWS CloudFormation dengan menggunakan sumber daya berikut:

Setel ResourceArn ke ruang AWS DevOps agen Agen atau layanan ARN, dan atur LogType ke. APPLICATION_LOGS

Referensi skema log

AWS DevOps Agen menggunakan skema log bersama di semua jenis acara. Tidak setiap peristiwa log menggunakan setiap bidang.

Tabel berikut menjelaskan bidang dalam skema log.

Bidang Tipe Deskripsi
event_timestamp Panjang Stempel waktu Unix saat peristiwa terjadi
resource_arn String ARN dari sumber daya yang menghasilkan acara
optional_account_id String AWS ID akun yang terkait dengan log.
opsional_level String Tingkat log:INFO,WARN, ERROR
optional_agent_space_id String Pengidentifikasi ruang agen.
optional_association_id String Pengidentifikasi asosiasi untuk log.
opsional_status String Status operasi topologi.
opsional_webhook_id String Pengidentifikasi Webhook.
opsional_mcp_endpoint_url String URL titik akhir server MCP
optional_service_type String Jenis Layanan:DYNATRACE,, DATADOGGITHUB,SLACK,SERVICENOW.
optional_service_endpoint_url String URL titik akhir untuk integrasi pihak ketiga.
optional_service_id String Pengidentifikasi sumber.
request_id String Minta pengenal untuk berkorelasi dengan AWS CloudTrail atau tiket dukungan.
optional_operation String Nama operasi yang dilakukan.
optional_task_type String Jenis tugas backlog agen: INVESTIGATION atau EVALUATION
optional_task_id String Pengidentifikasi tugas backlog Tugas IDAgent Backlog Agen.
optional_reference String Referensi dari tugas agen (misalnya, tiket Jira).
optional_error_type String Jenis kesalahan
optional_error_message String Deskripsi kesalahan saat operasi gagal.
opsional_details Tali (JSON) Payload peristiwa khusus layanan yang berisi parameter dan hasil operasi.

Mengelola dan menonaktifkan pengiriman log

Anda dapat mengubah atau menghapus pengiriman log kapan saja dari konsol AWS DevOps Agen di Konsol AWS Manajemen atau dengan menggunakan API CloudWatch Log.

Mengelola pengiriman log (konsol)

  1. Buka konsol AWS DevOps Agen di Konsol AWS Manajemen.

  2. Arahkan ke halaman Pengaturan (untuk log tingkat layanan) atau halaman Ruang Agen tertentu (untuk log tingkat Ruang Agen).

  3. Di tab Konfigurasi (untuk log tingkat Ruang Agen) atau tab Penyedia Kemampuan > Log (untuk log tingkat layanan), pilih pengiriman yang akan dimodifikasi.

  4. Perbarui konfigurasi sesuai kebutuhan dan pilih Simpan.

Nonaktifkan pengiriman log (konsol)

  1. Buka konsol AWS DevOps Agen di Konsol AWS Manajemen.

  2. Arahkan ke halaman Pengaturan (untuk log tingkat layanan) atau halaman Ruang Agen tertentu (untuk log tingkat Ruang Agen).

  3. Di tab Konfigurasi (untuk log tingkat Ruang Agen) atau tab Penyedia Kemampuan > Log (untuk log tingkat layanan), pilih pengiriman yang akan dihapus.

  4. Pilih Hapus dan konfirmasi.

Nonaktifkan pengiriman log (API)

Untuk menghapus pengiriman log menggunakan API, hapus sumber daya dalam urutan berikut:

  1. Hapus pengiriman dengan menggunakan DeleteDelivery.

  2. Hapus sumber pengiriman dengan menggunakan DeleteDeliverySource.

  3. (Opsional) Jika tujuan pengiriman tidak lagi diperlukan, hapus dengan menggunakan DeleteDeliveryDestination.

penting

Anda bertanggung jawab untuk menghapus sumber daya pengiriman log setelah menghapus sumber daya ruang agen yang menghasilkan log (misalnya, setelah Anda menghapus ruang agen). Jika Anda tidak menghapus sumber daya ini, konfigurasi pengiriman yatim piatu mungkin tetap ada.

Harga

AWS DevOps Agen tidak mengenakan biaya untuk mengaktifkan log vended. Namun, Anda dapat dikenakan biaya untuk pengiriman, konsumsi, penyimpanan, atau akses, tergantung pada tujuan pengiriman log yang Anda pilih. Untuk detail harga, lihat Log Terjual di tab Log di CloudWatch Harga Amazon.

Untuk harga khusus tujuan, lihat berikut ini: