View a markdown version of this page

Registri e metriche venduti - AWS DevOps Agente

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

  1. Apri la CloudWatch console.

  2. Nel pannello di navigazione, scegli Parametri quindi scegli Tutti i parametri.

  3. Scegli lo spazio dei nomi AWS/AIDevOps.

  4. 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

  1. Aprire la console AWS DevOps dell'agente nella console AWS di gestione.

  2. Nel pannello di navigazione scegli Impostazioni.

  3. Nella scheda Provider di capacità > Registri, scegli Configura.

  4. Per Tipo di destinazione, scegliete una delle seguenti opzioni:

  5. CloudWatch Registri: seleziona o crea un gruppo di registri.

  6. Amazon S3: inserisci l'ARN del bucket S3.

  7. Amazon Data Firehose: seleziona o crea un flusso di distribuzione Firehose.

  8. Per le impostazioni aggiuntive, facoltativo, puoi specificare le seguenti opzioni:

    1. 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.

    2. (Solo Amazon S3) Per Partizionamento, specifica il percorso per partizionare i dati del file di log.

    3. (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.

    4. Per Formato di output, specifica il formato preferito.

    5. Per Delimitatore di campo, specifica come separare i campi di log.

  9. Scegli Save (Salva).

  10. Verifica che lo stato della spedizione sia Attivo.

Per configurare la consegna dei log per uno spazio agente

  1. Aprire la console AWS DevOps dell'agente nella console AWS di gestione.

  2. Scegli lo spazio dell'agente che desideri configurare.

  3. Nella scheda Configurazione, scegli Configura.

  4. Per Tipo di destinazione, scegli una delle seguenti opzioni:

  5. CloudWatch Registri: seleziona o crea un gruppo di registri.

  6. Amazon S3: inserisci l'ARN del bucket S3.

  7. Amazon Data Firehose: seleziona o crea un flusso di distribuzione Firehose.

  8. Per le impostazioni aggiuntive, *opzionale*, puoi specificare le seguenti opzioni:

    1. 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.

    2. (Solo Amazon S3) Per Partizionamento, specifica il percorso per partizionare i dati del file di log.

    3. (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.

    4. Per Formato di output, specifica il formato preferito.

    5. Per Delimitatore di campo, specifica come separare i campi di log.

  9. Scegli Save (Salva).

  10. 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)

  1. Apri la console AWS DevOps dell'agente nella console AWS di gestione.

  2. 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).

  3. 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.

  4. Aggiorna la configurazione secondo necessità e scegli Salva.

Disabilita la consegna dei log (console)

  1. Apri la console AWS DevOps dell'agente nella console AWS di gestione.

  2. 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).

  3. 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.

  4. 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:

  1. Eliminare la consegna utilizzando DeleteDelivery.

  2. Elimina la fonte di consegna utilizzando DeleteDeliverySource.

  3. (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: