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à.
Registri e metriche venduti
Puoi monitorare gli spazi degli agenti e le operazioni di servizio utilizzando i CloudWatch parametri e i log di Amazon forniti. Questo argomento descrive le CloudWatch metriche che l' AWS DevOps agente pubblica automaticamente sul tuo account e i log forniti che puoi configurare per la consegna alle tue destinazioni preferite.
Metriche vendute CloudWatch
AWS DevOps L'agente pubblica automaticamente le metriche su Amazon CloudWatch nel tuo account. Queste metriche sono disponibili senza alcuna configurazione. È possibile utilizzarle per monitorare l'utilizzo, tenere traccia dell'attività operativa e creare allarmi.
Ruolo collegato ai servizi
Per far sì che i CloudWatch parametri Amazon vengano pubblicati nel tuo account per questo servizio, AWS DevOps Agent creerà automaticamente il ruolo collegato al servizio AWSServiceRoleForAIDevOps Service-Linked Role per te. Se il ruolo IAM che richiama l'API non dispone dell'autorizzazione appropriata, la creazione della risorsa avrà esito negativo con un. InvalidParameterException
Importante
I clienti che hanno creato il proprio ruolo AgentSpace prima del 13 marzo 2026 dovranno creare manualmente il ruolo collegato al servizio AWSServiceRoleForAIDevOps per pubblicare le CloudWatch metriche relative all' AWS DevOps agente nel proprio account.
Crea manualmente un ruolo collegato al servizio (per i clienti esistenti)
Esegui una delle seguenti operazioni:
Nella console IAM, crea il ruolo AWSServiceRoleForAIDevOps nel servizio AWS DevOps Agent.
Dalla AWS CLI, esegui il seguente comando:
aws iam create-service-linked-role --aws-service-name aidevops.amazonaws.com
Namespace
Tutte le metriche sono pubblicate nel namespace. AWS/AIDevOps
Dimensioni
Tutte le metriche includono la seguente dimensione.
| Dimensione | Description |
|---|---|
AgentSpaceUUID |
L'identificatore univoco dello spazio degli agenti. Per aggregare le metriche relative a tutti gli spazi degli agenti del tuo account, utilizza espressioni CloudWatch matematiche o ometti il filtro dimensionale. |
Riferimento per le metriche
| Nome parametro | Description | Unità | Frequenza di pubblicazione | Statistiche utili |
|---|---|---|---|---|
| ConsumedChatRequests | Il numero di richieste di chat consumate dallo spazio di un agente. Per ottenere il conteggio totale del tuo account, utilizza la SUM statistica per tutte le AgentSpaceUUID dimensioni. |
Conteggio | Ogni 5 minuti | Somma, media |
| ConsumedInvestigationTime | Il tempo impiegato a condurre indagini in uno spazio riservato agli agenti. | Secondi | Ogni 5 minuti | Somma, media, massimo |
| ConsumedEvaluationTime | Il tempo impiegato per eseguire le valutazioni in uno spazio dedicato agli agenti. | Secondi | Ogni 5 minuti | Somma, media, massimo |
| TopologyCompletionCount | Il numero di completamenti dell'elaborazione della topologia. AWS DevOps L'agente emette questa metrica al termine dell'elaborazione di una topologia, che si tratti della creazione iniziale durante l'onboarding, di un aggiornamento manuale o di un aggiornamento giornaliero pianificato. | Conteggio | Basato sugli eventi (emesso a ogni completamento) | Somma, SampleCount |
Visualizzazione delle metriche nella console CloudWatch
Apri la CloudWatch console
. Nel pannello di navigazione, scegli Parametri quindi scegli Tutti i parametri.
Scegli lo spazio dei nomi AWS/AIDevOps.
Scegli By AgentSpace per visualizzare le metriche relative agli spazi riservati agli agenti.
Nota
Puoi creare CloudWatch allarmi in base a queste metriche per ricevere notifiche quando l'utilizzo supera una soglia. Ad esempio, crea un allarme per monitorare il consumo delle ConsumedChatRequests richieste di chat.
Prerequisiti
Prima di configurare la consegna dei log, assicurati di disporre di quanto segue:
Un AWS account attivo con accesso alla console dell' AWS DevOps agente
Un preside IAM con autorizzazioni per la consegna dei CloudWatch log APIs
(Facoltativo) Un bucket Amazon S3 o un flusso di distribuzione Amazon Data Firehose, se prevedi di utilizzarli come destinazioni di log
Registri venduti
AWS DevOps L'agente supporta i log forniti che forniscono visibilità sugli eventi elaborati dagli spazi degli agenti e dalle registrazioni dei servizi. I registri venduti utilizzano l'infrastruttura Amazon CloudWatch Logs per consegnare i log alla destinazione preferita.
Per utilizzare i registri venduti, devi configurare una destinazione di consegna. Sono supportate le seguenti destinazioni:
Amazon CloudWatch Logs: un gruppo di log nel tuo account
Amazon S3: un bucket S3 nel tuo account
Amazon Data Firehose: un flusso di distribuzione di Firehose nel tuo account
Tipi di log supportati
È supportato un solo tipo di registro:. APPLICATION_LOGS Questo tipo di registro copre tutti gli eventi operativi emessi dal servizio.
Registra i tipi di eventi
La tabella seguente riepiloga gli eventi registrati dall' AWS DevOps agente.
| Event | Description | Livello di log |
|---|---|---|
| Evento in entrata dell'agente ricevuto | Un agente viene attivato da una fonte integrata e riceve un evento in entrata (ad esempio, un evento PagerDuty incidente). | INFO |
| L'evento in entrata dell'agente è stato interrotto | Un evento in entrata è stato eliminato prima che l'agente lo elaborasse. Il registro include il motivo (ad esempio, dati non validi). | TBD |
| Errore di comunicazione in uscita dell'agente | Una comunicazione in uscita con un'integrazione di terze parti non è riuscita. Il registro include l'ID dell'attività e l'identificatore di destinazione (ad esempio, un errore di autenticazione). | TBD |
| Creazione della topologia in coda | Un processo di creazione della topologia era in coda per l'elaborazione. | INFO |
| La creazione della topologia è iniziata | È iniziata l'elaborazione di un processo di creazione della topologia. | INFO |
| Creazione della topologia terminata | Elaborazione completata di un processo di creazione della topologia. Questo evento si applica alla creazione iniziale, agli aggiornamenti e agli aggiornamenti giornalieri. | INFO |
| Individuazione delle risorse non riuscita | Si è verificato un errore nell'individuazione delle risorse durante la creazione della topologia. | ERRORE |
| Registrazione del servizio non riuscita | La registrazione del servizio rileva un errore irreversibile | ERRORE |
| La convalida del webhook fallisce | Quando il webhook ricevuto dall'agente Devops non corrisponde allo schema previsto | ERRORE |
| Aggiornamenti dello stato di convalida dell'associazione | Quando si verifica un'associazione nello spazio di un agente ( primary/secondary account tipico), lo stato di convalida passa da valido a non valido e viceversa (ad esempio, a causa di un ruolo non valido, che non è ipotizzabile dal servizio). | ERRORE/INFORMAZIONI |
Permissions
AWS DevOps L'agente utilizza i registri CloudWatch venduti (autorizzazioni V2) per fornire i log. Per configurare la consegna dei log, il ruolo IAM che configura la consegna deve disporre delle seguenti autorizzazioni:
aidevops:AllowVendedLogDeliveryForResource— Necessario per consentire la consegna dei log per la risorsa dello spazio dell'agente.Autorizzazioni per la consegna CloudWatch dei log APIs (
logs:PutDeliverySource,logs:PutDeliveryDestinationlogs:CreateDelivery, e operazioni correlate).Autorizzazioni specifiche per la destinazione di consegna scelta.
Per la policy IAM completa richiesta per ogni tipo di destinazione, consulta i seguenti argomenti nella Amazon CloudWatch Logs User Guide:
Configura la consegna dei log (console)
AWS DevOps L'agente fornisce due posizioni nella console di AWS gestione per configurare la consegna dei log:
Pagina delle impostazioni di registrazione del servizio: configura la consegna dei log per gli eventi a livello di servizio. Questi log utilizzano il servizio ARN
arn:aws:aidevops:<region>:<account-id>:service/<account-id>() come risorsa.Pagina Agent Space: configura la consegna dei log per gli eventi specifici di un singolo spazio agente. Questi log utilizzano lo spazio agente ARN
arn:aws:aidevops:<region>:<account-id>:agentspace/<agent-space-id>() come risorsa.
Per configurare la consegna dei log per la registrazione di un servizio
Aprire la console AWS DevOps dell'agente nella console AWS di gestione.
Nel pannello di navigazione scegli Impostazioni.
Nella scheda Provider di capacità > Registri, scegli Configura.
Per Tipo di destinazione, scegliete una delle seguenti opzioni:
CloudWatch Registri: seleziona o crea un gruppo di registri.
Amazon S3: inserisci l'ARN del bucket S3.
Amazon Data Firehose: seleziona o crea un flusso di distribuzione Firehose.
Per le impostazioni aggiuntive, facoltativo, puoi specificare le seguenti opzioni:
Per Selezione del campo, seleziona i nomi dei campi di log che desideri consegnare alla destinazione. È possibile selezionare i campi del registro degli accessi e un sottoinsieme di campi del registro degli accessi in tempo reale.
(Solo Amazon S3) Per Partizionamento, specifica il percorso per partizionare i dati del file di log.
(Solo Amazon S3) Per Formato file compatibile con Hive, puoi selezionare la casella di controllo per utilizzare percorsi S3 compatibili con Hive. Questo consente di semplificare il caricamento di nuovi dati negli strumenti compatibili con Hive.
Per Formato di output, specifica il formato preferito.
Per Delimitatore di campo, specifica come separare i campi di log.
Scegli Save (Salva).
Verifica che lo stato della spedizione sia Attivo.
Per configurare la consegna dei log per uno spazio agente
Aprire la console AWS DevOps dell'agente nella console AWS di gestione.
Scegli lo spazio dell'agente che desideri configurare.
Nella scheda Configurazione, scegli Configura.
Per Tipo di destinazione, scegli una delle seguenti opzioni:
CloudWatch Registri: seleziona o crea un gruppo di registri.
Amazon S3: inserisci l'ARN del bucket S3.
Amazon Data Firehose: seleziona o crea un flusso di distribuzione Firehose.
Per le impostazioni aggiuntive, *opzionale*, puoi specificare le seguenti opzioni:
Per Selezione del campo, seleziona i nomi dei campi di log che desideri consegnare alla destinazione. È possibile selezionare i campi del registro degli accessi e un sottoinsieme di campi del registro degli accessi in tempo reale.
(Solo Amazon S3) Per Partizionamento, specifica il percorso per partizionare i dati del file di log.
(Solo Amazon S3) Per Formato file compatibile con Hive, puoi selezionare la casella di controllo per utilizzare percorsi S3 compatibili con Hive. Questo consente di semplificare il caricamento di nuovi dati negli strumenti compatibili con Hive.
Per Formato di output, specifica il formato preferito.
Per Delimitatore di campo, specifica come separare i campi di log.
Scegli Save (Salva).
Verifica che lo stato della spedizione sia Attivo.
Configura la consegna dei log (CloudWatch API)
Puoi anche utilizzare l'API CloudWatch Logs per configurare la consegna dei log a livello di codice. Una consegna di log funzionante è composta da tre elementi:
A DeliverySource— Rappresenta la risorsa spaziale AWS DevOps dell'agente che genera i log.
A DeliveryDestination— Rappresenta la destinazione in cui vengono scritti i log.
Una consegna: collega un'origine di consegna a una destinazione di consegna.
Fase 1: Creare una fonte di consegna
Usa l'PutDeliverySourceoperazione per creare una fonte di consegna. Passa l'ARN della tua risorsa di spazio AWS DevOps Agent e specifica APPLICATION_LOGS come tipo di registro.
L'esempio seguente crea una fonte di consegna per uno spazio agente:
{ "name": "my-agent-space-delivery-source", "resourceArn": "arn:aws:aidevops:us-east-1:123456789012:agentspace/my-agent-space-id", "logType": "APPLICATION_LOGS" }
L'esempio seguente crea una fonte di consegna per il servizio:
{ "name": "my-service-delivery-source", "resourceArn": "arn:aws:aidevops:us-east-1:123456789012:service", "logType": "APPLICATION_LOGS" }
Fase 2: Creare una destinazione di consegna
Usa l'PutDeliveryDestinationoperazione per configurare dove vengono archiviati i log. Puoi scegliere Amazon CloudWatch Logs, Amazon S3 o Amazon Data Firehose.
L'esempio seguente crea una CloudWatch destinazione Logs:
{ "name": "my-cwl-destination", "deliveryDestinationConfiguration": { "destinationResourceArn": "arn:aws:logs:us-east-1:123456789012:log-group:/aws/aidevops/my-agent-space" }, "outputFormat": "json" }
L'esempio seguente crea una destinazione Amazon S3:
{ "name": "my-s3-destination", "deliveryDestinationConfiguration": { "destinationResourceArn": "arn:aws:s3:::my-aidevops-logs-bucket" }, "outputFormat": "json" }
L'esempio seguente crea una destinazione Amazon Data Firehose:
{ "name": "my-firehose-destination", "deliveryDestinationConfiguration": { "destinationResourceArn": "arn:aws:firehose:us-east-1:123456789012:deliverystream/my-aidevops-log-stream" }, "outputFormat": "json" }
Nota
Se spedisci i log su più account, devi utilizzarli PutDeliveryDestinationPolicynell'account di destinazione per autorizzare la consegna.
Se desideri utilizzare CloudFormation, puoi utilizzare quanto segue:
ResourceArn è AgentSpaceArn e LogType deve essere APPLICATION_LOGS come tipo di log supportato.
Fase 3: Creare una consegna
Utilizza l'CreateDeliveryoperazione per collegare l'origine di consegna alla destinazione di consegna.
{ "deliverySourceName": "my-agent-space-delivery-source", "deliveryDestinationArn": "arn:aws:logs:us-east-1:123456789012:delivery-destination:my-cwl-destination" }
AWS CloudFormation
È inoltre possibile configurare la consegna dei log utilizzando AWS CloudFormation le seguenti risorse:
ResourceArnImpostato sullo spazio AWS DevOps agente o sull'ARN del servizio e impostato suLogType. APPLICATION_LOGS
Riferimento allo schema di log
AWS DevOps L'agente utilizza uno schema di registro condiviso per tutti i tipi di eventi. Non tutti gli eventi di registro utilizzano tutti i campi.
La tabella seguente descrive i campi dello schema di registro.
| Campo | Tipo | Description |
|---|---|---|
| event_timestamp | Long | Timestamp Unix di quando si è verificato l'evento |
| resource_arn | Stringa | ARN della risorsa che ha generato l'evento |
| optional_account_id | Stringa | AWS ID dell'account associato al registro. |
| livello_opzionale | Stringa | Livello di registro:, INFO WARN ERROR |
| opzionale_agent_space_id | Stringa | Identificatore dello spazio dell'agente. |
| id_associazione_opzionale | Stringa | Identificatore di associazione per il registro. |
| opzionale_status | Stringa | Stato dell'operazione di topologia. |
| opzionale_webhook_id | Stringa | Identificatore Webhook. |
| opzionale_mcp_endpoint_url | Stringa | URL dell'endpoint del server MCP |
| tipo_di_servizio opzionale | Stringa | Tipo di servizio:,,,,. DYNATRACE DATADOG GITHUB SLACK SERVICENOW |
| opzionale_service_endpoint_url | Stringa | URL dell'endpoint per integrazioni di terze parti. |
| id_servizio_opzionale | Stringa | Identificatore della fonte. |
| request_id | Stringa | Richiedi l'identificatore per la correlazione AWS CloudTrail o i ticket di assistenza. |
| operazione_opzionale | Stringa | Nome dell'operazione che è stata eseguita. |
| optional_task_type | Stringa | Tipo di attività Agent Backlog: o INVESTIGATION EVALUATION |
| optional_task_id | Stringa | Identificatore dell'attività di backlog di Agent Backlog Task. IDAgent |
| referenza_opzionale | Stringa | Riferimento tratto da un'attività di agente (ad esempio, un ticket Jira). |
| tipo_errore_opzionale | Stringa | Tipi di errore |
| messaggio_errore_opzionale | Stringa | Descrizione dell'errore quando un'operazione fallisce. |
| optional_details | Stringa (JSON) | Payload di eventi specifico del servizio che contiene i parametri e i risultati delle operazioni. |
Gestisci e disabilita la consegna dei log
È possibile modificare o rimuovere la consegna dei log in qualsiasi momento dalla console dell' AWS DevOps agente nella console di AWS gestione o utilizzando l'API CloudWatch Logs.
Gestisci la consegna dei log (console)
Apri la console AWS DevOps dell'agente nella console AWS di gestione.
Passare alla pagina Impostazioni (per i registri a livello di servizio) o alla pagina specifica di Agent Space (per i registri a livello di Agent Space).
Nella scheda Configurazione (per i log a livello di Agent Space) o nella scheda Capability Provider > Logs (per i log a livello di servizio), scegli la consegna da modificare.
Aggiorna la configurazione secondo necessità e scegli Salva.
Disabilita la consegna dei log (console)
Apri la console AWS DevOps dell'agente nella console AWS di gestione.
Passare alla pagina Impostazioni (per i registri a livello di servizio) o alla pagina specifica di Agent Space (per i registri a livello di Agent Space).
Nella scheda Configurazione (per i log a livello di Agent Space) o nella scheda Capability Provider > Logs (per i log a livello di servizio), seleziona la consegna da rimuovere.
Scegli Elimina e conferma.
Disabilita la consegna dei log (API)
Per rimuovere una consegna di log utilizzando l'API, elimina le risorse nel seguente ordine:
Eliminare la consegna utilizzando DeleteDelivery.
Elimina la fonte di consegna utilizzando DeleteDeliverySource.
(Facoltativo) Se la destinazione di consegna non è più necessaria, eliminala utilizzando DeleteDeliveryDestination.
Importante
L'utente è responsabile della rimozione delle risorse di consegna dei log dopo aver eliminato la risorsa dello spazio agente che genera i log (ad esempio, dopo aver eliminato uno spazio agente). Se non rimuovi queste risorse, le configurazioni di consegna potrebbero rimanere orfane.
Prezzi
L' AWS DevOps agente non addebita alcun costo per l'abilitazione dei registri venduti. Tuttavia, potrebbero essere addebitati costi per la consegna, l’acquisizione, l’archiviazione o l’accesso, a seconda della destinazione di consegna dei log selezionata. Per i dettagli sui prezzi, consulta Vented Logs nella scheda Logs di Amazon Pricing. CloudWatch
Per i prezzi specifici della destinazione, consulta quanto segue: