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
Buka konsol CloudWatch
. Pada panel navigasi, silakan pilih Metrik, dan kemudian pilih Semua metrik.
Pilih namespace AWS/AIDevOps.
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
Buka konsol AWS DevOps Agen di Konsol AWS Manajemen.
Pada panel navigasi, silakan pilih Pengaturan.
Di tab Penyedia Kemampuan > Log, pilih Konfigurasi.
Untuk tipe Tujuan, pilih salah satu dari berikut ini:
CloudWatch Log — Pilih atau buat grup log.
Amazon S3 — Masukkan ember S3 ARN.
Amazon Data Firehose — Pilih atau buat aliran pengiriman Firehose.
Untuk Pengaturan tambahan - opsional, Anda dapat menentukan opsi berikut:
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.
(Hanya Amazon S3) Untuk Partisi, tentukan jalur untuk mempartisi data file log Anda.
(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.
Untuk format Output, tentukan format pilihan Anda.
Untuk pembatas bidang, tentukan cara memisahkan bidang log.
Pilih Simpan.
Verifikasi bahwa status pengiriman menunjukkan Aktif.
Untuk mengonfigurasi pengiriman log untuk ruang agen
Buka konsol AWS DevOps Agen di Konsol AWS Manajemen.
Pilih ruang agen yang ingin Anda konfigurasikan.
Di tab Konfigurasi, pilih Konfigurasi.
Untuk tipe Tujuan, pilih salah satu dari berikut ini:
CloudWatch Log — Pilih atau buat grup log.
Amazon S3 — Masukkan ember S3 ARN.
Amazon Data Firehose — Pilih atau buat aliran pengiriman Firehose.
Untuk Pengaturan tambahan — * opsional *, Anda dapat menentukan opsi berikut:
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.
(Hanya Amazon S3) Untuk Partisi, tentukan jalur untuk mempartisi data file log Anda.
(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.
Untuk format Output, tentukan format pilihan Anda.
Untuk pembatas bidang, tentukan cara memisahkan bidang log.
Pilih Simpan.
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)
Buka konsol AWS DevOps Agen di Konsol AWS Manajemen.
Arahkan ke halaman Pengaturan (untuk log tingkat layanan) atau halaman Ruang Agen tertentu (untuk log tingkat Ruang Agen).
Di tab Konfigurasi (untuk log tingkat Ruang Agen) atau tab Penyedia Kemampuan > Log (untuk log tingkat layanan), pilih pengiriman yang akan dimodifikasi.
Perbarui konfigurasi sesuai kebutuhan dan pilih Simpan.
Nonaktifkan pengiriman log (konsol)
Buka konsol AWS DevOps Agen di Konsol AWS Manajemen.
Arahkan ke halaman Pengaturan (untuk log tingkat layanan) atau halaman Ruang Agen tertentu (untuk log tingkat Ruang Agen).
Di tab Konfigurasi (untuk log tingkat Ruang Agen) atau tab Penyedia Kemampuan > Log (untuk log tingkat layanan), pilih pengiriman yang akan dihapus.
Pilih Hapus dan konfirmasi.
Nonaktifkan pengiriman log (API)
Untuk menghapus pengiriman log menggunakan API, hapus sumber daya dalam urutan berikut:
Hapus pengiriman dengan menggunakan DeleteDelivery.
Hapus sumber pengiriman dengan menggunakan DeleteDeliverySource.
(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: