Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# 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"
}
}
```