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 la chiamata del modello utilizzando CloudWatch Logs e Amazon S3
Puoi utilizzare la registrazione delle chiamate del modello per raccogliere registri delle chiamate, dati di input del modello e dati di output del modello per tutte le chiamate Account AWS utilizzate in Amazon Bedrock in una regione.
Con la registrazione delle chiamate, puoi raccogliere i dati completi delle richieste, i dati di risposta e i metadati associati alle chiamate supportate eseguite nel tuo account in una regione. La registrazione di log può essere configurata per fornire le risorse di destinazione in cui verranno pubblicati i dati di log. Le destinazioni supportate includono Amazon CloudWatch Logs e Amazon Simple Storage Service (Amazon S3). Sono supportate solo le destinazioni dello stesso account e della stessa Regione.
Per impostazione predefinita, la registrazione di log delle invocazioni dei modelli è disabilitata. Dopo aver abilitato la registrazione di log delle invocazioni dei modelli, i log vengono archiviati fino all’eliminazione della configurazione della registrazione di log.
Le seguenti operazioni possono registrare i log delle invocazioni dei modelli.
Nota
La registrazione delle chiamate ai modelli è supportata solo per le chiamate effettuate tramite l'endpoint. bedrock-runtime Le chiamate effettuate tramite altri endpoint, come l'API Responses sull'bedrock-mantleendpoint, non vengono attualmente acquisite dalla registrazione delle chiamate.
Quando utilizzi l’API Converse, viene eseguita la registrazione di log di tutti i dati di immagine o documento che trasmetti in Amazon S3 (se hai abilitato la consegna e la registrazione di log delle immagini in Amazon S3).
Prima di poter abilitare la registrazione delle chiamate, devi configurare una destinazione Amazon S3 o Logs. CloudWatch Puoi abilitare la registrazione di log delle invocazioni tramite la console o l'API.
Argomenti
Configurazione di una destinazione Amazon S3
Nota
Quando si utilizza Amazon S3 come destinazione di registrazione, il bucket deve trovarsi nello stesso Account AWS e Regione AWS in quello in cui si sta creando la configurazione di registrazione delle invocazioni del modello.
Puoi configurare una destinazione S3 per la registrazione di log in Amazon Bedrock seguendo questi passaggi:
-
Crea un bucket S3 in cui verranno recapitati i log.
-
Aggiungi una bucket policy come quella riportata di seguito (sostituisci i valori per
accountId, e facoltativamente):regionbucketNameprefixNota
Una policy del bucket viene associata automaticamente al bucket per conto tuo quando configuri la registrazione di log con le autorizzazioni
S3:GetBucketPolicyeS3:PutBucketPolicy. -
(Facoltativo) Se esegui la configurazione SSE-KMS sul bucket, aggiungi la seguente politica sulla chiave 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:*" } } }
Nota
L'ACL del bucket deve essere disabilitata affinché la policy del bucket abbia effetto. Per ulteriori informazioni, consulta Disabilitare le ACL per tutti i nuovi bucket e applicare Object Ownership.
Configura una destinazione per i log CloudWatch
Puoi configurare una destinazione Amazon CloudWatch Logs per l'accesso ad Amazon Bedrock con i seguenti passaggi:
-
Crea un gruppo di CloudWatch log in cui verranno pubblicati i log.
-
Crea un ruolo IAM con le seguenti autorizzazioni per CloudWatch i registri.
Entità attendibile:
Policy del ruolo:
Per ulteriori informazioni sulla configurazione di SSE per i registri, consulta Crittografare i dati di registro in CloudWatch Logs using. CloudWatch AWS Key Management Service
Registrazione di log delle invocazioni dei modelli tramite la console
Per abilitare la registrazione delle invocazioni dei modelli
Accedi a Console di gestione AWS con un'identità IAM che dispone delle autorizzazioni per utilizzare la console Amazon Bedrock. Quindi, apri la console Amazon Bedrock all'indirizzo https://console.aws.amazon.com/bedrock
-
Dal riquadro di navigazione a sinistra, seleziona Impostazioni.
-
Nella pagina di registrazione delle chiamate del modello, selezionate Registrazione delle chiamate del modello. Verranno visualizzate impostazioni di configurazione aggiuntive per la registrazione.
-
Seleziona le modalità delle richieste e delle risposte di dati che desideri pubblicare nei log. È possibile selezionare qualsiasi combinazione delle seguenti opzioni di output:
-
Testo
-
Immagine
-
Embedding
-
Video
Nota
I dati verranno registrati per tutti i modelli che supportano le modalità (di input o output) scelte. Ad esempio, se selezionate Immagine, l'invocazione del modello verrà registrata per tutti i modelli che supportano l'input, l'output dell'immagine o entrambi.
-
-
Seleziona dove pubblicare i log:
-
Solo Amazon S3
-
CloudWatch Solo registri
-
Amazon S3 e Logs CloudWatch
-
Destinazioni di registrazione
Le destinazioni Amazon S3 e CloudWatch Logs sono supportate per log di invocazione e piccoli dati di input e output. Per dati di input e output di grandi dimensioni o per gli output di immagini binarie, è supportato solo Amazon S3. I seguenti dettagli riassumono il modo in cui i dati verranno rappresentati nella posizione di destinazione.
-
Destinazione S3: i file JSON compressi con Gzip, ciascuno contenente un batch di record del log delle invocazioni, vengono consegnati al bucket S3 specificato. Analogamente a un evento CloudWatch Logs, ogni record conterrà i metadati di invocazione e corpi JSON di input e output di dimensioni fino a 100 KB. I dati binari o il testo JSON con dimensioni superiori a 100 KB verranno caricati come singoli oggetti nel bucket Amazon S3 specificato con il prefisso "data". I dati possono essere interrogati utilizzando Amazon S3 Select e Amazon Athena e possono essere catalogati per ETL utilizzando AWS Glue. I dati possono essere caricati in OpenSearch servizio o elaborati da qualsiasi EventBridge destinazione Amazon.
-
CloudWatch Destinazione dei log: gli eventi del registro delle chiamate JSON vengono consegnati a un gruppo di log specificato in Logs. CloudWatch L'evento di log contiene i metadati di invocazione e il testo JSON di input e output con dimensione massima di 100 KB. Se viene fornita una posizione Amazon S3 per la distribuzione di grandi quantità di dati, nel bucket Amazon S3 verranno invece caricati dati binari o corpi JSON di dimensioni superiori a 100 KB con il prefisso data. I dati possono essere interrogati utilizzando CloudWatch Logs Insights e possono essere ulteriormente trasmessi a vari servizi in tempo reale utilizzando Logs. CloudWatch
Registrazione di log delle invocazioni dei modelli tramite l’API
La registrazione di log delle invocazioni dei modelli può essere configurata utilizzando le seguenti API:
Formato di immissione del log
Ogni voce del registro di chiamata è un oggetto JSON con la seguente struttura. Il formato è lo stesso sia per i CloudWatch Logs che per le destinazioni Amazon S3.
{ "schemaType": "ModelInvocationLog", "schemaVersion": "1.0", "timestamp": "2024-01-15T12:00:00Z", "accountId": "123456789012", "region": "us-east-1", "requestId": "abcd1234-5678-efgh-ijkl-mnopqrstuvwx", "operation": "Converse", "modelId": "anthropic.claude-sonnet-4-20250514-v1:0", "requestMetadata": { "team": "orchestrator", "environment": "production" }, "input": { "inputContentType": "application/json", "inputBodyJson": { }, "inputTokenCount": 25 }, "output": { "outputContentType": "application/json", "outputBodyJson": { }, "outputTokenCount": 150 } }
La tabella seguente descrive i campi di una voce di registro:
| Campo | Description |
|---|---|
schemaType |
Il tipo di record di registro. Sempre ModelInvocationLog. |
schemaVersion |
La versione dello schema di registro. |
timestamp |
L'ora in cui è stata effettuata la chiamata, in formato ISO 8601. |
accountId |
L' Account AWS ID che ha effettuato la chiamata. |
region |
Il Regione AWS luogo in cui è stata effettuata l'invocazione. |
requestId |
L'identificatore univoco della richiesta. |
operation |
L'operazione API chiamata (ad esempioConverse,InvokeModel). |
modelId |
L'ID del modello o l'ID del profilo di inferenza utilizzato per la chiamata. |
requestMetadata |
Un oggetto JSON opzionale di tag chiave-valore forniti dal chiamante. Presente solo quando il chiamante fornisce i metadati della richiesta. Per informazioni dettagliate, vedi Per-request etichettatura dei metadati. |
input.inputBodyJson |
Il corpo della richiesta inviato al modello (fino a 100 KB). I corpi più grandi vengono archiviati come oggetti separati in Amazon S3. |
input.inputTokenCount |
Il numero di token di input nella richiesta. |
output.outputBodyJson |
Il corpo della risposta del modello (fino a 100 KB). I corpi più grandi vengono archiviati come oggetti separati in Amazon S3. |
output.outputTokenCount |
Il numero di token di output nella risposta. |
Nota
I dati binari (come le immagini) e i corpi JSON di dimensioni superiori a 100 KB non vengono inclusi in linea nella voce di registro. Vengono invece archiviati come oggetti separati nel bucket Amazon S3 con il prefisso dei dati e la voce di registro contiene un riferimento alla posizione di Amazon S3.