Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Observabilitas
Observabilitas di Amazon Bedrock membantu Anda melacak performa, mengelola sumber daya, dan mengotomatiskan penerapan.
**Topics**
+ [Memantau kinerja Amazon Bedrock](monitoring.md)
+ [Menandai sumber daya Amazon Bedrock](tagging.md)
# Memantau kinerja Amazon Bedrock
Anda dapat memantau semua bagian aplikasi Amazon Bedrock Anda menggunakan Amazon CloudWatch, yang mengumpulkan data mentah dan memprosesnya menjadi metrik yang dapat dibaca, mendekati waktu nyata. Anda dapat membuat grafik metrik menggunakan CloudWatch konsol. Anda juga dapat menyetel alarm yang mengawasi ambang batas tertentu, dan mengirim pemberitahuan atau mengambil tindakan ketika nilai melebihi ambang batas tersebut.
Untuk informasi selengkapnya, lihat [Apa itu Amazon CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/DeveloperGuide/WhatIsCloudWatch.html) *di Panduan CloudWatch Pengguna Amazon*.
Amazon Bedrock menyediakan kemampuan pemantauan komprehensif di berbagai komponen aplikasi Anda:
+ [Memantau pemanggilan model menggunakan CloudWatch Log dan Amazon S3](model-invocation-logging.md)- Lacak dan analisis pemanggilan model menggunakan CloudWatch Log dan Amazon S3.
+ [Pantau basis pengetahuan menggunakan CloudWatch Log](knowledge-bases-logging.md)- Memantau operasi dan kinerja basis pengetahuan.
+ [Pantau Amazon Bedrock Guardrails menggunakan metrik CloudWatch](monitoring-guardrails-cw-metrics.md)- Lacak evaluasi pagar pembatas dan penegakan kebijakan.
+ [Pantau Agen Amazon Bedrock menggunakan Metrik CloudWatch](monitoring-agents-cw-metrics.md)- Memantau pemanggilan agen dan metrik kinerja.
+ [Metrik runtime Amazon Bedrock](#runtime-cloudwatch-metrics)- Lihat metrik runtime kunci termasuk pemanggilan, latensi, kesalahan, dan jumlah token.
+ [Pantau perubahan status pekerjaan Amazon Bedrock menggunakan Amazon EventBridgePantau perubahan acara](monitoring-eventbridge.md)- Lacak perubahan status pekerjaan dan otomatiskan respons terhadap acara.
+ [Pantau panggilan Amazon Bedrock API menggunakan CloudTrail](logging-using-cloudtrail.md)- Audit panggilan API dan lacak aktivitas pengguna.
**Topics**
+ [Memantau pemanggilan model menggunakan CloudWatch Log dan Amazon S3](model-invocation-logging.md)
+ [Pantau basis pengetahuan menggunakan CloudWatch Log](knowledge-bases-logging.md)
+ [Pantau Amazon Bedrock Guardrails menggunakan metrik CloudWatch](monitoring-guardrails-cw-metrics.md)
+ [Pantau Agen Amazon Bedrock menggunakan Metrik CloudWatch](monitoring-agents-cw-metrics.md)
+ [Metrik runtime Amazon Bedrock](#runtime-cloudwatch-metrics)
+ [CloudWatch metrik untuk Amazon Bedrock](#br-cloudwatch-metrics)
+ [Pantau perubahan status pekerjaan Amazon Bedrock menggunakan Amazon EventBridge](monitoring-eventbridge.md)
+ [Pantau panggilan Amazon Bedrock API menggunakan CloudTrail](logging-using-cloudtrail.md)
# Memantau pemanggilan model menggunakan CloudWatch Log dan Amazon S3
Anda dapat menggunakan pencatatan pemanggilan model untuk mengumpulkan log pemanggilan, data input model, dan data keluaran model untuk semua pemanggilan yang digunakan di Amazon Bedrock Akun AWS di Wilayah.
Dengan pencatatan pemanggilan, Anda dapat mengumpulkan data permintaan lengkap, data respons, dan metadata yang terkait dengan semua panggilan yang dilakukan di akun Anda di Wilayah. Logging dapat dikonfigurasi untuk menyediakan sumber daya tujuan di mana data log akan dipublikasikan. Tujuan yang didukung termasuk Amazon CloudWatch Logs dan Amazon Simple Storage Service (Amazon S3). Hanya tujuan dari akun dan Wilayah yang sama yang didukung.
Pencatatan pemanggilan model dinonaktifkan secara default. Setelah logging pemanggilan model diaktifkan, log disimpan hingga konfigurasi logging dihapus.
Operasi berikut dapat mencatat pemanggilan model.
+ [Bercakap-cakap](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_Converse.html)
+ [ConverseStream](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_ConverseStream.html)
+ [InvokeModel](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_InvokeModel.html)
+ [InvokeModelWithResponseStream](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_InvokeModelWithResponseStream.html)
Saat [menggunakan Converse API](conversation-inference-call.md), data gambar atau dokumen apa pun yang Anda lewati dicatat di Amazon S3 (jika Anda telah [mengaktifkan](#model-invocation-logging-console) pengiriman dan pencatatan gambar di Amazon S3).
Sebelum Anda dapat mengaktifkan pencatatan pemanggilan, Anda perlu menyiapkan tujuan Amazon S3 CloudWatch atau Log. Anda dapat mengaktifkan logging pemanggilan melalui konsol atau API.
**Topics**
+ [Siapkan tujuan Amazon S3](#setup-s3-destination)
+ [Menyiapkan tujuan CloudWatch Log](#setup-cloudwatch-logs-destination)
+ [Pencatatan pemanggilan model menggunakan konsol](#model-invocation-logging-console)
+ [Pencatatan pemanggilan model menggunakan API](#using-apis-logging)
## Siapkan tujuan Amazon S3
**catatan**
Saat menggunakan Amazon S3 sebagai tujuan logging, bucket harus dibuat Wilayah AWS sama dengan bucket tempat Anda membuat konfigurasi logging pemanggilan model.
Anda dapat mengatur tujuan S3 untuk masuk ke Amazon Bedrock dengan langkah-langkah berikut:
1. Buat bucket S3 tempat log akan dikirimkan.
1. Tambahkan kebijakan bucket ke dalamnya seperti di bawah ini (Ganti nilai untuk*accountId*,, *region**bucketName*, dan opsional*prefix*):
**catatan**
Kebijakan bucket secara otomatis dilampirkan ke bucket atas nama Anda saat mengonfigurasi pencatatan dengan izin `S3:GetBucketPolicy` dan`S3:PutBucketPolicy`.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "AmazonBedrockLogsWrite",
"Effect": "Allow",
"Principal": {
"Service": "bedrock.amazonaws.com"
},
"Action": [
"s3:PutObject"
],
"Resource": [
"arn:aws:s3:::bucketName/prefix/AWSLogs/123456789012/BedrockModelInvocationLogs/*"
],
"Condition": {
"StringEquals": {
"aws:SourceAccount": "123456789012"
},
"ArnLike": {
"aws:SourceArn": "arn:aws:bedrock:us-east-1:123456789012:*"
}
}
}
]
}
```
------
1. (Opsional) Jika mengonfigurasi SSE-KMS pada bucket, tambahkan kebijakan di bawah ini pada kunci KMS:
```
{
"Effect": "Allow",
"Principal": {
"Service": "bedrock.amazonaws.com"
},
"Action": "kms:GenerateDataKey",
"Resource": "*",
"Condition": {
"StringEquals": {
"aws:SourceAccount": "accountId"
},
"ArnLike": {
"aws:SourceArn": "arn:aws:bedrock:region:accountId:*"
}
}
}
```
[Untuk informasi selengkapnya tentang konfigurasi S3 SSE-KMS, lihat Menentukan Enkripsi KMS.](https://docs.aws.amazon.com/AmazonS3/latest/userguide/specifying-kms-encryption.html)
**catatan**
Bucket ACL harus dinonaktifkan agar kebijakan bucket berlaku. Untuk informasi selengkapnya, lihat [Menonaktifkan ACLs semua bucket baru dan menerapkan Kepemilikan](https://docs.aws.amazon.com/AmazonS3/latest/userguide/ensure-object-ownership.html) Objek.
## Menyiapkan tujuan CloudWatch Log
Anda dapat mengatur tujuan Amazon CloudWatch Log untuk masuk ke Amazon Bedrock dengan langkah-langkah berikut:
1. Buat grup CloudWatch log tempat log akan dipublikasikan.
1. Buat peran IAM dengan izin berikut untuk CloudWatch Log.
**Entitas tepercaya**:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Principal": {
"Service": "bedrock.amazonaws.com"
},
"Action": "sts:AssumeRole",
"Condition": {
"StringEquals": {
"aws:SourceAccount": "123456789012"
},
"ArnLike": {
"aws:SourceArn": "arn:aws:bedrock:us-east-1:123456789012:*"
}
}
}
]
}
```
------
**Kebijakan peran**:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"logs:CreateLogStream",
"logs:PutLogEvents"
],
"Resource": "arn:aws:logs:us-east-1:123456789012:log-group:logGroupName:log-stream:aws/bedrock/modelinvocations"
}
]
}
```
------
Untuk informasi selengkapnya tentang pengaturan SSE untuk CloudWatch Log, lihat [Mengenkripsi data CloudWatch log di](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/encrypt-log-data-kms.html) Log menggunakan. AWS Key Management Service
## Pencatatan pemanggilan model menggunakan konsol
**Untuk mengaktifkan pencatatan pemanggilan model**
Masuk ke Konsol Manajemen AWS dengan identitas IAM yang memiliki izin untuk menggunakan konsol Amazon Bedrock. Kemudian, buka konsol Amazon Bedrock di [https://console.aws.amazon.com/bedrock](https://console.aws.amazon.com/bedrock).
1. Dari panel navigasi kiri, pilih **Pengaturan**.
1. Di halaman **log pemanggilan Model, pilih Pencatatan pemanggilan** **model**. Pengaturan konfigurasi tambahan untuk logging akan muncul.
1. Pilih modalitas permintaan data dan tanggapan yang ingin Anda publikasikan ke log. Anda dapat memilih kombinasi dari opsi output berikut:
+ Teks
+ Citra
+ Menyematkan
+ Video
**catatan**
Data akan dicatat untuk *semua* model yang mendukung modalitas (baik sebagai input atau output) yang Anda pilih. Misalnya, jika Anda memilih **Gambar**, pemanggilan model akan dicatat untuk semua model yang mendukung input gambar, output gambar, atau keduanya.
1. Pilih tempat untuk mempublikasikan log:
+ Hanya Amazon S3
+ CloudWatch Log saja
+ Baik Amazon S3 dan Log CloudWatch
**Tujuan pencatatan**
Tujuan Amazon S3 dan CloudWatch Log didukung untuk log pemanggilan, serta data input dan output kecil. Untuk data input dan output besar atau output gambar biner, hanya Amazon S3 yang didukung. Rincian berikut merangkum bagaimana data akan direpresentasikan di lokasi target.
+ **Tujuan S3** - File JSON yang di-zip, masing-masing berisi sekumpulan catatan log pemanggilan, dikirim ke bucket S3 yang ditentukan. Mirip dengan peristiwa CloudWatch Log, setiap record akan berisi metadata pemanggilan, dan badan JSON input dan output berukuran hingga 100 KB. Data biner atau badan JSON yang lebih besar dari 100 KB akan diunggah sebagai objek individual dalam bucket Amazon S3 yang ditentukan di bawah awalan data. Data dapat ditanyakan menggunakan Amazon S3 Select dan Amazon Athena, dan dapat dikatalogkan untuk penggunaan ETL. AWS Glue Data dapat dimuat ke OpenSearch layanan, atau diproses oleh EventBridge target Amazon apa pun.
+ **CloudWatch Tujuan log** - Peristiwa log pemanggilan JSON dikirim ke grup log tertentu di Log. CloudWatch Peristiwa log berisi metadata pemanggilan, dan badan JSON input dan output berukuran hingga 100 KB. Jika lokasi Amazon S3 untuk pengiriman data besar disediakan, data biner atau badan JSON yang lebih besar dari 100 KB akan diunggah ke bucket Amazon S3 di bawah awalan data sebagai gantinya. data dapat ditanyakan menggunakan Wawasan CloudWatch Log, dan dapat dialirkan lebih lanjut ke berbagai layanan secara real-time menggunakan Log. CloudWatch
## Pencatatan pemanggilan model menggunakan API
Pencatatan pemanggilan model dapat dikonfigurasi menggunakan yang berikut ini: APIs
+ [PutModelInvocationLoggingConfiguration](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_PutModelInvocationLoggingConfiguration.html)
+ [GetModelInvocationLoggingConfiguration](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_GetModelInvocationLoggingConfiguration.html)
+ [DeleteModelInvocationLoggingConfiguration](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_DeleteModelInvocationLoggingConfiguration.html)
# Pantau basis pengetahuan menggunakan CloudWatch Log
Amazon Bedrock mendukung sistem pemantauan untuk membantu Anda memahami pelaksanaan pekerjaan pengambilan data apa pun untuk basis pengetahuan Anda. Bagian berikut mencakup cara mengaktifkan dan mengonfigurasi sistem logging untuk basis pengetahuan Amazon Bedrock menggunakan CloudWatch API Konsol Manajemen AWS dan API. Anda dapat memperoleh visibilitas ke dalam konsumsi data sumber daya basis pengetahuan Anda dengan sistem logging ini.
## Pencatatan basis pengetahuan menggunakan konsol
Untuk mengaktifkan pencatatan untuk basis pengetahuan Amazon Bedrock menggunakan: Konsol Manajemen AWS
1. **Buat basis pengetahuan**: Gunakan Konsol Manajemen AWS for Amazon Bedrock untuk [membuat basis pengetahuan baru](https://docs.aws.amazon.com/bedrock/latest/userguide/knowledge-base-create.html).
1. **Tambahkan opsi pengiriman log**: Setelah membuat basis pengetahuan, edit atau perbarui basis pengetahuan Anda untuk menambahkan opsi pengiriman log.
**catatan**
Pengiriman log tidak didukung saat membuat basis pengetahuan dengan penyimpanan data terstruktur, atau untuk Indeks Kendra GenAI.
**Konfigurasikan detail pengiriman log**: Masukkan detail untuk pengiriman log, termasuk:
+ Tujuan pencatatan (baik CloudWatch Log, Amazon S3, Amazon Data Firehose)
+ (Jika menggunakan CloudWatch Log sebagai tujuan logging) Nama grup log
+ (Jika menggunakan Amazon S3 sebagai tujuan logging) Nama bucket
+ (Jika menggunakan Amazon Data Firehose sebagai tujuan logging) Firehose stream
1. **Sertakan izin akses**: Pengguna yang masuk ke konsol harus memiliki izin yang diperlukan untuk menulis log yang dikumpulkan ke tujuan yang dipilih.
Contoh berikut kebijakan IAM dapat dilampirkan ke pengguna yang masuk ke konsol untuk memberikan izin yang diperlukan saat menggunakan Log CloudWatch
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": "logs:CreateDelivery",
"Resource": [
"arn:aws:logs:us-east-1:123456789012:delivery-source:*",
"arn:aws:logs:us-east-1:123456789012:delivery:*",
"arn:aws:logs:us-east-1:123456789012:delivery-destination:*"
]
}
]
}
```
------
1. **Konfirmasikan status pengiriman**: Verifikasi bahwa status pengiriman log adalah “Pengiriman aktif” di konsol.
## Pencatatan basis pengetahuan menggunakan CloudWatch API
Untuk mengaktifkan logging untuk basis pengetahuan Amazon Bedrock menggunakan CloudWatch API:
1. **Dapatkan ARN basis pengetahuan Anda: Setelah membuat basis** [pengetahuan](https://docs.aws.amazon.com/bedrock/latest/userguide/knowledge-base-create.html) menggunakan Amazon Bedrock API atau konsol Amazon Bedrock, dapatkan Nama Sumber Daya Amazon dari basis pengetahuan. Anda bisa mendapatkan Nama Sumber Daya Amazon dengan memanggil [GetKnowledgeBase](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_GetKnowledgeBase.html)API. Basis pengetahuan Nama Sumber Daya Amazon mengikuti format ini: *arn:aws:bedrock:your-region:your-account-id:knowledge-base/knowledge-base-id*
1. **Panggilan `PutDeliverySource`**: Gunakan [PutDeliverySource](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutDeliverySource.html)API yang disediakan oleh Amazon CloudWatch untuk membuat sumber pengiriman untuk basis pengetahuan. Lulus basis pengetahuan Nama Sumber Daya Amazon sebagai`resourceArn`. `logType`menentukan `APPLICATION_LOGS` sebagai jenis log yang dikumpulkan. `APPLICATION_LOGS`melacak status file saat ini selama pekerjaan konsumsi.
```
{
"logType": "APPLICATION_LOGS",
"name": "my-knowledge-base-delivery-source",
"resourceArn": "arn:aws:bedrock:your-region:your-account-id:knowledge-base/knowledge_base_id"
}
```
1. **Panggilan `PutDeliveryDestination`**: Gunakan [PutDeliveryDestination](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutDeliveryDestination.html)API yang disediakan oleh Amazon CloudWatch untuk mengonfigurasi tempat log akan disimpan. Anda dapat memilih CloudWatch Log, Amazon S3, atau Amazon Data Firehose sebagai tujuan untuk menyimpan log. Anda harus menentukan Nama Sumber Daya Amazon dari salah satu opsi tujuan tempat log Anda akan disimpan. Anda dapat memilih log untuk menjadi salah satu dari yang berikut:`json`,`plain`,`w3c`,`raw`,`parquet`. `outputFormat` Berikut ini adalah contoh konfigurasi log yang akan disimpan dalam bucket Amazon S3 dan dalam format JSON.
```
{
"deliveryDestinationConfiguration": {
"destinationResourceArn": "arn:aws:s3:::bucket-name"
},
"name": "string",
"outputFormat": "json",
"tags": {
"key" : "value"
}
}
```
Perhatikan bahwa jika Anda mengirimkan log lintas akun, Anda harus menggunakan `PutDeliveryDestinationPolicy` API untuk menetapkan kebijakan AWS Identity and Access Management (IAM) ke akun tujuan. Kebijakan IAM memungkinkan pengiriman dari satu akun ke akun lain.
1. **Panggilan `CreateDelivery`**: Gunakan panggilan [CreateDelivery](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_CreateDelivery.html)API untuk menautkan sumber pengiriman ke tujuan yang Anda buat di langkah sebelumnya. Operasi API ini mengaitkan sumber pengiriman dengan tujuan akhir.
```
{
"deliveryDestinationArn": "string",
"deliverySourceName": "string",
"tags": {
"string" : "string"
}
}
```
**catatan**
Jika Anda ingin menggunakan CloudFormation, Anda dapat menggunakan yang berikut ini:
[Pengiriman](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-logs-delivery.html)
[DeliveryDestination](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-logs-deliverydestination.html)
[DeliverySource](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-logs-deliverysource.html)
`ResourceArn`Ini adalah`KnowledgeBaseARN`, dan `LogType` harus `APPLICATION_LOGS` sebagai jenis log yang didukung.
## Jenis log yang didukung
Basis pengetahuan Amazon Bedrock mendukung jenis log berikut:
+ `APPLICATION_LOGS`: Log yang melacak status file tertentu saat ini selama pekerjaan pengambilan data.
## Izin dan batasan pengguna
Untuk mengaktifkan pencatatan untuk basis pengetahuan Amazon Bedrock, izin berikut diperlukan untuk akun pengguna yang masuk ke konsol:
1. `bedrock:AllowVendedLogDeliveryForResource`— Diperlukan untuk memungkinkan log dikirimkan untuk sumber daya basis pengetahuan.
Anda dapat melihat contoh role/permissions kebijakan IAM dengan semua izin yang diperlukan untuk tujuan pencatatan spesifik Anda. Lihat Izin [log terjual untuk tujuan pengiriman yang berbeda](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AWS-logs-and-resource-policy.html#AWS-vended-logs-permissions-V2), dan ikuti contoh role/permission kebijakan IAM untuk tujuan pencatatan Anda, termasuk mengizinkan pembaruan ke sumber daya tujuan pencatatan tertentu (baik CloudWatch Log, Amazon S3, atau Amazon Data Firehose).
Anda juga dapat memeriksa apakah ada batasan kuota untuk membuat panggilan API terkait pengiriman CloudWatch log dalam dokumentasi kuota [layanan CloudWatch Log](https://docs.aws.amazon.com/general/latest/gr/cwl_region.html). Batas kuota menetapkan jumlah maksimum kali Anda dapat memanggil API atau membuat sumber daya. Jika Anda melebihi batas, itu akan mengakibatkan `ServiceQuotaExceededException` kesalahan.
## Contoh log basis pengetahuan
Ada log tingkat konsumsi data dan log tingkat sumber daya untuk basis pengetahuan Amazon Bedrock.
Berikut ini adalah contoh log pekerjaan konsumsi data.
```
{
"event_timestamp": 1718683433639,
"event": {
"ingestion_job_id": "",
"data_source_id": "",
"ingestion_job_status": "INGESTION_JOB_STARTED" | "STOPPED" | "COMPLETE" | "FAILED" | "CRAWLING_COMPLETED"
"knowledge_base_arn": "arn:aws:bedrock:::knowledge-base/",
"resource_statistics": {
"number_of_resources_updated": int,
"number_of_resources_ingested": int,
"number_of_resources_scheduled_for_update": int,
"number_of_resources_scheduled_for_ingestion": int,
"number_of_resources_scheduled_for_metadata_update": int,
"number_of_resources_deleted": int,
"number_of_resources_with_metadata_updated": int,
"number_of_resources_failed": int,
"number_of_resources_scheduled_for_deletion": int
}
},
"event_version": "1.0",
"event_type": "StartIngestionJob.StatusChanged",
"level": "INFO"
}
```
Berikut ini adalah contoh log tingkat sumber daya.
```
{
"event_timestamp": 1718677342332,
"event": {
"ingestion_job_id": "",
"data_source_id": "",
"knowledge_base_arn": "arn:aws:bedrock:::knowledge-base/",
"document_location": {
"type": "S3",
"s3_location": {
"uri": "s3://"
}
},
"status": ""
"status_reasons": String[],
"chunk_statistics": {
"ignored": int,
"created": int,
"deleted": int,
"metadata_updated": int,
"failed_to_create": int,
"failed_to_delete": int,
"failed_to_update_metadata": int
},
},
"event_version": "1.0",
"event_type": "StartIngestionJob.ResourceStatusChanged",
"level": "INFO" | "WARN" | "ERROR"
}
```
`status`Untuk sumber daya dapat menjadi salah satu dari yang berikut:
+ `SCHEDULED_FOR_INGESTION`,`SCHEDULED_FOR_DELETION`,`SCHEDULED_FOR_UPDATE`,`SCHEDULED_FOR_METADATA_UPDATE`: Nilai status ini menunjukkan bahwa sumber daya dijadwalkan untuk diproses setelah menghitung perbedaan antara keadaan basis pengetahuan saat ini dan perubahan yang dibuat dalam sumber data.
+ `RESOURCE_IGNORED`: Nilai status ini menunjukkan bahwa sumber daya diabaikan untuk diproses, dan alasannya dirinci di dalam `status_reasons` properti.
+ `EMBEDDING_STARTED`dan`EMBEDDING_COMPLETED`: Nilai status ini menunjukkan kapan penyematan vektor untuk sumber daya dimulai dan diselesaikan.
+ `INDEXING_STARTED`dan`INDEXING_COMPLETED`: Nilai status ini menunjukkan kapan pengindeksan untuk sumber daya dimulai dan diselesaikan.
+ `DELETION_STARTED`dan`DELETION_COMPLETED`: Nilai status ini menunjukkan kapan penghapusan sumber daya dimulai dan diselesaikan.
+ `METADATA_UPDATE_STARTED`dan`METADATA_UPDATE_COMPLETED`: Nilai status ini menunjukkan kapan pembaruan metadata untuk sumber daya dimulai dan diselesaikan.
+ `EMBEDDING_FAILED`,`INDEXING_FAILED`,`DELETION_FAILED`, dan`METADATA_UPDATE_FAILED`: Nilai status ini menunjukkan bahwa pemrosesan sumber daya gagal, dan alasannya dirinci di dalam `status_reasons` properti.
+ `INDEXED``DELETED`,`PARTIALLY_INDEXED`,`METADATA_PARTIALLY_INDEXED`,,`FAILED`: Setelah pemrosesan dokumen diselesaikan, log diterbitkan dengan status akhir dokumen, dan ringkasan pemrosesan di dalam `chunk_statistics` properti.
## Contoh kueri umum untuk men-debug log basis pengetahuan
Anda dapat berinteraksi dengan log menggunakan kueri. Misalnya, Anda dapat menanyakan semua dokumen dengan status acara `RESOURCE_IGNORED` selama menelan dokumen atau data.
Berikut ini adalah beberapa kueri umum yang dapat digunakan untuk men-debug log yang dihasilkan menggunakan Wawasan CloudWatch Log:
+ Kueri untuk semua log yang dihasilkan untuk dokumen S3 tertentu.
`filter event.document_location.s3_location.uri = "s3:///"`
+ Kueri untuk semua dokumen yang diabaikan selama pekerjaan pengambilan data.
`filter event.status = "RESOURCE_IGNORED"`
+ Kueri untuk semua pengecualian yang terjadi saat vektor menyematkan dokumen.
`filter event.status = "EMBEDDING_FAILED"`
+ Kueri untuk semua pengecualian yang terjadi saat mengindeks dokumen ke dalam database vektor.
`filter event.status = "INDEXING_FAILED"`
+ Kueri untuk semua pengecualian yang terjadi saat menghapus dokumen dari database vektor.
`filter event.status = "DELETION_FAILED"`
+ Kueri untuk semua pengecualian yang terjadi saat memperbarui metadata dokumen Anda dalam database vektor.
`filter event.status = "DELETION_FAILED"`
+ Kueri untuk semua pengecualian yang terjadi selama pelaksanaan pekerjaan konsumsi data.
`filter level = "ERROR" or level = "WARN"`
# Pantau Amazon Bedrock Guardrails menggunakan metrik CloudWatch
Tabel berikut menjelaskan metrik runtime yang disediakan oleh Amazon Bedrock Guardrails yang dapat Anda pantau dengan metrik Amazon. CloudWatch
**Metrik runtime**
| Nama metrik | Unit | Deskripsi |
| --- | --- | --- |
| Invokasi | SampleCount | Jumlah permintaan untuk operasi ApplyGuardrail API |
| InvocationLatency | MilliSeconds | Latensi pemanggilan |
| InvocationClientErrors | SampleCount | Jumlah pemanggilan yang menghasilkan kesalahan sisi klien |
| InvocationServerErrors | SampleCount | Jumlah pemanggilan yang menghasilkan kesalahan sisi server AWS |
| InvocationThrottles | SampleCount | Jumlah pemanggilan yang dibatasi oleh sistem. Permintaan yang dibatasi tidak dihitung sebagai pemanggilan atau kesalahan |
| TextUnitCount | SampleCount | Jumlah unit teks yang dikonsumsi oleh kebijakan pagar pembatas |
| InvocationsIntervened | SampleCount | Jumlah doa di mana pagar pembatas diintervensi |
| FindingCounts | SampleCount | Hitungan untuk setiap jenis temuan dari InvokeAutomatedReasoningCheck |
| TotalFindings | SampleCount | Menghitung jumlah temuan yang dihasilkan untuk setiap permintaan InvokeAutomatedReasoningCheck |
| Invokasi | SampleCount | Jumlah permintaan untuk InvokeAutomatedReasoningCheck |
| Latensi | MilliSeconds | Latensi verifikasi menggunakan kebijakan penalaran otomatis |
Anda dapat melihat dimensi pagar pembatas di CloudWatch konsol berdasarkan tabel di bawah ini:
**Dimensi**
| Nama dimensi | Nilai dimensi | Tersedia untuk metrik berikut |
| --- | --- | --- |
| Operasi | ApplyGuardrail | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/bedrock/latest/userguide/monitoring-guardrails-cw-metrics.html) |
| GuardrailContentSource | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/bedrock/latest/userguide/monitoring-guardrails-cw-metrics.html) | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/bedrock/latest/userguide/monitoring-guardrails-cw-metrics.html) |
| GuardrailPolicyType | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/bedrock/latest/userguide/monitoring-guardrails-cw-metrics.html) | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/bedrock/latest/userguide/monitoring-guardrails-cw-metrics.html) |
| GuardrailArn, GuardrailVersion | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/bedrock/latest/userguide/monitoring-guardrails-cw-metrics.html) | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/bedrock/latest/userguide/monitoring-guardrails-cw-metrics.html) |
| FindingType \$1 PolicyArn \$1 PolicyVersion | FindingType \$1 PolicyArn \$1 PolicyVersion | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/bedrock/latest/userguide/monitoring-guardrails-cw-metrics.html) |
| FindingType \$1 GuardrailArn \$1 GuardrailVersion | FindingType \$1 GuardrailArn \$1 GuardrailVersion | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/bedrock/latest/userguide/monitoring-guardrails-cw-metrics.html) |
| PolicyArn \$1 PolicyVersion | PolicyArn \$1 PolicyVersion | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/bedrock/latest/userguide/monitoring-guardrails-cw-metrics.html) |
| GuardrailArn \$1 GuardrailVersion | GuardrailArn \$1 GuardrailVersion | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/bedrock/latest/userguide/monitoring-guardrails-cw-metrics.html) |
**Dapatkan CloudWatch metrik untuk pagar pembatas**
Anda bisa mendapatkan metrik untuk pagar pembatas dengan AWS Management Console, AWS CLI, atau API. CloudWatch Anda dapat menggunakan CloudWatch API melalui salah satu Kit Pengembangan AWS Perangkat Lunak (SDKs) atau alat CloudWatch API.
Namespace untuk metrik pagar pembatas adalah. CloudWatch `AWS/Bedrock/Guardrails`
**catatan**
Anda harus memiliki CloudWatch izin yang sesuai untuk memantau pagar pembatas. CloudWatch Untuk informasi selengkapnya, lihat [Otentikasi dan Kontrol Akses CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/auth-and-access-control-cw.html) di Panduan CloudWatch Pengguna.
**Lihat metrik pagar pembatas di konsol CloudWatch **
1. Masuk ke Konsol AWS Manajemen dan buka CloudWatch konsol di https://console.aws.amazon.com/cloudwatch/.
1. Pilih `AWS/Bedrock/Guardrails` namespace.
# Pantau Agen Amazon Bedrock menggunakan Metrik CloudWatch
Tabel berikut menjelaskan metrik runtime yang disediakan oleh Amazon Bedrock Agents yang dapat Anda pantau dengan Amazon Metrics. CloudWatch
**Metrik runtime**
****
| Nama metrik | Unit | Deskripsi |
| --- | --- | --- |
| InvocationCount | SampleCount | Jumlah permintaan untuk operasi API |
| TotalTime | Milidetik | Waktu yang dibutuhkan server untuk memproses permintaan |
| TTFT | Milidetik | Time-to-first-token metrik. Dipancarkan saat konfigurasi Streaming diaktifkan untuk permintaan atau invokeAgent invokeInlineAgent |
| InvocationThrottles | SampleCount | Jumlah pemanggilan yang dibatasi oleh sistem. Permintaan yang dibatasi dan kesalahan pemanggilan lainnya tidak dihitung sebagai Pemanggilan atau Kesalahan. |
| InvocationServerErrors | SampleCount | Jumlah pemanggilan yang menghasilkan kesalahan sisi server AWS |
| InvocationClientErrors | SampleCount | Jumlah pemanggilan yang menghasilkan kesalahan sisi klien |
| ModelLatency | Milidetik | Latensi model |
| ModelInvocationCount | SampleCount | Jumlah permintaan yang dibuat agen untuk model |
| ModelInvocationThrottles | SampleCount | Jumlah pemanggilan model yang dibatasi oleh inti Amazon Bedrock. Permintaan yang dibatasi dan kesalahan pemanggilan lainnya tidak dihitung sebagai Pemanggilan atau Kesalahan. |
| ModelInvocationClientErrors | SampleCount | Jumlah pemanggilan model yang menghasilkan kesalahan sisi klien |
| ModelInvocationServerErrors | SampleCount | Jumlah pemanggilan model yang menghasilkan kesalahan sisi server AWS |
| InputTokenCount | SampleCount | Jumlah masukan token ke model. |
| outputTokenCount | SampleCount | Jumlah token ouptut dari model. |
Anda dapat melihat dimensi agen di CloudWatch konsol berdasarkan tabel di bawah ini:
**Dimensi**
****
| Nama dimensi | Nilai dimensi | Tersedia untuk metrik berikut |
| --- | --- | --- |
| Operasi | [InvokeAgent](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvokeAgent.html), [InvokeInlineAgent](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvokeInlineAgent.html) | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/bedrock/latest/userguide/monitoring-agents-cw-metrics.html) |
| Operasi, ModelId | Setiap operasi agen Amazon Bedrock yang tercantum dalam dimensi Operasi dan modelId model inti Amazon Bedrock | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/bedrock/latest/userguide/monitoring-agents-cw-metrics.html) |
| Operasi, AgentAliasArn, ModelId | Setiap operasi agen Amazon Bedrock yang tercantum dalam dimensi Operasi dan modelId salah satu model Amazon Bedrock, dikelompokkan berdasarkan alias agentAliasArn agen | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/bedrock/latest/userguide/monitoring-agents-cw-metrics.html) |
**Gunakan CloudWatch metrik untuk agen**
Anda bisa mendapatkan metrik untuk agen dengan AWS Management Console, AWS CLI, atau CloudWatch API. Anda dapat menggunakan CloudWatch API melalui salah satu Kit Pengembangan AWS Perangkat Lunak (SDKs) atau alat CloudWatch API.
Namespace untuk metrik agen adalah. CloudWatch `AWS/Bedrock/Agents`
Anda harus memiliki CloudWatch izin yang sesuai untuk memantau agen. CloudWatch Untuk informasi selengkapnya, lihat [Otentikasi dan Kontrol Akses CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/auth-and-access-control-cw.html) di Panduan CloudWatch Pengguna.
**penting**
Jika Anda tidak CloudWatch ingin menggunakan data yang dikumpulkan untuk peningkatan CloudWatch layanan, Anda dapat membuat kebijakan memilih keluar. Untuk informasi lebih lanjut, kebijakan [opt-out layanan AI](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_policies_ai-opt-out.html).
Jika Anda tidak melihat metrik yang dipublikasikan di CloudWatch dasbor, pastikan peran layanan IAM yang Anda gunakan untuk [membuat](agents-create.md) agen memiliki kebijakan berikut.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": {
"Effect": "Allow",
"Resource": "*",
"Action": "cloudwatch:PutMetricData",
"Condition": {
"StringEquals": {
"cloudwatch:namespace": "AWS/Bedrock/Agents"
}
}
}
}
```
------
## Metrik runtime Amazon Bedrock
Tabel berikut menjelaskan metrik runtime yang disediakan oleh Amazon Bedrock.
| Nama metrik | Unit | Deskripsi |
| --- | --- | --- |
| Invokasi | SampleCount | Jumlah permintaan yang berhasil untuk operasi [Converse](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_Converse.html), [ConverseStream](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_ConverseStream.html), [InvokeModel](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_InvokeModel.html), dan [InvokeModelWithResponseStream](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_InvokeModelWithResponseStream.html)API. |
| InvocationLatency | MilliSeconds | Waktu dari saat permintaan dikirim ke saat token terakhir diterima. |
| InvocationClientErrors | SampleCount | Jumlah pemanggilan yang menghasilkan kesalahan sisi klien. |
| InvocationServerErrors | SampleCount | Jumlah pemanggilan yang menghasilkan kesalahan sisi AWS server. |
| InvocationThrottles | SampleCount | Jumlah pemanggilan yang dibatasi oleh sistem. Permintaan yang dibatasi dan kesalahan pemanggilan lainnya tidak dihitung sebagai Pemanggilan atau Kesalahan. Jumlah throttle yang Anda lihat akan tergantung pada pengaturan coba ulang Anda di SDK. Untuk informasi selengkapnya, lihat [Coba lagi perilaku](https://docs.aws.amazon.com/sdkref/latest/guide/feature-retry-behavior.html) di Panduan Referensi Alat AWS SDKs dan Alat. |
| InputTokenCount | SampleCount | Jumlah token dalam input. |
| LegacyModelInvocations | SampleCount | [Jumlah pemanggilan menggunakan model Legacy](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_FoundationModelLifecycle.html) |
| OutputTokenCount | SampleCount | Jumlah token dalam output. |
| OutputImageCount | SampleCount | Jumlah gambar dalam output (hanya berlaku untuk model pembuatan gambar). |
| TimeToFirstToken | MilliSeconds | Waktu dari saat permintaan dikirim ke saat token pertama diterima, untuk operasi API [ConverseStream](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_ConverseStream.html)dan [InvokeModelWithResponseStream](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_InvokeModelWithResponseStream.html)streaming. |
| Perkiraan TPMQuota Penggunaan | SampleCount | Estimasi konsumsi kuota Token Per Menit (TPM) di seluruh operasi [Converse](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_Converse.html),, [ConverseStream[InvokeModel](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_InvokeModel.html)](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_ConverseStream.html), dan [InvokeModelWithResponseStream](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_InvokeModelWithResponseStream.html)API. |
Ada juga metrik untuk [Amazon Bedrock Guardrails dan [Amazon](monitoring-agents-cw-metrics.md) Bedrock](monitoring-guardrails-cw-metrics.md) Agents.
## CloudWatch metrik untuk Amazon Bedrock
Untuk setiap upaya keberhasilan atau kegagalan pengiriman, CloudWatch metrik Amazon berikut akan dipancarkan di bawah namespace`AWS/Bedrock`, dan dimensi: `Across all model IDs`
+ `ModelInvocationLogsCloudWatchDeliverySuccess`
+ `ModelInvocationLogsCloudWatchDeliveryFailure`
+ `ModelInvocationLogsS3DeliverySuccess`
+ `ModelInvocationLogsS3DeliveryFailure`
+ `ModelInvocationLargeDataS3DeliverySuccess`
+ `ModelInvocationLargeDataS3DeliveryFailure`
Untuk mengambil metrik untuk operasi Amazon Bedrock, Anda menentukan informasi berikut:
+ Dimensi metrik. *Dimensi* adalah sekumpulan pasangan nama-nilai yang Anda gunakan untuk mengidentifikasi metrik. Amazon Bedrock mendukung dimensi berikut:
+ `ModelId`— semua metrik
+ `ModelId + ImageSize + BucketedStepSize` – OutputImageCount
+ Nama metrik, seperti `InvocationClientErrors`.
Anda bisa mendapatkan metrik untuk Amazon Bedrock dengan Konsol Manajemen AWS, the AWS CLI, atau API. CloudWatch Anda dapat menggunakan CloudWatch API melalui salah satu Kit Pengembangan AWS Perangkat Lunak (SDKs) atau alat CloudWatch API.
Untuk melihat metrik Amazon Bedrock di CloudWatch konsol, buka bagian metrik di panel navigasi dan pilih opsi semua metrik, lalu cari ID model.
Anda harus memiliki CloudWatch izin yang sesuai untuk memantau Amazon Bedrock dengan CloudWatch Untuk informasi selengkapnya, lihat [Otentikasi dan Kontrol Akses untuk Amazon CloudWatch di Panduan](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/auth-and-access-control-cw.html) Pengguna *Amazon CloudWatch *.
# Pantau perubahan status pekerjaan Amazon Bedrock menggunakan Amazon EventBridge
Amazon EventBridge adalah AWS layanan yang memantau peristiwa dari AWS layanan lain dalam waktu dekat. Anda dapat menggunakan Amazon EventBridge untuk memantau peristiwa di Amazon Bedrock dan mengirim informasi peristiwa ketika mereka cocok dengan aturan yang Anda tetapkan. Anda kemudian dapat mengonfigurasi aplikasi Anda untuk merespons secara otomatis peristiwa ini. Amazon EventBridge mendukung pemantauan peristiwa berikut di Amazon Bedrock:
+ [Pekerjaan kustomisasi model](custom-models.md) — Keadaan pekerjaan dapat dilihat pada detail pekerjaan di Konsol Manajemen AWS atau dalam [GetModelCustomizationJob](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_GetModelCustomizationJob.html)tanggapan. Untuk informasi selengkapnya, lihat [Pantau pekerjaan kustomisasi model Anda](model-customization-monitor.md).
+ [Pekerjaan inferensi Batch](batch-inference.md) — Keadaan pekerjaan dapat dilihat pada detail pekerjaan di Konsol Manajemen AWS atau dalam [GetModelInvocationJob](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_GetModelInvocationJob.html)tanggapan. Untuk informasi selengkapnya, lihat [Pantau pekerjaan inferensi batch](batch-inference-monitor.md).
Amazon Bedrock memancarkan acara dengan upaya terbaik. Acara dari Amazon Bedrock dikirim ke Amazon EventBridge dalam waktu dekat. Anda dapat membuat aturan yang memicu tindakan terprogram sebagai respons terhadap suatu peristiwa. Dengan Amazon EventBridge, Anda dapat melakukan hal berikut:
+ Publikasikan notifikasi setiap kali ada peristiwa perubahan status dalam pekerjaan yang telah Anda kirimkan, dan apakah akan menambahkan alur kerja asinkron baru di masa mendatang. Pemberitahuan harus memberi Anda informasi yang cukup untuk bereaksi terhadap peristiwa dalam alur kerja hilir.
+ Memberikan pembaruan status pekerjaan tanpa menjalankan Get API, yang dapat membantu menangani masalah batas tarif API, pembaruan API, dan pengurangan sumber daya komputasi tambahan.
Tidak ada biaya untuk menerima AWS acara dari Amazon EventBridge. Untuk informasi selengkapnya tentang, Amazon EventBridge, lihat [Amazon EventBridge](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-what-is.html)
**Topics**
+ [Cara EventBridge kerja Amazon Bedrock](monitoring-eventbridge-how-it-works.md)
+ [[Contoh] Buat aturan untuk menangani peristiwa perubahan status Amazon Bedrock](monitoring-eventbridge-create-rule-ex.md)
# Cara EventBridge kerja Amazon Bedrock
Amazon EventBridge adalah bus acara tanpa server yang menyerap peristiwa perubahan status dari layanan, mitra SaaS AWS , dan aplikasi pelanggan. Ini memproses peristiwa berdasarkan aturan atau pola yang Anda buat, dan merutekan peristiwa ini ke satu atau beberapa *target* yang Anda pilih, seperti AWS Lambda, Amazon Simple Queue Service, dan Amazon Simple Notification Service. Anda dapat mengonfigurasi alur kerja hilir berdasarkan konten acara.
Sebelum mempelajari cara menggunakan Amazon EventBridge untuk Amazon Bedrock, tinjau halaman berikut di Panduan EventBridge Pengguna Amazon.
+ [Konsep bus acara di Amazon EventBridge](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-what-is-how-it-works-concepts.html) — Tinjau konsep *acara*, *aturan*, dan *target*.
+ [Membuat aturan yang bereaksi terhadap peristiwa di Amazon EventBridge](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-rule.html) — Pelajari cara membuat aturan.
+ [Pola EventBridge acara Amazon](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-event-patterns.html) — Pelajari cara menentukan pola acara.
+ [ EventBridge Target Amazon](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-targets.html) — Pelajari tentang target yang dapat Anda kirimi acara.
Amazon Bedrock menerbitkan acara Anda melalui Amazon EventBridge setiap kali ada perubahan dalam status pekerjaan yang Anda kirimkan. Dalam setiap kasus, acara baru dibuat dan dikirim ke Amazon EventBridge, yang kemudian mengirimkan acara ke bus acara default Anda. Acara ini menunjukkan status pekerjaan mana yang telah berubah dan keadaan pekerjaan saat ini.
Peristiwa Amazon Bedrock diidentifikasi dalam suatu peristiwa berdasarkan nilai `source` makhluk `aws.bedrock` tersebut. `detail-type`Untuk acara di Amazon Bedrock meliputi yang berikut:
+ `Model Customization Job State Change`
+ `Batch Inference Job State Change`
Pilih tab untuk melihat contoh peristiwa untuk pekerjaan yang dikirimkan di Amazon Bedrock.
------
#### [ Model Customization Job State Change ]
Objek JSON berikut menunjukkan contoh peristiwa ketika status pekerjaan kustomisasi model telah berubah:
```
{
"version": "0",
"id": "UUID",
"detail-type": "Model Customization Job State Change",
"source": "aws.bedrock",
"account": "123456789012",
"time": "2023-08-11T12:34:56Z",
"region": "us-east-1",
"resources": ["arn:aws:bedrock:us-east-1:123456789012:model-customization-job/abcdefghwxyz"],
"detail": {
"version": "0.0",
"jobName": "abcd-wxyz",
"jobArn": "arn:aws:bedrock:us-east-1:123456789012:model-customization-job/abcdefghwxyz",
"outputModelName": "dummy-output-model-name",
"outputModelArn": "arn:aws:bedrock:us-east-1:123456789012:dummy-output-model-name",
"roleArn": "arn:aws:iam::123456789012:role/JobExecutionRole",
"jobStatus": "Failed",
"failureMessage": "Failure Message here.",
"creationTime": "2023-08-11T10:11:12Z",
"lastModifiedTime": "2023-08-11T12:34:56Z",
"endTime": "2023-08-11T12:34:56Z",
"baseModelArn": "arn:aws:bedrock:us-east-1:123456789012:base-model-name",
"hyperParameters": {
"batchSize": "1",
"epochCount": "5",
"learningRate": "0.05",
"learningRateWarmupSteps": "10"
},
"trainingDataConfig": {
"s3Uri": "s3://bucket/key"
},
"validationDataConfig": {
"s3Uri": "s3://bucket/key"
},
"outputDataConfig": {
"s3Uri": "s3://bucket/key"
}
}
}
```
Untuk mempelajari tentang bidang dalam objek **detail** yang khusus untuk kustomisasi model, lihat [GetModelCustomizationJob](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_GetModelCustomizationJob.html).
------
#### [ Batch Inference Job State Change ]
Objek JSON berikut menunjukkan contoh peristiwa ketika status pekerjaan kustomisasi model telah berubah:
```
{
"version": "0",
"id": "a1b2c3d4",
"detail-type": "Batch Inference Job State Change",
"source": "aws.bedrock",
"account": "123456789012",
"time": "Wed Aug 28 22:58:30 UTC 2024",
"region": "us-east-1",
"resources": ["arn:aws:bedrock:us-east-1:123456789012:model-invocation-job/abcdefghwxyz"],
"detail": {
"version": "0.0",
"accountId": "123456789012",
"batchJobName": "dummy-batch-job-name",
"batchJobArn": "arn:aws:bedrock:us-east-1:123456789012:model-invocation-job/abcdefghwxyz",
"batchModelId": "arn:aws:bedrock:us-east-1::foundation-model/anthropic.claude-3-sonnet-20240229-v1:0",
"status": "Completed",
"failureMessage": "",
"creationTime": "Aug 28, 2024, 10:47:53 PM"
}
}
```
Untuk mempelajari tentang bidang dalam objek **detail** yang khusus untuk inferensi batch, lihat [GetModelInvocationJob](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_GetModelInvocationJob.html).
------
#### [ Bedrock Data Automation sample event ]
Objek JSON berikut menunjukkan contoh peristiwa ketika status pekerjaan pemrosesan BDA telah berubah.
```
{
"version": "0",
"id": "0cc3eaf7-dff6-6f67-0ee0-ae572fccfe84",
"detail-type": "Bedrock Data Automation Job Succeeded",
"source": "aws.bedrock",
"account": "123456789012",
"time": "2025-05-27T22:48:36Z",
"region": "us-west-2",
"resources": [],
"detail": {
"job_id": "25010344-03f7-4167-803a-837afdc7ce98",
"job_status": "SUCCESS",
"semantic_modality": "Document",
"input_s3_object": {
"s3_bucket": "input-s3-bucket-name",
"name": "key/name"
},
"output_s3_location": {
"s3_bucket": "output-s3-bucket-name",
"name": "key"
},
"error_message": ""
}
}
```
------
# [Contoh] Buat aturan untuk menangani peristiwa perubahan status Amazon Bedrock
Contoh dalam topik ini menunjukkan cara mengatur notifikasi peristiwa perubahan status Amazon Bedrock dengan memandu Anda mengonfigurasi topik Layanan Pemberitahuan Sederhana Amazon, berlangganan topik, dan membuat aturan di Amazon untuk memberi tahu Anda tentang perubahan status EventBridge Amazon Bedrock melalui topik. Lakukan prosedur berikut:
1. Untuk membuat topik, ikuti langkah-langkah di [Membuat topik Amazon SNS](https://docs.aws.amazon.com/sns/latest/dg/sns-create-topic.html) di Panduan Pengembang Layanan Pemberitahuan Sederhana Amazon.
1. Untuk berlangganan topik yang Anda buat, ikuti langkah-langkah di [Membuat langganan ke topik Amazon SNS](https://docs.aws.amazon.com/sns/latest/dg/sns-create-subscribe-endpoint-to-topic.html) di Panduan Pengembang Layanan Pemberitahuan Sederhana Amazon atau kirim permintaan [Berlangganan](https://docs.aws.amazon.com/sns/latest/api/API_Subscribe.html) dengan titik akhir [Amazon SNS](https://docs.aws.amazon.com/general/latest/gr/sns.html) dan tentukan Nama Sumber Daya Amazon (ARN) dari topik yang Anda buat.
1. Untuk membuat aturan untuk memberi tahu Anda ketika status pekerjaan di Amazon Bedrock telah berubah, ikuti langkah-langkah di [Membuat aturan yang bereaksi terhadap peristiwa di Amazon EventBridge](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-rule.html), sambil mempertimbangkan tindakan spesifik berikut untuk contoh ini:
+ Pilih untuk menentukan detail aturan dengan pola acara.
+ Saat Anda membangun pola acara, Anda dapat melakukan hal berikut:
+ Lihat peristiwa sampel di bagian **Contoh peristiwa** dengan memilih salah satu **peristiwa Sampel Batuan Dasar Amazon untuk memahami bidang dari peristiwa** Amazon Bedrock yang dapat Anda gunakan saat menentukan pola. Anda juga dapat melihat contoh peristiwa di[Cara EventBridge kerja Amazon Bedrock](monitoring-eventbridge-how-it-works.md).
+ Mulailah dengan memilih **Gunakan pola dari** bagian **Metode pembuatan** dan kemudian memilih Amazon Bedrock sebagai **AWS layanan** dan **jenis Event** yang ingin Anda tangkap. Untuk mempelajari cara menentukan pola peristiwa, lihat [Pola EventBridge acara Amazon](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-event-patterns.html).
+ Sebagai contoh, Anda dapat menggunakan pola peristiwa berikut untuk menangkap ketika pekerjaan inferensi batch telah selesai:
```
{
"source": ["aws.bedrock"],
"detail-type": ["Batch Inference Job State Change"],
"detail": {
"status": ["Completed"]
}
}
```
+ Pilih **topik SNS** sebagai target dan pilih topik yang Anda buat.
1. Setelah membuat aturan, Anda akan diberi tahu melalui Amazon SNS ketika pekerjaan inferensi batch telah selesai.
# Pantau panggilan Amazon Bedrock API menggunakan CloudTrail
Amazon Bedrock terintegrasi dengan AWS CloudTrail, layanan yang menyediakan catatan tindakan yang diambil oleh pengguna, peran, atau AWS layanan di Amazon Bedrock. CloudTrail menangkap semua panggilan API untuk Amazon Bedrock sebagai peristiwa. Panggilan yang diambil termasuk panggilan dari konsol Amazon Bedrock dan panggilan kode ke operasi Amazon Bedrock API. Jika Anda membuat jejak, Anda dapat mengaktifkan pengiriman CloudTrail acara secara berkelanjutan ke bucket Amazon S3, termasuk acara untuk Amazon Bedrock.
Jika Anda tidak mengonfigurasi jejak, Anda masih dapat melihat peristiwa terbaru di CloudTrail konsol dalam **Riwayat acara**.
Dengan menggunakan informasi yang dikumpulkan oleh CloudTrail, Anda dapat menentukan permintaan yang dibuat ke Amazon Bedrock, alamat IP dari mana permintaan itu dibuat, siapa yang membuat permintaan, kapan dibuat, dan detail tambahan.
Untuk mempelajari selengkapnya CloudTrail, lihat [Panduan AWS CloudTrail Pengguna](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-user-guide.html).
## Informasi Amazon Bedrock di CloudTrail
CloudTrail diaktifkan pada Akun AWS saat Anda membuat akun. Ketika aktivitas terjadi di Amazon Bedrock, aktivitas tersebut direkam dalam suatu CloudTrail peristiwa bersama dengan peristiwa AWS layanan lainnya dalam **riwayat Acara**. Anda dapat melihat, mencari, dan mengunduh acara terbaru di situs Anda Akun AWS. Untuk informasi selengkapnya, lihat [Melihat peristiwa dengan Riwayat CloudTrail acara](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/view-cloudtrail-events.html).
Untuk catatan acara yang sedang berlangsung di Anda Akun AWS, termasuk acara untuk Amazon Bedrock, buat jejak. *Jejak* memungkinkan CloudTrail untuk mengirimkan file log ke bucket Amazon S3. Secara default, saat Anda membuat jejak di konsol, jejak tersebut berlaku untuk semua Wilayah AWS. Jejak mencatat peristiwa dari semua Wilayah di AWS partisi dan mengirimkan file log ke bucket Amazon S3 yang Anda tentukan. Selain itu, Anda dapat mengonfigurasi AWS layanan lain untuk menganalisis lebih lanjut dan menindaklanjuti data peristiwa yang dikumpulkan dalam CloudTrail log. Untuk informasi selengkapnya, lihat berikut:
+ [Gambaran umum untuk membuat jejak](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-create-and-update-a-trail.html)
+ [CloudTrail layanan dan integrasi yang didukung](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-aws-service-specific-topics.html)
+ [Mengonfigurasi notifikasi Amazon SNS untuk CloudTrail](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/configure-sns-notifications-for-cloudtrail.html)
+ [Menerima file CloudTrail log dari beberapa Wilayah](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/receive-cloudtrail-log-files-from-multiple-regions.html) dan [Menerima file CloudTrail log dari beberapa akun](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-receive-logs-from-multiple-accounts.html)
Setiap entri peristiwa atau log berisi informasi tentang entitas yang membuat permintaan tersebut. Informasi identitas membantu Anda menentukan hal berikut ini:
+ Apakah permintaan itu dibuat dengan kredenal pengguna root atau AWS Identity and Access Management (IAM).
+ Apakah permintaan tersebut dibuat dengan kredensial keamanan sementara untuk satu peran atau pengguna gabungan.
+ Apakah permintaan itu dibuat oleh AWS layanan lain.
Untuk informasi selengkapnya, lihat [Elemen userIdentity CloudTrail ](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-event-reference-user-identity.html).
## Peristiwa data Amazon Bedrock di CloudTrail
[Peristiwa data](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-data-events-with-cloudtrail.html#logging-data-events) memberikan informasi tentang operasi sumber daya yang dilakukan pada atau di sumber daya (misalnya, membaca atau menulis ke objek Amazon S3). Ini juga dikenal sebagai operasi bidang data. Peristiwa data seringkali merupakan aktivitas volume tinggi yang CloudTrail tidak masuk secara default.
[Amazon Bedrock mencatat beberapa [operasi Amazon Bedrock Runtime API](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_Operations_Amazon_Bedrock_Runtime.html) (seperti`InvokeModel`,,, `InvokeModelWithResponseStream``Converse``ConverseStream`, dan`ListAsyncInvokes`) sebagai peristiwa manajemen.](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-management-events-with-cloudtrail.html#logging-management-events)
Amazon Bedrock mencatat [operasi Amazon Bedrock Runtime API](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_Operations_Amazon_Bedrock_Runtime.html) lainnya (seperti`InvokeModelWithBidirectionalStream`,`GetAsyncInvoke`, dan`StartAsyncInvokes`) sebagai peristiwa data.
Amazon Bedrock mencatat semua tindakan [Agen untuk Amazon Bedrock Runtime API](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_Operations_Agents_for_Amazon_Bedrock_Runtime.html) (seperti `InvokeAgent` dan`InvokeInlineAgent`) sebagai peristiwa data CloudTrail .
+ Untuk mencatat [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvokeAgent.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvokeAgent.html)panggilan, konfigurasikan pemilih peristiwa lanjutan untuk merekam peristiwa data untuk jenis `AWS::Bedrock::AgentAlias` sumber daya.
+ Untuk mencatat [https://docs.aws.amazon.com//bedrock/latest/APIReference/API_agent-runtime_InvokeInlineAgent.html](https://docs.aws.amazon.com//bedrock/latest/APIReference/API_agent-runtime_InvokeInlineAgent.html)panggilan, konfigurasikan pemilih peristiwa lanjutan untuk merekam peristiwa data untuk jenis `AWS::Bedrock::InlineAgent` sumber daya.
+ Untuk mencatat [InvokeModelWithBidirectionalStream](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_InvokeModelWithBidirectionalStream.html)panggilan, konfigurasikan pemilih peristiwa lanjutan untuk merekam peristiwa data untuk jenis `AWS::Bedrock::Model` sumber daya dan`AWS:Bedrock::AsyncInvoke`.
+ Untuk log [GetAsyncInvoke](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_GetAsyncInvoke.html)dan [StartAsyncInvoke](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_StartAsyncInvoke.html)panggilan, konfigurasikan pemilih peristiwa lanjutan untuk merekam peristiwa data untuk jenis `AWS::Bedrock::Model` sumber daya dan`AWS:Bedrock::AsyncInvoke`.
+ Untuk log [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_Retrieve.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_Retrieve.html)dan [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_RetrieveAndGenerate.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_RetrieveAndGenerate.html)panggilan, konfigurasikan pemilih peristiwa lanjutan untuk merekam peristiwa data untuk jenis `AWS::Bedrock::KnowledgeBase` sumber daya.
+ Untuk mencatat [InvokeFlow](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvokeFlow.html)panggilan, konfigurasikan pemilih peristiwa lanjutan untuk merekam peristiwa data untuk jenis `AWS::Bedrock::FlowAlias` sumber daya.
+ Untuk mencatat `RenderPrompt` panggilan, konfigurasikan pemilih peristiwa lanjutan untuk merekam peristiwa data untuk jenis `AWS::Bedrock::Prompt` sumber daya. `RenderPrompt`adalah [tindakan](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonbedrock.html#amazonbedrock-actions-as-permissions) hanya izin yang membuat prompt, dibuat menggunakan [manajemen Prompt](prompt-management.md), untuk pemanggilan model (dan). `InvokeModel(WithResponseStream)` `Converse(Stream)`
Dari CloudTrail konsol, pilih **alias agen Bedrock** atau **basis pengetahuan Bedrock untuk tipe** peristiwa **Data**. Anda juga dapat memfilter pada `eventName` dan `resources.ARN` bidang dengan memilih template pemilih log kustom. Untuk informasi selengkapnya, lihat [Mencatat peristiwa data dengan AWS Management Console](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-data-events-with-cloudtrail.html).
Dari AWS CLI, atur `resource.type` nilai sama dengan`AWS::Bedrock::AgentAlias`,`AWS::Bedrock::KnowledgeBase`, atau `AWS::Bedrock::FlowAlias` dan atur `eventCategory` sama dengan`Data`. Untuk informasi selengkapnya, lihat [Mencatat peristiwa data dengan AWS CLI](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-data-events-with-cloudtrail.html#creating-data-event-selectors-with-the-AWS-CLI).
Contoh berikut menunjukkan cara mengonfigurasi jejak untuk mencatat semua peristiwa data Amazon Bedrock untuk semua jenis sumber daya Amazon Bedrock di file. AWS CLI
```
aws cloudtrail put-event-selectors --trail-name trailName \
--advanced-event-selectors \
'[
{
"Name": "Log all data events on an alias of an agent in Amazon Bedrock.",
"FieldSelectors": [
{ "Field": "eventCategory", "Equals": ["Data"] },
{ "Field": "resources.type", "Equals": ["AWS::Bedrock::AgentAlias"] }
]
},
{
"Name": "Log all data events on a knowledge base in Amazon Bedrock.",
"FieldSelectors": [
{ "Field": "eventCategory", "Equals": ["Data"] },
{ "Field": "resources.type", "Equals": ["AWS::Bedrock::KnowledgeBase"] }
]
},
{
"Name": "Log all data events on a flow in Amazon Bedrock.",
"FieldSelectors": [
{ "Field": "eventCategory", "Equals": ["Data"] },
{ "Field": "resources.type", "Equals": ["AWS::Bedrock::FlowAlias"] }
]
}
{
"Name": "Log all data events on a guardrail in Amazon Bedrock.",
"FieldSelectors": [
{ "Field": "eventCategory", "Equals": ["Data"] },
{ "Field": "resources.type", "Equals": ["AWS::Bedrock::Guardrail"] }
]
}
]'
```
Anda juga dapat memfilter pada `resources.ARN` bidang `eventName` dan. Untuk informasi lebih lanjut tentang bidang ini, lihat [https://docs.aws.amazon.com/awscloudtrail/latest/APIReference/API_AdvancedFieldSelector.html](https://docs.aws.amazon.com/awscloudtrail/latest/APIReference/API_AdvancedFieldSelector.html).
Biaya tambahan berlaku untuk peristiwa data. Untuk informasi selengkapnya tentang CloudTrail harga, lihat [AWS CloudTrail Harga](https://aws.amazon.com/cloudtrail/pricing/).
## Acara manajemen Amazon Bedrock di CloudTrail
[Acara manajemen](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-management-events-with-cloudtrail.html#logging-management-events) memberikan informasi tentang operasi manajemen yang dilakukan pada sumber daya di AWS akun Anda. Ini juga dikenal sebagai operasi pesawat kontrol. CloudTrail mencatat operasi API peristiwa manajemen log secara default.
[Amazon Bedrock mencatat [operasi Amazon Bedrock Runtime API](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_Operations_Amazon_Bedrock_Runtime.html) (`InvokeModel`,, `InvokeModelWithResponseStream``Converse`, dan`ConverseStream`) sebagai peristiwa manajemen.](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-management-events-with-cloudtrail.html#logging-management-events)
Amazon Bedrock mencatat sisa operasi Amazon Bedrock API sebagai peristiwa manajemen. Untuk daftar operasi Amazon Bedrock API yang dicatat oleh Amazon Bedrock CloudTrail, lihat halaman berikut di referensi Amazon Bedrock API.
+ [Batuan Dasar Amazon](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_Operations_Amazon_Bedrock.html).
+ [Agen Batuan Dasar Amazon](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_Operations_Agents_for_Amazon_Bedrock.html).
+ Waktu [Jalan Agen Batuan Dasar Amazon](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_Operations_Agents_for_Amazon_Bedrock_Runtime.html).
+ [Runtime Amazon Bedrock](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_Operations_Amazon_Bedrock_Runtime.html).
Semua operasi [Amazon Bedrock API dan Agen untuk operasi](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_Operations_Amazon_Bedrock.html) [Amazon Bedrock API](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_Operations_Agents_for_Amazon_Bedrock.html) dicatat oleh CloudTrail dan didokumentasikan dalam Referensi [Amazon Bedrock](https://docs.aws.amazon.com/bedrock/latest/APIReference/) API. Misalnya, panggilan ke`InvokeModel`,`StopModelCustomizationJob`, dan `CreateAgent` tindakan menghasilkan entri dalam file CloudTrail log.
[Amazon GuardDuty](https://aws.amazon.com/guardduty/) terus memantau dan menganalisis log CloudTrail manajemen dan peristiwa Anda untuk mendeteksi potensi masalah keamanan. Saat Anda mengaktifkan Amazon GuardDuty untuk sebuah AWS akun, Amazon secara otomatis mulai menganalisis CloudTrail log untuk mendeteksi aktivitas mencurigakan di Amazon Bedrock APIs, seperti pengguna yang masuk dari lokasi baru dan menggunakan Amazon Bedrock untuk APIs menghapus Amazon Bedrock Guardrails, atau mengubah set bucket Amazon S3 untuk data pelatihan model.
## Memahami entri file log Amazon Bedrock
Trail adalah konfigurasi yang memungkinkan pengiriman peristiwa sebagai file log ke bucket Amazon S3 yang Anda tentukan. CloudTrail file log berisi satu atau lebih entri log. Peristiwa mewakili permintaan tunggal dari sumber manapun dan mencakup informasi tentang tindakan yang diminta, tanggal dan waktu tindakan, parameter permintaan, dan sebagainya. CloudTrail file log bukanlah jejak tumpukan yang diurutkan dari panggilan API publik, jadi file tersebut tidak muncul dalam urutan tertentu.
Contoh berikut menunjukkan entri CloudTrail log yang menunjukkan `InvokeModel` tindakan.
```
{
"eventVersion": "1.08",
"userIdentity": {
"type": "IAMUser",
"principalId": "AROAICFHPEXAMPLE",
"arn": "arn:aws:iam::111122223333:user/userxyz",
"accountId": "111122223333",
"accessKeyId": "AKIAIOSFODNN7EXAMPLE",
"userName": "userxyz"
},
"eventTime": "2023-10-11T21:58:59Z",
"eventSource": "bedrock.amazonaws.com",
"eventName": "InvokeModel",
"awsRegion": "us-west-2",
"sourceIPAddress": "192.0.2.0",
"userAgent": "Boto3/1.28.62 md/Botocore#1.31.62 ua/2.0 os/macos#22.6.0 md/arch#arm64 lang/python#3.9.6 md/pyimpl#CPython cfg/retry-mode#legacy Botocore/1.31.62",
"requestParameters": {
"modelId": "stability.stable-diffusion-xl-v0"
},
"responseElements": null,
"requestID": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222",
"eventID": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 ",
"readOnly": false,
"eventType": "AwsApiCall",
"managementEvent": true,
"recipientAccountId": "111122223333",
"eventCategory": "Management",
"tlsDetails": {
"tlsVersion": "TLSv1.2",
"cipherSuite": "cipher suite",
"clientProvidedHostHeader": "bedrock-runtime.us-west-2.amazonaws.com"
}
}
```
# Menandai sumber daya Amazon Bedrock
Untuk membantu mengelola sumber daya Amazon Bedrock, Anda dapat menetapkan metadata ke setiap sumber daya sebagai tag. Tag adalah label yang Anda tetapkan ke AWS sumber daya. Setiap tag terdiri dari kunci dan nilai.
Tag memungkinkan Anda untuk mengkategorikan AWS sumber daya Anda dengan cara yang berbeda, misalnya, berdasarkan tujuan, pemilik, atau aplikasi. Untuk praktik terbaik dan pembatasan penandaan, lihat [Menandai sumber daya Anda AWS](https://docs.aws.amazon.com/tag-editor/latest/userguide/tagging.html).
Tag membantu Anda melakukan hal berikut:
+ Identifikasi dan atur AWS sumber daya Anda. Banyak AWS sumber daya mendukung penandaan, sehingga Anda dapat menetapkan tag yang sama ke sumber daya di layanan yang berbeda untuk menunjukkan bahwa sumber dayanya sama.
+ Alokasikan biaya. Anda mengaktifkan tag di AWS Manajemen Penagihan dan Biaya dasbor. AWS menggunakan tag untuk mengkategorikan biaya Anda dan mengirimkan laporan alokasi biaya bulanan kepada Anda. Untuk informasi selengkapnya, lihat [Menggunakan tag alokasi biaya](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html) di *Panduan AWS Manajemen Penagihan dan Biaya Pengguna*.
+ Mengendalikan akses ke sumber daya Anda. Anda dapat menggunakan tag dengan Amazon Bedrock untuk membuat kebijakan untuk mengontrol akses ke sumber daya Amazon Bedrock. Kebijakan ini dapat dilampirkan ke peran IAM atau pengguna untuk mengaktifkan kontrol akses berbasis tag.
**Topics**
+ [Gunakan konsol](#tagging-console)
+ [Gunakan API](#tagging-api)
## Gunakan konsol
Anda dapat menambahkan, memodifikasi, dan menghapus tag kapan saja saat membuat atau mengedit sumber daya yang didukung.
## Gunakan API
Untuk melakukan operasi penandaan, Anda memerlukan Nama Sumber Daya Amazon (ARN) dari sumber daya tempat Anda ingin melakukan operasi penandaan. Ada dua set operasi penandaan, tergantung pada sumber daya yang Anda tambahkan atau kelola tag.
Tabel berikut merangkum kasus penggunaan yang berbeda dan operasi penandaan yang akan digunakan untuk mereka:
****
| Kasus penggunaan | Sumber daya yang dibuat dengan [operasi Amazon Bedrock](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_Operations_Amazon_Bedrock.html) API | Sumber daya yang dibuat dengan [operasi API Amazon Bedrock Agents](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_Operations_Agents_for_Amazon_Bedrock.html) | Sumber daya yang dibuat dengan Amazon Bedrock Data Automation API |
| --- | --- | --- | --- |
| Menandai sumber daya | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/bedrock/latest/userguide/tagging.html) | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/bedrock/latest/userguide/tagging.html) | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/bedrock/latest/userguide/tagging.html) |
| Membatalkan tag sumber daya | Buat [UntagResource](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_UntagResource.html)permintaan dengan titik [akhir bidang kontrol Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#br-cp). | Buat [UntagResource](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_UntagResource.html)permintaan dengan titik akhir [waktu pembuatan Agen untuk Amazon Bedrock.](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt) | Buat UntagResource permintaan dengan Titik Akhir Waktu Pembuatan Otomasi Data Bedrock Amazon. |
| Membuat daftar tanda untuk sumber daya | Buat [ListTagsForResource](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_ListTagsForResource.html)permintaan dengan titik [akhir bidang kontrol Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#br-cp). | Buat [ListTagsForResource](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_ListTagsForResource.html)permintaan dengan titik akhir waktu [pembuatan Agen untuk Amazon Bedrock.](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt) | Buat ListTagsForResource permintaan dengan Titik Akhir Waktu Pembuatan Otomasi Data Bedrock Amazon. |
**catatan**
Saat melihat operasi ini CloudTrail, Anda dapat mengidentifikasi sumber daya tertentu yang diberi tag dengan memeriksa parameter permintaan di detail acara.
Pilih tab untuk melihat contoh kode dalam antarmuka atau bahasa.
------
#### [ AWS CLI ]
Tambahkan dua tag ke agen. Pisahkan key/value pasangan dengan spasi.
```
aws bedrock-agent tag-resource \
--resource-arn "arn:aws:bedrock:us-east-1:123456789012:agent/AGENT12345" \
--tags key=department,value=billing key=facing,value=internal
```
Hapus tag dari agen. Pisahkan kunci dengan spasi.
```
aws bedrock-agent untag-resource \
--resource-arn "arn:aws:bedrock:us-east-1:123456789012:agent/AGENT12345" \
--tag-keys key=department facing
```
Daftar tag untuk agen.
```
aws bedrock-agent list-tags-for-resource \
--resource-arn "arn:aws:bedrock:us-east-1:123456789012:agent/AGENT12345"
```
------
#### [ Python (Boto) ]
Tambahkan dua tag ke agen.
```
import boto3
bedrock = boto3.client(service_name='bedrock-agent')
tags = [
{
'key': 'department',
'value': 'billing'
},
{
'key': 'facing',
'value': 'internal'
}
]
bedrock.tag_resource(resourceArn='arn:aws:bedrock:us-east-1:123456789012:agent/AGENT12345', tags=tags)
```
Hapus tag dari agen.
```
bedrock.untag_resource(
resourceArn='arn:aws:bedrock:us-east-1:123456789012:agent/AGENT12345',
tagKeys=['department', 'facing']
)
```
Daftar tag untuk agen.
```
bedrock.list_tags_for_resource(resourceArn='arn:aws:bedrock:us-east-1:123456789012:agent/AGENT12345')
```
------