Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Monitora le API chiamate Amazon Bedrock utilizzando CloudTrail

Amazon Bedrock è integrato con AWS CloudTrail, un servizio che fornisce un registro delle azioni intraprese da un utente, un ruolo o un AWS servizio in Amazon Bedrock. CloudTrail acquisisce tutte le API chiamate per Amazon Bedrock come eventi. Le chiamate acquisite includono chiamate dalla console Amazon Bedrock e chiamate in codice verso le operazioni di Amazon BedrockAPI. Se crei un trail, puoi abilitare la distribuzione continua di CloudTrail eventi a un bucket Amazon S3, inclusi gli eventi per Amazon Bedrock.

Se non configuri un percorso, puoi comunque visualizzare gli eventi più recenti nella CloudTrail console nella cronologia degli eventi.

Utilizzando le informazioni raccolte da CloudTrail, puoi determinare la richiesta che è stata effettuata ad Amazon Bedrock, l'indirizzo IP da cui è stata effettuata la richiesta, chi ha effettuato la richiesta, quando è stata effettuata e dettagli aggiuntivi.

Per saperne di più CloudTrail, consulta il AWS CloudTrail Guida per l'utente.

Informazioni su Amazon Bedrock in CloudTrail

CloudTrail è abilitato sul tuo Account AWS quando crei l'account. Quando si verifica un'attività in Amazon Bedrock, tale attività viene registrata in un CloudTrail evento insieme ad altri AWS eventi di servizio nella cronologia degli eventi. È possibile visualizzare, cercare e scaricare gli eventi recenti nella Account AWS. Per ulteriori informazioni, consulta Visualizzazione degli eventi con la cronologia degli CloudTrail eventi.

Per una registrazione continua degli eventi nel tuo Account AWS, inclusi gli eventi per Amazon Bedrock, crea un percorso. Un trail consente di CloudTrail inviare file di log a un bucket Amazon S3. Per impostazione predefinita, quando crei un percorso nella console, il percorso si applica a tutti Regioni AWS. Il percorso registra gli eventi di tutte le regioni del AWS esegue il partizionamento e consegna i file di log al bucket Amazon S3 specificato. Inoltre, puoi configurarne altri AWS servizi per analizzare ulteriormente e agire in base ai dati sugli eventi raccolti nei CloudTrail log. Per ulteriori informazioni, consulta gli argomenti seguenti:

Ogni evento o voce di log contiene informazioni sull'utente che ha generato la richiesta. Le informazioni di identità consentono di determinare quanto segue:

Per ulteriori informazioni, vedete l'CloudTrail userIdentityelemento.

Eventi relativi ai dati di Amazon Bedrock in CloudTrail

Gli eventi di dati forniscono informazioni sulle operazioni delle risorse eseguite su o in una risorsa (ad esempio, lettura o scrittura su un oggetto Amazon S3). Queste operazioni sono definite anche operazioni del piano dei dati. Gli eventi relativi ai dati sono spesso attività ad alto volume che CloudTrail non vengono registrate per impostazione predefinita.

Amazon Bedrock registra APIle operazioni di Amazon Bedrock Runtime (InvokeModel, InvokeModelWithResponseStreamConverse, eConverseStream) come eventi di gestione.

Amazon Bedrock registra tutte le azioni APIoperative di Agent for Amazon Bedrock Runtime CloudTrail come eventi relativi ai dati.

Dalla CloudTrail console, scegli l'alias dell'agente Bedrock o la knowledge base Bedrock per il tipo di evento Data. Puoi inoltre filtrare i campi eventName e resources.ARN scegliendo un modello di selettore di log personalizzato. Per ulteriori informazioni, consulta Registrazione degli eventi relativi ai dati con la console di gestione. AWS

Dal AWS CLI, imposta il resource.type valore uguale a AWS::Bedrock::AgentAliasAWS::Bedrock::KnowledgeBase, o AWS::Bedrock::FlowAlias e imposta eventCategory uguale aData. Per ulteriori informazioni, vedere Registrazione degli eventi relativi ai dati con AWS CLI.

L'esempio seguente mostra come configurare un trail per registrare tutti gli eventi relativi ai dati di Amazon Bedrock per tutti i tipi di risorse Amazon Bedrock nel 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 prompt 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"] }
    ]
  }
]'

Puoi inoltre filtrare i campi eventName eresources.ARN. Per ulteriori informazioni su questi campi, consulta AdvancedFieldSelector.

Per gli eventi di dati sono previsti costi aggiuntivi. Per ulteriori informazioni sui CloudTrail prezzi, consulta AWS CloudTrail Prezzi.

Eventi di gestione di Amazon Bedrock in CloudTrail

Gli eventi di gestione forniscono informazioni sulle operazioni di gestione eseguite sulle risorse del AWS conto. Queste operazioni sono note anche come operazioni sul piano di controllo. CloudTrail per impostazione predefinita, registra API le operazioni relative agli eventi di gestione.

Amazon Bedrock registra APIle operazioni di Amazon Bedrock Runtime (InvokeModel, InvokeModelWithResponseStreamConverse, eConverseStream) come eventi di gestione.

Amazon Bedrock registra il resto delle API operazioni di Amazon Bedrock come eventi di gestione. Per un elenco delle API operazioni Amazon Bedrock a cui Amazon Bedrock accede CloudTrail, consulta le seguenti pagine nel riferimento di Amazon Bedrock. API

Tutte le operazioni di Amazon Bedrock e API le operazioni di Agent for Amazon Bedrock API sono registrate CloudTrail e documentate in Amazon Bedrock Reference. API Ad esempio, le chiamate a InvokeModelStopModelCustomizationJob, e le CreateAgent azioni generano voci nei file di registro. CloudTrail

Amazon monitora e analizza GuardDuty continuamente la CloudTrail gestione e i registri degli eventi per rilevare potenziali problemi di sicurezza. Quando abiliti Amazon GuardDuty per un AWS account, avvia automaticamente l'analisi dei CloudTrail log per rilevare attività sospette in Amazon BedrockAPIs, ad esempio un utente che accede da una nuova posizione e utilizza Amazon Bedrock per APIs rimuovere Amazon Bedrock Guardrails o modificare il set di bucket Amazon S3 per i dati di addestramento dei modelli.

Informazioni sulle voci del file di log Amazon Bedrock

Un trail è una configurazione che consente la distribuzione di eventi come file di log in un bucket Amazon S3 specificato dall'utente. CloudTrail i file di registro contengono una o più voci di registro. Un evento rappresenta una singola richiesta proveniente da qualsiasi fonte e include informazioni sull'azione richiesta, la data e l'ora dell'azione, i parametri della richiesta e così via. CloudTrail i file di registro non sono una traccia stack ordinata delle API chiamate pubbliche, quindi non vengono visualizzati in un ordine specifico.

L'esempio seguente mostra una voce di CloudTrail registro che illustra l'InvokeModelazione.

{
    "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"
    }
}