Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
# Überwachen Sie Amazon Bedrock API-Aufrufe mit CloudTrail
Amazon Bedrock ist in einen Service integriert AWS CloudTrail, der eine Aufzeichnung der Aktionen bereitstellt, die von einem Benutzer, einer Rolle oder einem AWS Service in Amazon Bedrock ausgeführt wurden. CloudTrail erfasst alle API-Aufrufe für Amazon Bedrock als Ereignisse. Zu den erfassten Aufrufen gehören Aufrufe von der Amazon-Bedrock-Konsole und Code-Aufrufe der API-Operationen von Amazon Bedrock. Wenn Sie einen Trail erstellen, können Sie die kontinuierliche Übermittlung von CloudTrail Ereignissen an einen Amazon S3 S3-Bucket aktivieren, einschließlich Ereignissen für Amazon Bedrock.
Wenn Sie keinen Trail konfigurieren, können Sie die neuesten Ereignisse trotzdem in der CloudTrail Konsole im **Ereignisverlauf** anzeigen.
Anhand der von gesammelten Informationen können Sie die Anfrage CloudTrail, die an Amazon Bedrock gestellt wurde, die IP-Adresse, von der aus die Anfrage gestellt wurde, wer die Anfrage gestellt hat, wann sie gestellt wurde, und weitere Details ermitteln.
Weitere Informationen CloudTrail dazu finden Sie im [AWS CloudTrail Benutzerhandbuch](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-user-guide.html).
## Informationen zu Amazon Bedrock in CloudTrail
CloudTrail ist auf Ihrem aktiviert AWS-Konto , wenn Sie das Konto erstellen. Wenn in Amazon Bedrock Aktivitäten auftreten, wird diese Aktivität zusammen mit anderen AWS Serviceereignissen in der CloudTrail **Ereignishistorie in einem Ereignis** aufgezeichnet. Sie können aktuelle Ereignisse in Ihrem AWS-Konto anzeigen, suchen und herunterladen. Weitere Informationen finden Sie unter [Ereignisse mit dem CloudTrail Ereignisverlauf anzeigen](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/view-cloudtrail-events.html).
Für eine fortlaufende Aufzeichnung der Ereignisse in Ihrem AWS-Konto, einschließlich der Ereignisse für Amazon Bedrock, erstellen Sie einen Trail. Ein *Trail* ermöglicht CloudTrail die Übermittlung von Protokolldateien an einen Amazon S3 S3-Bucket. Wenn Sie einen Trail in der Konsole anlegen, gilt dieser für alle AWS-Regionen-Regionen. Der Trail protokolliert Ereignisse aus allen Regionen der AWS Partition und übermittelt die Protokolldateien an den von Ihnen angegebenen Amazon S3 S3-Bucket. Darüber hinaus können Sie andere AWS Dienste konfigurieren, um die in den CloudTrail Protokollen gesammelten Ereignisdaten weiter zu analysieren und darauf zu reagieren. Weitere Informationen finden Sie hier:
+ [Übersicht zum Erstellen eines Trails](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-create-and-update-a-trail.html)
+ [CloudTrail unterstützte Dienste und Integrationen](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-aws-service-specific-topics.html)
+ [Konfiguration von Amazon SNS SNS-Benachrichtigungen für CloudTrail](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/configure-sns-notifications-for-cloudtrail.html)
+ [Empfangen von CloudTrail Protokolldateien aus mehreren Regionen](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/receive-cloudtrail-log-files-from-multiple-regions.html) und [Empfangen von CloudTrail Protokolldateien von mehreren Konten](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-receive-logs-from-multiple-accounts.html)
Jeder Ereignis- oder Protokolleintrag enthält Informationen zu dem Benutzer, der die Anforderung generiert hat. Die Identitätsinformationen unterstützen Sie bei der Ermittlung der folgenden Punkte:
+ Ob die Anfrage mit Root- oder AWS Identity and Access Management (IAM-) Benutzeranmeldedaten gestellt wurde.
+ Gibt an, ob die Anforderung mit temporären Sicherheitsanmeldeinformationen für eine Rolle oder einen Verbundbenutzer gesendet wurde.
+ Ob die Anfrage von einem anderen AWS Dienst gestellt wurde.
Weitere Informationen finden Sie unter [CloudTrail -Element userIdentity](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-event-reference-user-identity.html).
## Amazon Bedrock-Datenereignisse in CloudTrail
[Datenereignisse](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-data-events-with-cloudtrail.html#logging-data-events) liefern Informationen über die Ressourcenoperationen, die auf oder in einer Ressource ausgeführt werden (z. B. Lesen oder Schreiben in ein Amazon-S3-Objekt). Sie werden auch als Vorgänge auf Datenebene bezeichnet. Bei Datenereignissen handelt es sich häufig um umfangreiche Aktivitäten, die CloudTrail standardmäßig nicht protokolliert werden.
Amazon Bedrock protokolliert einige [Laufzeit-API-Operationen in Amazon Bedrock](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_Operations_Amazon_Bedrock_Runtime.html) (wie `InvokeModel`, `InvokeModelWithResponseStream`, `Converse`, `ConverseStream` und `ListAsyncInvokes`) als [Verwaltungsereignisse](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-management-events-with-cloudtrail.html#logging-management-events).
Amazon Bedrock protokolliert andere [Laufzeit-API-Operationen in Amazon Bedrock](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_Operations_Amazon_Bedrock_Runtime.html) (wie `InvokeModelWithBidirectionalStream`, `GetAsyncInvoke` und `StartAsyncInvokes`) als Datenereignisse.
Amazon Bedrock protokolliert alle Aktionen der [Agents for Amazon Bedrock Runtime API](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_Operations_Agents_for_Amazon_Bedrock_Runtime.html) (wie `InvokeAgent` und`InvokeInlineAgent`) CloudTrail als Datenereignisse.
+ Konfigurieren Sie erweiterte Ereignisauswahlen, um Datenereignisse für den `AWS::Bedrock::AgentAlias`-Ressourcentyp aufzuzeichnen und [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)-Aufrufe zu protokollieren.
+ Konfigurieren Sie erweiterte Ereignisauswahlen, um Datenereignisse für den `AWS::Bedrock::InlineAgent`-Ressourcentyp aufzuzeichnen und [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)-Aufrufe zu protokollieren.
+ Um [InvokeModelWithBidirectionalStream](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_InvokeModelWithBidirectionalStream.html)Aufrufe zu protokollieren, konfigurieren Sie erweiterte Event-Selektoren so, dass sie Datenereignisse für den `AWS::Bedrock::Model` Ressourcentyp und aufzeichnen. `AWS:Bedrock::AsyncInvoke`
+ Um [StartAsyncInvoke](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_StartAsyncInvoke.html)Aufrufe zu protokollieren [GetAsyncInvoke](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_GetAsyncInvoke.html)und zu protokollieren, konfigurieren Sie erweiterte Event-Selektoren zum Aufzeichnen von Datenereignissen für den `AWS::Bedrock::Model` Ressourcentyp und. `AWS:Bedrock::AsyncInvoke`
+ Konfigurieren Sie erweiterte Ereignisauswahlen, um Datenereignisse für den `AWS::Bedrock::KnowledgeBase`-Ressourcentyp aufzuzeichnen und [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)- und [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)-Aufrufe zu protokollieren.
+ Konfigurieren Sie erweiterte Ereignisauswahlen, um Datenereignisse für den `AWS::Bedrock::FlowAlias`-Ressourcentyp aufzuzeichnen und [InvokeFlow](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvokeFlow.html)-Aufrufe zu protokollieren.
+ Konfigurieren Sie erweiterte Ereignisauswahlen, um Datenereignisse für den `AWS::Bedrock::Prompt`-Ressourcentyp aufzuzeichnen und `RenderPrompt`-Aufrufe zu protokollieren. `RenderPrompt` ist eine [Aktion](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonbedrock.html#amazonbedrock-actions-as-permissions), die nur mit Berechtigungen ausgeführt werden kann und die mithilfe des [Prompt-Managements](prompt-management.md) erstellte Prompts für den Modellaufruf (`InvokeModel(WithResponseStream)` und `Converse(Stream)`) rendert.
Wählen Sie in der CloudTrail Konsole **Bedrock Agent alias oder Bedrock** **Knowledge Base** für den Ereignistyp **Data** aus. Sie können zusätzlich nach den Feldern `eventName` und `resources.ARN` filtern, indem Sie eine benutzerdefinierte Protokollauswahlvorlage auswählen. Weitere Informationen finden Sie unter [Datenereignisse mit der AWS Management Console protokollieren](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-data-events-with-cloudtrail.html).
Geben Sie von der AWS CLI aus den `resource.type` Wert gleich`AWS::Bedrock::AgentAlias`,`AWS::Bedrock::KnowledgeBase`, oder an `AWS::Bedrock::FlowAlias` und legen Sie den Wert `eventCategory` gleich fest`Data`. Weitere Informationen finden Sie unter [Protokollieren von Datenereignissen mit der AWS CLI](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-data-events-with-cloudtrail.html#creating-data-event-selectors-with-the-AWS-CLI).
Das folgende Beispiel zeigt, wie Sie Ihren Trail so konfigurieren, dass sämtliche Amazon-Bedrock-Datenereignisse für alle Amazon-Bedrock-Ressourcentypen in der AWS CLI enthalten sind.
```
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"] }
]
}
]'
```
Sie können zusätzlich nach den Feldern `eventName` und `resources.ARN` filtern. Weitere Informationen zu diesen Feldern finden Sie unter [https://docs.aws.amazon.com/awscloudtrail/latest/APIReference/API_AdvancedFieldSelector.html](https://docs.aws.amazon.com/awscloudtrail/latest/APIReference/API_AdvancedFieldSelector.html).
Für Datenereignisse werden zusätzliche Gebühren fällig. Weitere Informationen zur CloudTrail Preisgestaltung finden Sie unter [AWS CloudTrail Preisgestaltung](https://aws.amazon.com/cloudtrail/pricing/).
## Verwaltungsveranstaltungen von Amazon Bedrock in CloudTrail
[Verwaltungsereignisse](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-management-events-with-cloudtrail.html#logging-management-events) bieten Informationen über Verwaltungsvorgänge, die mit Ressourcen in Ihrem AWS Konto ausgeführt werden. Diese Operationen werden auch als Operationen auf Steuerungsebene bezeichnet. CloudTrail protokolliert standardmäßig API-Operationen für Verwaltungsereignisse.
Amazon Bedrock protokolliert [Laufzeit-API-Operationen in Amazon Bedrock](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_Operations_Amazon_Bedrock_Runtime.html) (`InvokeModel`, `InvokeModelWithResponseStream`, `Converse` und `ConverseStream`) als [Verwaltungsereignisse](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-management-events-with-cloudtrail.html#logging-management-events).
Amazon Bedrock protokolliert den Rest der Amazon-Bedrock-API-Operationen als Verwaltungsereignisse. Eine Liste der Amazon Bedrock API-Operationen, bei denen Amazon Bedrock sich anmeldet CloudTrail, finden Sie auf den folgenden Seiten in der Amazon Bedrock API-Referenz.
+ [Amazon Bedrock](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_Operations_Amazon_Bedrock.html)
+ [Agenten für Amazon Bedrock](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_Operations_Agents_for_Amazon_Bedrock.html)
+ [Runtime der Agenten für Amazon Bedrock](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_Operations_Agents_for_Amazon_Bedrock_Runtime.html)
+ [Amazon Bedrock Runtime](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_Operations_Amazon_Bedrock_Runtime.html)
Alle [Amazon Bedrock API-Operationen](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_Operations_Amazon_Bedrock.html) und [Agents for Amazon Bedrock API-Operationen](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_Operations_Agents_for_Amazon_Bedrock.html) werden von der [Amazon Bedrock](https://docs.aws.amazon.com/bedrock/latest/APIReference/) API-Referenz protokolliert CloudTrail und dokumentiert. Aufrufe von, und `CreateAgent` Aktionen generieren beispielsweise Einträge in den CloudTrail Protokolldateien. `InvokeModel` `StopModelCustomizationJob`
[Amazon](https://aws.amazon.com/guardduty/) überwacht und analysiert GuardDuty kontinuierlich Ihre CloudTrail Verwaltungs- und Ereignisprotokolle, um potenzielle Sicherheitsprobleme zu erkennen. Wenn Sie Amazon GuardDuty für ein AWS Konto aktivieren, beginnt es automatisch mit der Analyse von CloudTrail Protokollen, um verdächtige Aktivitäten in Amazon Bedrock zu erkennen APIs, z. B. wenn sich ein Benutzer von einem neuen Standort aus anmeldet und Amazon Bedrock verwendet, um Amazon Bedrock Guardrails APIs zu entfernen, oder das Amazon S3 S3-Bucket-Set für Modelltrainingsdaten zu ändern.
## Erläuterungen der Amazon-Bedrock-Protokolldateieinträge
Ein Trail ist eine Konfiguration, die die Übertragung von Ereignissen als Protokolldateien an einen von Ihnen angegebenen Amazon S3 S3-Bucket ermöglicht. CloudTrail Protokolldateien enthalten einen oder mehrere Protokolleinträge. Ein Ereignis stellt eine einzelne Anforderung aus einer beliebigen Quelle dar und enthält Informationen über die angeforderte Aktion, Datum und Uhrzeit der Aktion, Anforderungsparameter usw. CloudTrail Protokolldateien sind kein geordneter Stack-Trace der öffentlichen API-Aufrufe, sodass sie nicht in einer bestimmten Reihenfolge angezeigt werden.
Das folgende Beispiel zeigt einen CloudTrail Protokolleintrag, der die `InvokeModel` Aktion demonstriert.
```
{
"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"
}
}
```