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à.
# Monitoraggio dell'integrità operativa delle applicazioni con Application Signals
Usa Application Signals all'interno della [CloudWatch console](https://console.aws.amazon.com/cloudwatch/) per monitorare e risolvere i problemi relativi allo stato operativo delle tue applicazioni:
+ **Monitora i servizi delle applicazioni**: nell'ambito del monitoraggio operativo quotidiano, utilizza la pagina [Servizi](Services-page.md) per visualizzare un riepilogo di tutti i tuoi servizi. Visualizza i servizi con il tasso di errore o la latenza più elevati e scopri quali servizi presentano indicatori di [livello di servizio](CloudWatch-ServiceLevelObjectives.md) non integri (). SLIs Seleziona un servizio per aprire la pagina dei [dettagli del servizio](ServiceDetail.md) e visualizzare parametri dettagliati, operazioni di servizio, canary Synthetics e richieste client. Questo può aiutarti a identificare la causa principale dei problemi operativi e risolverli.
+ **Ispeziona la topologia dell'applicazione**: utilizza la [Mappa dell'applicazione](ServiceMap.md) per comprendere e monitorare la topologia dell'applicazione nel tempo, comprese le relazioni tra client, canary synthetics, servizi e dipendenze. Visualizza istantaneamente lo stato dell'indicatore del livello di servizio (SLI) e visualizza i parametri chiave come il volume delle chiamate, la frequenza di errore e la latenza. Esplora e ottieni informazioni più dettagliate nella pagina dei [dettagli del servizio](ServiceDetail.md).
Osserva uno [scenario di esempio](Services-example-scenario.md) che dimostra come queste pagine possono essere utilizzate per risolvere rapidamente un problema di integrità del servizio operativo, a partire dal rilevamento iniziale fino all'identificazione della causa principale.
**In che modo Application Signals consente il monitoraggio dello stato operativo**
Dopo aver [abilitato l'applicazione](CloudWatch-Application-Signals-Enable.md) per Application Signals, i servizi dell'applicazione e le relative dipendenze vengono rilevati automaticamente e visualizzati nelle pagine **Servizi**, **Dettagli del servizio** e Mappa **dell'applicazione**. APIs Application Signals raccoglie informazioni da più fonti per consentire il rilevamento servizi e il monitoraggio dello stato operativo:
+ [AWS Distro for OpenTelemetry (ADOT)](CloudWatch-Application-Signals-supportmatrix.md): come parte dell'abilitazione dei segnali di applicazione, le librerie di strumentazione automatica OpenTelemetry Java e Python sono configurate per emettere metriche e tracce raccolte dall'agente. CloudWatch I parametri e le tracce vengono utilizzati per consentire l'individuazione di servizi, operazioni, dipendenze e altre informazioni sui servizi.
+ Obiettivi [a livello di servizio (SLOs): dopo aver creato gli obiettivi](CloudWatch-ServiceLevelObjectives.md) del livello di servizio per i servizi, le pagine Servizi, Dettagli del servizio e Mappa delle applicazioni mostrano lo stato dell'indicatore del livello di servizio (SLI). SLIs può monitorare la latenza, la disponibilità e altre metriche operative.
+ CloudWatch Canari [Synthetics](CloudWatch_Synthetics_Canaries.md): quando configuri il tracciamento a raggi X sui tuoi canarini, le chiamate ai tuoi servizi dagli script Canary vengono associate al servizio e visualizzate nella pagina dei dettagli del servizio.
+ [CloudWatch Monitoraggio degli utenti in tempo reale (RUM)](CloudWatch-RUM.md): quando il tracciamento X-Ray è abilitato sul client web CloudWatch RUM, le richieste ai servizi vengono automaticamente associate e visualizzate nella pagina dei dettagli del servizio.
+ [AWS Service Catalog AppRegistry](https://docs.aws.amazon.com/servicecatalog/latest/arguide/intro-app-registry.html)— Application Signals rileva automaticamente AWS le risorse all'interno del tuo account e ti consente di raggrupparle in applicazioni logiche create in. AppRegistry Il nome dell'applicazione visualizzato nella pagina Servizi si basa sulla risorsa di calcolo sottostante su cui sono in esecuzione i servizi.
**Nota**
Application Signals visualizza i servizi e le operazioni in base ai parametri e alle tracce emesse all'interno del filtro temporale corrente scelto. (Per impostazione predefinita, si tratta delle ultime tre ore). Se non è presente alcuna attività all'interno del filtro temporale corrente per un servizio, un'operazione, una dipendenza, canary Synthetics o pagina client, non sarà visibile.
È possibile visualizzare fino a 1.000 servizi. L'individuazione dei servizi e della topologia dei servizi potrebbe impiegare fino a 10 minuti. La valutazione dello stato dell'indicatore del livello di servizio (SLI) potrebbe impiegare fino a 15 minuti.
**Nota**
Attualmente, la console Application Signals supporta solo la scelta di un massimo di 1 giorno in un intervallo di tempo di 30 giorni.
# Visualizzazione generale dell'attività e dello stato operativo del servizio tramite la pagina Servizi
Utilizza la pagina Servizi per visualizzare un elenco dei tuoi servizi [abilitati per Application Signals](CloudWatch-Application-Signals-Enable.md). Puoi anche visualizzare le metriche operative e vedere rapidamente quali servizi presentano indicatori di livello di servizio non integri (). SLIs Analizza le anomalie nelle prestazioni e identifica la causa principale dei problemi operativi. Per visualizzare questa pagina, apri la [CloudWatch console](https://console.aws.amazon.com/cloudwatch/) e scegli **Servizi** nella sezione **Application Signals** nel riquadro di navigazione a sinistra.
Per i servizi non strumentati, la pagina di panoramica dei servizi mostra informazioni limitate, tra cui spicca la strumentazione calls-to-action per abilitare la strumentazione Application Signals.
## Esplora i parametri di integrità operativa per i tuoi servizi
La parte superiore della pagina Servizi include un grafico dell'integrità operativa generale del servizio e diverse tabelle che mostrano i servizi principali, le dipendenze dei servizi in base al tasso di guasto e un elenco dei servizi. Il grafico dei Servizi a sinistra mostra una suddivisione del numero di servizi con indicatori del livello di servizio integri o non integri (SLIs) durante il filtro temporale a livello di pagina corrente. SLIs può monitorare la latenza, la disponibilità e altre metriche operative. Visualizza i servizi principali per tasso di guasto nelle due tabelle accanto al grafico. Seleziona un nome del servizio in entrambe le tabelle per aprire la [pagina dei dettagli del servizio](ServiceDetail.md), che mostra informazioni dettagliate sulle operazioni di servizio. Seleziona un percorso di dipendenza per visualizzare i dettagli sulla dipendenza del servizio nella relativa pagina di dettaglio.
Entrambe le tabelle mostrano informazioni relative alle ultime tre ore, anche se viene scelto un filtro per periodi di tempo più lunghi in alto a destra della pagina.
Quando si utilizza il raggruppamento dinamico dei servizi, le metriche di integrità operativa aggregano automaticamente i dati di tutti i servizi all'interno di ciascun gruppo. Questo fornisce:
+ Tassi di guasto consolidati per i gruppi di servizi
+ Stato di integrità SLI a livello di gruppo
+ Metriche aggregate delle prestazioni, che aiutano a identificare i cluster di servizi problematici
+ Identificazione rapida dei gruppi che richiedono attenzione immediata durante gli incidenti
![\[CloudWatch I migliori grafici dei servizi\]](http://docs.aws.amazon.com/it_it/AmazonCloudWatch/latest/monitoring/images/services-top-graphs.png)
## Monitoraggio dell'integrità operativa con la tabella Servizi
La pagina Servizi mostra un elenco dei tuoi servizi abilitati per Application Signals. Scegli **Abilita Application Signals** per aprire una pagina di configurazione e iniziare a configurare i servizi. Per ulteriori informazioni, consulta [Abilitazione di Application Signals](CloudWatch-Application-Signals-Enable.md).
Filtra la tabella Servizi per trovare facilmente ciò che cerchi, scegliendo una o più proprietà dalla casella di testo del filtro. Quando scegli una proprietà, una procedura ti guida attraverso i criteri di filtro. Vedrai il filtro completo sotto la casella di testo del filtro. Seleziona **Cancella filtri** in qualsiasi momento per rimuovere il filtro della tabella.
Le opzioni di filtro avanzate consentono di:
+ Filtrare per gruppi di servizi (raggruppamenti predefiniti e personalizzati)
+ Filtrare per attività di implementazione recente
+ Filtra per piattaforma
+ Filtra per SLI Health
+ Filtra per ID account (nelle configurazioni di osservabilità tra più account)
+ Filtra per stato della strumentazione (strumentata o non strumentata)
+ Filtrare per ambiente
+ Filtrare per stato di integrità del servizio
![\[CloudWatch Tabella dei servizi\]](http://docs.aws.amazon.com/it_it/AmazonCloudWatch/latest/monitoring/images/services-table-healthy-updated.png)
Per i servizi non strumentati, la pagina di panoramica dei servizi mostra informazioni limitate, tra cui spicca la strumentazione calls-to-action per abilitare la strumentazione Application Signals. I servizi non strumentati vengono visualizzati nella tabella Servizi anche quando non sono stati configurati con Application Signals, il che consente di identificare le lacune nella copertura di osservabilità e di dare priorità ai servizi da utilizzare successivamente in base alla loro posizione nell'architettura.
Scegli il nome di qualsiasi servizio nella tabella per visualizzare una [pagina dei dettagli del servizio](ServiceDetail.md) contenente parametri a livello di servizio, operazioni e dettagli aggiuntivi. [Se hai associato la risorsa di elaborazione sottostante del servizio a un'applicazione AppRegistry o alla scheda Applicazioni nella Console di gestione AWS home page, scegli il nome dell'applicazione per visualizzare i dettagli dell'applicazione nella pagina della console MyApplications.](https://docs.aws.amazon.com/awsconsolehelpdocs/latest/gsg/aws-myApplications.html) Per i servizi ospitati in Amazon EKS, scegli qualsiasi link **nella colonna Hosted in** per visualizzare Cluster, Namespace o carico di lavoro all'interno CloudWatch di Container Insights. Per i servizi in esecuzione su Amazon ECS o Amazon EC2, viene mostrato il valore dell'ambiente.
Lo stato [dell'indicatore del livello di servizio (SLI)](CloudWatch-ServiceLevelObjectives.md#CloudWatch-ServiceLevelObjectives-concepts) viene visualizzato per ogni servizio nella tabella. Scegli lo stato SLI di un servizio per visualizzare un pop-up contenente un link a qualsiasi pagina non SLIs integra e un link per visualizzare tutte le SLOs informazioni relative al servizio.
![\[Servizio con SLI non integro\]](http://docs.aws.amazon.com/it_it/AmazonCloudWatch/latest/monitoring/images/services-unhealthy-sli.png)
**Se non SLOs ne è stato creato nessuno per un servizio, scegli il pulsante **Crea SLO** nella colonna Stato SLI.** Per crearne di aggiuntivi SLOs per qualsiasi servizio, seleziona il pulsante di opzione accanto al nome del servizio, quindi scegli **Crea SLO** in alto a destra della tabella. Quando crei SLOs, puoi vedere a colpo d'occhio quali dei tuoi servizi e operazioni stanno funzionando bene e quali non lo sono. Per ulteriori informazioni, consulta [gli obiettivi del livello di servizio (SLOs)](CloudWatch-ServiceLevelObjectives.md).
## Panoramica del servizio
Dopo aver selezionato un servizio dalla tabella Servizi, viene visualizzata la pagina di panoramica dei servizi. Questa pagina fornisce una visione completa delle metriche relative allo stato operativo e alle prestazioni del servizio. La panoramica mostra queste metriche riassuntive:
+ Operazioni totali
+ Dipendenze del servizio
+ Stato di monitoraggio di Canary
+ Dati del client RUM
Queste metriche forniscono informazioni immediate sullo stato attuale del servizio.
È possibile visualizzare gli indicatori chiave delle prestazioni operative nel tempo utilizzando una serie di grafici. Per analizzare le tendenze e identificare potenziali problemi che influiscono sullo stato del servizio, modifica il filtro temporale. Tutti i grafici si aggiornano automaticamente per riflettere i dati per il periodo di tempo selezionato.
La sezione Risultati dell'audit rileva e mostra automaticamente i problemi critici relativi al comportamento del servizio, quindi non è necessario indagare manualmente. Application Signals analizza le applicazioni per segnalare osservazioni significative e potenziali problemi, semplificando l'analisi delle cause principali. Questi risultati automatizzati consolidano le tracce pertinenti, eliminando la necessità di navigare attraverso più clic. Il sistema di audit aiuta i team a identificare rapidamente i problemi e le loro cause sottostanti, consentendo una risoluzione più rapida dei problemi.
È possibile utilizzare la sezione Eventi di modifica per identificare in che modo le implementazioni o le modifiche alla configurazione recenti influiscono sul comportamento del servizio. Application Signals elabora automaticamente CloudTrail gli eventi per tenere traccia degli eventi di modifica nell'applicazione. Monitora gli eventi di configurazione e distribuzione dei servizi e delle relative dipendenze, fornendo un contesto immediato per l'analisi operativa e la risoluzione dei problemi. Application Signals correla automaticamente i tempi di implementazione con le variazioni delle prestazioni, aiutandoti a identificare rapidamente se le ultime implementazioni stanno causando problemi di servizio.
![\[Panoramica del servizio\]](http://docs.aws.amazon.com/it_it/AmazonCloudWatch/latest/monitoring/images/Service_detail.png)
# Visualizzazione dell'attività dettagliata del servizio e dell'integrità operativa tramite la pagina dei dettagli del servizio
Quando strumentalizzi la tua [ CloudWatch applicazione, Amazon Application Signals](CloudWatch-Application-Monitoring-Sections.md) mappa tutti i servizi rilevati dall'applicazione. Utilizza la pagina dei dettagli del servizio per visualizzare una panoramica dei servizi, delle operazioni, delle dipendenze, dei canary e delle richieste client per un singolo servizio. Per visualizzare la pagina dei dettagli del servizio, effettua le seguenti operazioni:
+ Apri la [CloudWatch console](https://console.aws.amazon.com/cloudwatch/).
+ Scegli **Servizi** nella sezione **Application Signals** nel pannello di navigazione a sinistra.
+ Scegli il nome di qualsiasi servizio dalle tabelle **Servizi**, **Servizi principali** o dipendenze.
In **schedule-visits**, vedrai l'etichetta e l'ID dell'account sotto il nome del servizio.
La pagina dei dettagli del servizio è organizzata nelle seguenti schede:
+ [Panoramica](#ServiceDetail-overview): utilizza questa scheda per visualizzare una panoramica di un determinato servizio, incluso il numero di operazioni, dipendenze, synthetics e pagine client. La scheda mostra le metriche chiave per l'intero servizio, le operazioni principali e le dipendenze. Queste metriche includono dati di serie temporali su latenza, guasti ed errori in tutte le operazioni di servizio relative a quel servizio.
+ [Operazioni di servizio](#ServiceDetail-operations): utilizza questa scheda per visualizzare un elenco delle operazioni chiamate dal servizio e grafici interattivi con le metriche chiave che misurano l'integrità di ciascuna operazione. Puoi selezionare un punto dati in un grafico per ottenere informazioni su tracce, log o metriche associate a quel punto dati.
+ [Dipendenze](#ServiceDetail-dependencies): questa scheda mostra un elenco delle dipendenze chiamate dal servizio e un elenco delle metriche di tali dipendenze.
+ [Canary synthetics](#ServiceDetail-canaries): utilizza questa scheda per visualizzare un elenco di canary synthetics che simulano le chiamate degli utenti al servizio e le metriche chiave delle prestazioni relative a tali canary.
+ [Pagine client](#ServiceDetail-clientpages): utilizza questa scheda per visualizzare un elenco delle pagine client che chiamano il servizio e le metriche che misurano la qualità delle interazioni client con la tua applicazione.
+ [Metriche correlate](#ServiceDetail-relatedmetrics): utilizza questa scheda per correlare le metriche correlate, ad esempio metriche standard, metriche di runtime e metriche personalizzate per un servizio, le sue operazioni o le sue dipendenze.
## Visualizzazione della panoramica del servizio
Utilizza la pagina Panoramica del servizio per visualizzare un riepilogo di alto livello delle metriche per tutte le operazioni di servizio in un'unica posizione. Controlla le prestazioni di tutte le operazioni, le dipendenze, le pagine client e i canary synthetics che interagiscono con l'applicazione. Utilizza queste informazioni per determinare dove concentrare gli sforzi per identificare i problemi, risolvere gli errori e individuare le opportunità di ottimizzazione.
Scegli un collegamento in **Dettagli del servizio** per visualizzare le informazioni relative a un servizio specifico. Ad esempio, per i servizi ospitati in Amazon EKS, la pagina dei dettagli del servizio mostra informazioni su **cluster**, **namespace** e **carico di lavoro**. Per i servizi ospitati in Amazon ECS o Amazon EC2, la pagina dei dettagli del servizio mostra il valore **Ambiente**.
In **Servizi**, la scheda **Panoramica** mostra un riepilogo di quanto segue:
+ Operazioni: utilizza questa scheda per visualizzare lo stato delle operazioni di servizio. Lo stato di integrità è determinato dagli indicatori del livello di servizio (SLI) definiti come parte di un [obiettivo del livello di servizio](CloudWatch-ServiceLevelObjectives.md) (SLO).
+ Dipendenze: utilizza questa scheda per visualizzare le principali dipendenze dei servizi richiamati dall'applicazione, elencate in base al tasso di guasto, e per visualizzare l'integrità delle dipendenze del servizio. Lo stato di integrità è determinato dagli indicatori del livello di servizio (SLI) definiti come parte di un obiettivo del livello di servizio (SLO).
+ Synthetics canaries: utilizza questa scheda per visualizzare il risultato di chiamate simulate agli endpoint APIs o associate al servizio e il numero di canarini non riusciti.
+ Pagine client: utilizzate questa scheda per visualizzare le pagine principali richiamate dai client con errori asincroni JavaScript e XML (AJAX).
La figura seguente mostra una panoramica dei tuoi servizi:
![\[Widget Panoramica del servizio\]](http://docs.aws.amazon.com/it_it/AmazonCloudWatch/latest/monitoring/images/service-detail-widgets.png)
La scheda **Panoramica** mostra anche un grafico delle dipendenze con la latenza più elevata tra tutti i servizi. Utilizza le metriche di latenza **p99**, **p90** e **p50** per valutare rapidamente quali dipendenze contribuiscono alla latenza totale del servizio, come segue:
![\[Grafico della latenza delle operazioni di servizio\]](http://docs.aws.amazon.com/it_it/AmazonCloudWatch/latest/monitoring/images/service-detail-latency.png)
Ad esempio, il grafico precedente mostra che il 99% delle richieste fatte alla dipendenza **customer-service** sono state completate in circa 4.950 millisecondi. Le altre dipendenze hanno richiesto meno tempo.
I grafici che mostrano le quattro operazioni di servizio principali per latenza mostrano il volume di richieste, la disponibilità, il tasso di guasto e il tasso di errore per tali servizi, come illustrato nella figura seguente:
![\[Grafici del volume, della disponibilità, del tasso di guasto e del tasso di errore delle operazioni di servizio\]](http://docs.aws.amazon.com/it_it/AmazonCloudWatch/latest/monitoring/images/service-detail-operations-graphs.png)
La sezione **Dettagli del servizio** mostra i dettagli del servizio, inclusi **ID account** ed **Etichetta dell'account**.
## Visualizzazione delle operazioni del servizio
Quando instrumenti la tua applicazione, [Application Signals](CloudWatch-Application-Monitoring-Sections.md) rileva tutte le operazioni di servizio chiamate dall'applicazione. Utilizza la scheda **Operazioni di servizio** per visualizzare una tabella che contiene le operazioni di servizio e un insieme di metriche che misurano le prestazioni di un'operazione selezionata. Queste metriche includono lo stato SLI, il numero di dipendenze, il volume, guasti, errori e disponibilità, come illustrato nella figura seguente:
![\[Tabella delle operazioni del servizio\]](http://docs.aws.amazon.com/it_it/AmazonCloudWatch/latest/monitoring/images/service-operations-table.png)
Filtra la tabella per trovare facilmente un'operazione di servizio scegliendo una o più proprietà dalla casella di testo del filtro. Quando scegli una proprietà, una procedura ti guida attraverso i criteri di filtro e vedrai il filtro completo sotto la casella di testo del filtro. Seleziona **Cancella filtri** in qualsiasi momento per rimuovere il filtro della tabella.
Scegliete lo stato SLI di un'operazione per visualizzare un popup contenente un collegamento a qualsiasi SLI non funzionante e un collegamento SLOs per visualizzare tutte le informazioni relative all'operazione, come mostrato nella tabella seguente:
![\[Stato SLI dell'operazione del servizio\]](http://docs.aws.amazon.com/it_it/AmazonCloudWatch/latest/monitoring/images/service-operation-unhealthy-slo.png)
La tabella delle operazioni di servizio elenca lo stato SLI, il numero di SLI integri o non SLIs integri e il numero totale di per ciascuna operazione. SLOs
Viene utilizzata SLIs per monitorare la latenza, la disponibilità e altre metriche operative che misurano lo stato operativo di un servizio. Utilizza uno SLO per verificare le prestazioni e lo stato di integrità dei tuoi servizi e delle tue operazioni.
Per creare uno SLO, procedi come descritto di seguito:
+ Se un'operazione non dispone di uno SLO, seleziona il pulsante **Crea SLO** nella colonna **Stato SLI**.
+ Se un'operazione dispone già di uno SLO, procedi come indicato di seguito:
+ Seleziona il pulsante di opzione accanto al nome dell'operazione.
+ Scegli **Crea SLO** dalla freccia rivolta verso il basso **Operazioni** in alto a destra della tabella.
Per ulteriori informazioni, consulta [gli obiettivi del livello di servizio () SLOs](CloudWatch-ServiceLevelObjectives.md).
La colonna **Dipendenze** mostra il numero di dipendenze chiamate da questa operazione. Seleziona questo numero per aprire la scheda **Dipendenze** filtrata in base all'operazione selezionata.
### Visualizzazione delle metriche delle operazioni di servizio, delle tracce correlate e dei log dell'applicazione
Application Signals mette in correlazione le metriche operative del servizio con AWS X-Ray trace, CloudWatch [Container Insights](ContainerInsights.md) e registri delle applicazioni. Utilizza queste metriche per risolvere i problemi di integrità operativa. Per visualizzare le metriche come informazioni grafiche, procedi come indicato di seguito:
1. Seleziona un'operazione di servizio nella tabella **Operazioni di servizio** per visualizzare un insieme di grafici per l'operazione selezionata sopra la tabella con le metriche per **Volume e disponibilità**, **Latenza** e **Guasti ed errori**.
1. Passa il mouse su un punto in un grafico per visualizzare ulteriori informazioni.
1. Seleziona un punto per aprire un pannello di diagnostica che mostra le tracce correlate, le metriche e i log dell'applicazione per il punto selezionato nel grafico.
L'immagine seguente mostra il suggerimento che appare dopo aver passato il mouse su un punto del grafico e il pannello di diagnostica che appare dopo aver fatto clic su un punto. Il suggerimento contiene informazioni sul punto dati associato nel grafico **Guasti ed errori**. Il pannello contiene **Tracce correlate**, **Collaboratori principali** e **Log dell'applicazione** associati al punto selezionato.
![\[Tracce correlate per guasti ed errori\]](http://docs.aws.amazon.com/it_it/AmazonCloudWatch/latest/monitoring/images/service-detail-correlated-traces.png)
#### Tracce correlate
Osserva le tracce correlate per comprendere un problema di fondo relativo a una traccia. Puoi verificare se le tracce correlate o gli eventuali nodi di servizio a esse associati si comportano in modo simile. Per esaminare le tracce correlate, scegli un **ID traccia** dalla tabella **Tracce correlate** per aprire la pagina [Dettagli della traccia X-Ray](https://docs.aws.amazon.com/xray/latest/devguide/xray-console-traces.html) relativa. La pagina dei dettagli della traccia contiene una mappa dei nodi del servizio associati alla traccia selezionata e una sequenza temporale dei segmenti di traccia.
#### Collaboratori principali
Visualizza i collaboratori principali per trovare le principali origini di input per una metrica. Raggruppa i collaboratori in base ai diversi componenti per cercare le somiglianze all'interno del gruppo e capire in che modo il comportamento delle tracce differisce tra uno e l'altro.
La scheda **Collaboratori principali** fornisce le metriche relative al **volume delle chiamate**, alla **disponibilità**, alla **latenza media**, agli **errori** e ai **guasti** per ciascun gruppo. L'immagine di esempio seguente mostra i collaboratori principali di un insieme di metriche per un'applicazione implementata su una piattaforma Amazon EKS:
![\[Collaboratori principali delle operazioni di servizio\]](http://docs.aws.amazon.com/it_it/AmazonCloudWatch/latest/monitoring/images/service-operations-top-contributors.png)
I collaboratori principali contengono le seguenti metriche:
+ **Volume delle chiamate**: utilizza il volume delle chiamate per comprendere il numero di richieste per intervallo di tempo per un gruppo.
+ **Disponibilità**: utilizza la disponibilità per vedere in quale percentuale di tempo non sono stati rilevati guasti per un gruppo.
+ **Latenza media**: utilizza la latenza per verificare il tempo medio di esecuzione delle richieste per un gruppo in un intervallo di tempo, il cui valore dipende da quanto tempo prima sono state effettuate le richieste oggetto di indagine. Le richieste effettuate meno di 15 giorni prima vengono valutate a intervalli di 1 minuto. Le richieste effettuate tra i 15 e i 30 giorni precedenti, inclusi, vengono valutate a intervalli di 5 minuti. Ad esempio, se stai esaminando le richieste che hanno causato un errore 15 giorni fa, la metrica del volume delle chiamate è uguale al numero di richieste per intervallo di 5 minuti.
+ **Errori**: il numero di errori per gruppo misurato in un intervallo di tempo.
+ **Guasti**: il numero di guasti per gruppo in un intervallo di tempo.
**Collaboratori principali che utilizzano Amazon EKS o Kubernetes**
**Utilizza le informazioni sui principali contributori per le applicazioni distribuite su Amazon EKS o Kubernetes per visualizzare i parametri di salute operativa raggruppati per **Node**, Pod e. **PodTemplateHash**** Si applicano le seguenti definizioni:
+ Un **pod** è un gruppo di uno o più container Docker che condividono spazio di archiviazione e risorse. Un pod è l'unità più piccola che può essere implementata su una piattaforma Kubernetes. Raggruppa per pod per verificare se gli errori sono correlati a limitazioni specifiche dei pod.
+ Un **nodo** è un server che esegue i pod. Raggruppa per nodi per verificare se gli errori sono correlati a limitazioni specifiche del nodo.
+ Un **hash del modello pod** viene utilizzato per trovare una versione particolare di un'implementazione. Raggruppa per hash del modello pod per verificare se gli errori sono correlati a una particolare implementazione.
**Collaboratori principali che utilizzano Amazon EC2**
Utilizza le informazioni sui collaboratori principali per le applicazioni implementate su Amazon EKS per visualizzare le metriche dell'integrità operativa raggruppate per ID istanza e gruppo Auto Scaling. Si applicano le seguenti definizioni:
+ Un **ID dell'istanza** è un identificatore univoco per l'istanza Amazon EC2 eseguita dal servizio. Raggruppa per ID dell'istanza per verificare se gli errori sono correlati a un'istanza Amazon EC2 specifica.
+ Un [gruppo Auto Scaling](https://docs.aws.amazon.com/autoscaling/ec2/userguide/auto-scaling-groups.html) è una raccolta di istanze Amazon EC2 che consentono di aumentare o ridurre verticalmente le risorse necessarie per soddisfare le richieste delle applicazioni. Raggruppa per gruppo Auto Scaling se desideri verificare se gli errori sono limitati alle istanze all'interno del gruppo.
**Collaboratori principali che utilizzano una piattaforma personalizzata**
Utilizza le informazioni sui collaboratori principali per le applicazioni implementate utilizzando instrumentazione personalizzata per visualizzare le metriche sull'integrità operativa raggruppate per **nome host**. Si applicano le seguenti definizioni:
+ Un nome host identifica un dispositivo come un endpoint o un'istanza Amazon EC2 connesso a una rete. Raggruppa per nome host per verificare se gli errori sono correlati a uno specifico dispositivo fisico o virtuale.
**Visualizzazione dei collaboratori principali in Log Insights e Container Insights**
Visualizza e modifica la query automatica che ha generato le metriche per i tuoi collaboratori principali in [Approfondimenti di Logs](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AnalyzingLogData.html). Visualizza le metriche delle prestazioni dell'infrastruttura per gruppi specifici come pod o nodi in [Approfondimenti sui container](ContainerInsights.md). Puoi ordinare cluster, nodi o carichi di lavoro in base al consumo di risorse e identificare rapidamente le anomalie o mitigare i rischi in modo proattivo prima che l'esperienza dell'utente finale ne risenta. Segue un'immagine che mostra come selezionare queste opzioni:
![\[Tabella dei collaboratori principali\]](http://docs.aws.amazon.com/it_it/AmazonCloudWatch/latest/monitoring/images/service-operations-top-contributors-insights.png)
In **Approfondimenti sui container**, puoi visualizzare le metriche per il container Amazon EKS o Amazon ECS specifiche per il raggruppamento dei tuoi collaboratori principali. Ad esempio, se raggruppi per pod per generare i collaboratori principali di un container EKS, Approfondimenti sui container mostrerà le metriche e le statistiche filtrate per tale pod.
In **Approfondimenti di Logs**, puoi modificare la query che ha generato le metriche in **Collaboratori principali ** utilizzando i seguenti passaggi:
1. Seleziona **Visualizza in Approfondimenti di Logs**. La pagina **Approfondimenti di Logs** che si apre contiene una query generata automaticamente e le seguenti informazioni:
+ Il nome del gruppo di cluster di log.
+ L'operazione su cui stavi indagando. CloudWatch
+ L'aggregato della metrica di integrità operativa con cui ha interagito nel grafico.
I risultati del registro vengono filtrati automaticamente per mostrare i dati degli ultimi cinque minuti precedenti alla selezione del punto dati sul grafico del servizio.
1. Per modificare la query, sostituisci il testo generato con le tue modifiche. È inoltre possibile utilizzare il **generatore di query** per generare una nuova query o aggiornare la query esistente.
#### Log di applicazioni
Utilizza la query nella scheda **Log dell'applicazione** per generare informazioni registrate per il gruppo di log corrente e il servizio e per inserire un timestamp. Un gruppo di log è un gruppo di flussi di log che è possibile definire quando si configura l'applicazione.
Utilizza un gruppo di log per organizzare log con caratteristiche simili, tra cui:
+ Acquisire i log da un'organizzazione, un'origine o una funzione specifica.
+ Acquisire i log a cui accede un determinato utente.
+ Acquisire i log per un determinato periodo di tempo.
Utilizza questi flussi di log per tenere traccia di gruppi o intervalli di tempo specifici. Per questi gruppi di log puoi anche impostare regole di monitoraggio, allarmi e notifiche. Per informazioni generali sui gruppi di log, consulta [Working with log groups and log streams](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/Working-with-log-groups-and-streams.html).
La query dei log dell'applicazione restituisce i log, i modelli di testo ricorrenti e le visualizzazioni grafiche per i gruppi di log.
Per eseguire la query, seleziona **Esegui query in Approfondimenti di Logs** per eseguire la query generata automaticamente o modificare la query. Per modificare la query, sostituisci il testo generato automaticamente con le tue modifiche. È inoltre possibile utilizzare il **generatore di query** per generare una nuova query o aggiornare la query esistente.
L'immagine seguente mostra l'interrogazione di esempio che viene generata automaticamente in base al punto selezionato nel grafico delle operazioni di servizio:
![\[Tabella dei log dell'applicazione\]](http://docs.aws.amazon.com/it_it/AmazonCloudWatch/latest/monitoring/images/service-operations-application-logs.png)
Nell'immagine precedente, CloudWatch ha rilevato automaticamente il gruppo di log associato al punto selezionato e lo ha incluso in una query generata.
## Visualizzazione delle dipendenze del servizio
Scegli la scheda **Dipendenze** per visualizzare la tabella **Dipendenze** e un insieme di parametri per le dipendenze di tutte le operazioni del servizio o di una singola operazione. La tabella contiene un elenco di dipendenze individuate da Application Signals, tra cui metriche relative a stato SLI, latenza, volume delle chiamate, tasso di guasto, tasso di errore e disponibilità.
Nella parte superiore della pagina, scegli un'operazione dall'elenco della freccia rivolta verso il basso per visualizzarne le dipendenze oppure seleziona **Tutto** per visualizzare le dipendenze per tutte le operazioni.
Filtra la tabella per trovare facilmente ciò che cerchi, scegliendo una o più proprietà dalla casella di testo del filtro. Quando scegli una proprietà, una procedura ti guida attraverso i criteri di filtro e vedrai il filtro completo sotto la casella di testo del filtro. Seleziona **Cancella filtri** in qualsiasi momento per rimuovere il filtro della tabella. Seleziona **Raggruppa per dipendenza** in alto a destra della tabella per raggruppare le dipendenze in base al nome del servizio e dell'operazione. Quando il raggruppamento è attivo, puoi espandere o comprimere un gruppo di dipendenze con l'icona **\$1** accanto al nome della dipendenza.
![\[Tabella delle dipendenze\]](http://docs.aws.amazon.com/it_it/AmazonCloudWatch/latest/monitoring/images/service-dependencies-table.png)
La colonna **Dipendenza** mostra il nome del servizio di dipendenza, mentre la colonna **Operazione remota** mostra il nome dell'operazione del servizio. La colonna **dello stato SLI** mostra il numero di persone sane o non sane SLIs insieme al numero totale di SLIs per ogni dipendenza. Quando si chiamano AWS i servizi, la colonna **Target** mostra la AWS risorsa, ad esempio la tabella DynamoDB o la coda Amazon SNS.
Per selezionare una dipendenza, seleziona l'opzione accanto a una dipendenza nella tabella **Dipendenze**. Viene visualizzato un insieme di grafici che mostrano metriche dettagliate per il volume delle chiamate, la disponibilità, i guasti e gli errori. Passa il mouse su un punto in un grafico per visualizzare un popup con ulteriori informazioni. Seleziona un punto in un grafico per aprire un pannello di diagnostica che mostra le tracce correlate per tale punto. Scegli un ID di traccia dalla tabella **Tracce correlate** per aprire la relativa pagina [Dettagli della traccia X-Ray](https://docs.aws.amazon.com/xray/latest/devguide/xray-console-traces.html).
![\[Grafici delle dipendenze e tracce correlate\]](http://docs.aws.amazon.com/it_it/AmazonCloudWatch/latest/monitoring/images/service-dependency-graph-traces.jpg)
## Visualizzazione dei canary Synthetics
Scegli la scheda **Canary Synthetics** per visualizzare la tabella **Canary Synthetics** e un set di tabelle per ogni canary presente nella tabella. La tabella include i parametri relativi alla percentuale di successo, alla durata media, alle esecuzioni e alla frequenza di errore. Vengono visualizzati solo i canarini [abilitati](CloudWatch_Synthetics_Canaries_tracing.md) al tracciamento. AWS X-Ray
Usa la casella di testo del filtro nella tabella dei canary synthetics per trovare il canary che ti interessa. Ogni filtro creato viene visualizzato sotto la casella di testo del filtro. Seleziona **Cancella filtri** in qualsiasi momento per rimuovere il filtro della tabella.
![\[Tabella dei canary Synthetics\]](http://docs.aws.amazon.com/it_it/AmazonCloudWatch/latest/monitoring/images/service-canaries-table.png)
Seleziona il pulsante di opzione accanto al nome del canary per visualizzare una serie di schede contenenti grafici delle metriche dettagliati, tra cui percentuale di successo, errori e durata. Passa il mouse su un punto in un grafico per visualizzare un popup con ulteriori informazioni. Seleziona un punto in un grafico per aprire un pannello di diagnostica che mostra le esecuzioni di canary correlate per tale punto. Seleziona un'esecuzione di canary e scegli **Tempo di esecuzione** per visualizzare gli artefatti relativi all'esecuzione di canary selezionata, tra cui log, file HTTP Archive (HAR), schermate e passaggi suggeriti per aiutarti a risolvere i problemi. **Scegli **Ulteriori informazioni** per aprire la pagina [CloudWatch Synthetics](CloudWatch_Synthetics_Canaries.md) Canaries accanto a Canary run.**
![\[Grafici ed esecuzioni di canary Synthetics\]](http://docs.aws.amazon.com/it_it/AmazonCloudWatch/latest/monitoring/images/service-canary-graphs-runs.jpg)
## Visualizzazione delle pagine client
Scegli la scheda **Pagine client** per visualizzare un elenco di pagine web client che chiamano il servizio. Utilizza l'insieme di metriche per la pagina client selezionata per misurare la qualità dell'esperienza del cliente quando interagisce con un servizio o un'applicazione. Queste metriche includono caricamenti di pagine, dati web vitali ed errori.
Per visualizzare le pagine client nella tabella, è necessario [configurare il client Web CloudWatch RUM per il tracciamento a raggi X](CloudWatch-RUM-get-started-create-app-monitor.md) e attivare le metriche di Application Signals per le pagine client. Scegli **Gestisci pagine** per selezionare le pagine che sono abilitate per le metriche di Application Signals.
Utilizza la casella di testo del filtro per trovare la pagina client o il monitoraggio dell'applicazione che ti interessa sotto la casella di testo del filtro. Seleziona **Cancella filtri** per rimuovere il filtro della tabella. Seleziona **Raggruppa per client** per raggruppare le pagine client per client. Una volta raggruppate, seleziona l'icona **\$1** accanto al nome di un client per espandere la riga e visualizzare tutte le pagine relative a quel client.
![\[Tabella Pagine client\]](http://docs.aws.amazon.com/it_it/AmazonCloudWatch/latest/monitoring/images/service-client-pages-table.png)
Per selezionare una pagina client, selezionare l'opzione accanto a una pagina client nella tabella **Pagine client**. Verrà visualizzata una serie di grafici che mostrano parametri dettagliati. Passa il mouse su un punto in un grafico per visualizzare un popup con ulteriori informazioni. Seleziona un punto in un grafico per aprire un pannello di diagnostica che mostra gli eventi di prestazione della navigazione correlati per tale punto. Scegliete un ID evento dall'elenco degli eventi di navigazione per aprire la [visualizzazione della pagina CloudWatch RUM](CloudWatch-RUM-view-data.md) per l'evento scelto.
![\[CloudWatch Richieste di pagine client RUM\]](http://docs.aws.amazon.com/it_it/AmazonCloudWatch/latest/monitoring/images/service-client-page-graphs-events.jpg)
**Nota**
Per visualizzare gli errori AJAX nelle pagine client, utilizzate la versione 1.15 o [successiva del client web CloudWatch RUM](CloudWatch-RUM-configure-client.md).
È possibile visualizzare fino a 100 operazioni, canary e pagine client e fino a 250 dipendenze per servizio.
## Visualizzazione di Metriche correlate
Utilizza la scheda Metriche correlate per visualizzare più metriche, identificare i modelli di correlazione e determinare le cause principali dei problemi.
La tabella delle metriche mostra tre tipi di metriche:
+ Metriche standard: Application Signals raccoglie le metriche dell'applicazione standard dai servizi che rileva. Per ulteriori informazioni, consulta [Standard application metrics collected](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/AppSignals-MetricsCollected.html#AppSignals-StandardMetrics)
+ Metriche di runtime: Application Signals utilizza AWS Distro for OpenTelemetry SDK per raccogliere automaticamente metriche OpenTelemetry compatibili dalle applicazioni Java e Python. Per ulteriori informazioni, consulta [Rumtime metrics](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/AppSignals-MetricsCollected.html#AppSignals-RuntimeMetrics)
+ Metriche personalizzate: Application Signals consente di generare metriche personalizzate dalla propria applicazione. Per ulteriori informazioni, consulta [Metriche personalizzate con Application Signals](AppSignals-CustomMetrics.md)
È possibile accedere alla scheda Metriche correlate dalle schede Panoramica del servizio, Operazioni di servizio, Dipendenze, Canary synthetics o RUM.
![\[Visualizzazione di Metriche correlate\]](http://docs.aws.amazon.com/it_it/AmazonCloudWatch/latest/monitoring/images/Custom_metrics.png)
+ Inizialmente, nel pannello di navigazione a sinistra tutte le operazioni e le dipendenze sono deselezionate
+ Inizialmente, il grafico mostra la metrica dei guasti relativa all'operazione con il tasso di guasto più elevato
Prima di iniziare l'analisi di correlazione, assicurati che i punti dati siano visibili in Operazioni di servizio o Dipendenze. Per analizzare le correlazioni:
1. Apri la pagina Operazioni di servizio o Dipendenze.
1. Seleziona un punto dati nel grafico.
1. Nel pannello di destra, scegli **Correla con altre metriche**.
1. Nella scheda **Metriche correlate** che si apre, vedrai:
+ L'operazione o la dipendenza selezionata nella barra di navigazione a sinistra
+ La metrica selezionata rappresentata graficamente nella tabella *Sfoglia metriche*
+ Gli intervalli correlati, quando si seleziona un punto dati
Per rappresentare graficamente più metriche, seleziona una o più metriche dalla visualizzazione **Sfoglia** nella scheda **Metriche correlate**. Scegli **Metriche rappresentate graficamente** per visualizzare tutte le metriche rappresentate graficamente.
Per filtrare le metriche, usa i filtri del pannello di sinistra per concentrarti su operazioni o dipendenze specifiche e usa la barra dei filtri dell'intestazione della tabella per cercare per nome, tipo o altri attributi. Queste opzioni di filtro ti aiutano a rilevare i modelli ricorrenti e a risolvere i problemi in modo più efficiente.
Per analizzare nel dettaglio le metriche correlate, seleziona un punto dati nella scheda **Metriche correlate**. Potrai quindi visualizzare:
+ Collaboratori principali: analizza le metriche eseguendo le query di Logs Insights. CloudWatch Queste query elaborano i record Enhanced Metrics Format (EMF) che contengono attributi chiave per un'analisi dettagliata di quanto segue:
+ Misurazioni della latenza
+ Occorrenze di guasti
+ Metriche della disponibilità del servizio
Le seguenti metriche non supportano i collaboratori principali:
+ Metriche OTEL
+ Metriche dell'intervallo lato server
Puoi visualizzare i collaboratori principali per le metriche RED e le metriche di intervallo lato client.
+ Intervalli correlati: la sezione Intervalli correlati funziona in modo coerente con la scheda Operazioni di servizio. Per aiutarti a identificare le tracce e le metriche correlate, il meccanismo di correlazione funziona in base a:
+ Confronto dei nomi delle metriche con gli attributi di intervallo
+ Identificazione dei modelli corrispondenti durante il periodo di tempo selezionato
+ Visualizzazione delle informazioni di traccia pertinenti
Per analizzare in modo efficace le metriche e gli intervalli, devi capire in che modo i diversi tipi di metriche sono correlati. Queste sono le limitazioni chiave:
+ Le metriche OTEL non sono correlate agli intervalli perché utilizzano sistemi di denominazione indipendenti
+ Per correlare le metriche di intervallo lato server o client con gli intervalli:
+ Includi il campo Dimensione del servizio nella configurazione
+ Senza Dimensione del servizio, non è possibile correlare queste metriche con gli intervalli
+ Applicazioni di log: per informazioni sull'applicazione di log, consulta [Application logs](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/ServiceDetail.html#ServiceDetail-operations)
# Visualizza la topologia dell'applicazione e monitora lo stato operativo con la mappa dell' CloudWatch applicazione
**Nota**
La mappa CloudWatch dell'applicazione sostituisce la Service Map. Per visualizzare una mappa dell'applicazione basata sulle AWS X-Ray tracce, apri la [X-Ray Trace](https://docs.aws.amazon.com/xray/latest/devguide/xray-console-servicemap.html) Map. Scegli **Trace Map** nella sezione **X-Ray** nel riquadro di navigazione a sinistra della CloudWatch console.
Dopo aver abilitato l'applicazione per Application Signals, la mappa dell'applicazione mostra i nodi che rappresentano i gruppi. Approfondisci questi gruppi per visualizzare i tuoi servizi e le relative dipendenze. Utilizza la mappa dell'applicazione per visualizzare la topologia dei client delle applicazioni, dei canary synthetics, dei servizi e delle dipendenze e per monitorare l'integrità operativa. Per visualizzare la mappa dell'applicazione, apri la [CloudWatch console](https://console.aws.amazon.com/cloudwatch/) e scegli **Application Map** nella sezione **Application Signals** nel riquadro di navigazione a sinistra.
Dopo aver [abilitato l'applicazione per Application Signals](CloudWatch-Application-Signals-Enable.md), utilizza la mappa dell'applicazione per semplificare il monitoraggio dell'integrità operativa dell'applicazione:
+ Visualizza le connessioni tra client, canary, servizio e nodi di dipendenza per comprendere la topologia e il flusso di esecuzione dell'applicazione. Ciò è particolarmente utile se gli operatori del servizio non fanno parte del team di sviluppo.
+ Scopri quali servizi soddisfano o meno i tuoi [obiettivi in termini di livello di servizio (SLOs)](CloudWatch-ServiceLevelObjectives.md). Quando un servizio non soddisfa i tuoi requisiti SLOs, puoi identificare rapidamente se un servizio a valle o una dipendenza potrebbero contribuire al problema o influire su più servizi a monte.
+ Seleziona un singolo client, canary synthetics, servizio o nodo di dipendenza per visualizzare le metriche correlate. La pagina [Dettagli del servizio](ServiceDetail.md) mostra informazioni più dettagliate su operazioni, dipendenze, canary synthetics e pagine client.
+ Filtra e ingrandisci la mappa dell'applicazione per concentrarti più facilmente su una parte della topologia dell'applicazione oppure visualizza l'intera mappa. Crea un filtro scegliendo una o più proprietà dalla casella di testo del filtro. Quando scegli una proprietà, una procedura ti guida attraverso i criteri di filtro. Vedrai il filtro completo sotto la casella di testo del filtro. Seleziona **Cancella filtri** in qualsiasi momento per rimuovere il filtro.
+ Monitora i servizi su più AWS account in un'unica mappa unificata delle applicazioni. I servizi di diversi account sono chiaramente identificati con le informazioni sugli account, consentendo l'osservabilità unificata per le applicazioni distribuite.
+ Identifica i servizi non ancora inclusi nella tua applicazione. Application Signals rileva e visualizza automaticamente i servizi che non sono ancora stati strumentati, aiutandoti a raggiungere una copertura di osservabilità completa. I servizi non strumentati sono distinti visivamente sulla mappa per aiutarvi a dare priorità alle attività di strumentazione.
+ Raggruppa e filtra i servizi per creare viste personalizzate che si adattino ai tuoi flussi di lavoro. Questa organizzazione ti aiuta a trovare e accedere rapidamente ai servizi che utilizzi con maggiore frequenza
+ Salva le visualizzazioni filtrate e raggruppate per tornare rapidamente alle configurazioni utilizzate di frequente
## Esplora la mappa dell'applicazione
Quando visiti la mappa dell'applicazione, questa per impostazione predefinita mostra i servizi raggruppati per **Servizi correlati**. I servizi correlati raggruppano i servizi in base alle rispettive dipendenze. Ad esempio, se il Servizio A chiama il Servizio B, che a sua volta chiama il Servizio C, essi vengono raggruppati nel Servizio A. È possibile visualizzare lo stato, le metriche e il numero di servizi SLI per tutti i servizi di ciascun gruppo.
![\[CloudWatch mappa delle applicazioni predefinita raggruppata per servizi correlati.\]](http://docs.aws.amazon.com/it_it/AmazonCloudWatch/latest/monitoring/images/explore-application-map-overview.png)
Scegli una scheda per ottenere informazioni sull'esplorazione di ciascun tipo di nodo e degli edge (connessioni) tra di essi.
### Raggruppamento e filtraggio dinamici
Puoi fare clic sul menu a discesa **Raggruppa per** al fine di utilizzare opzioni di raggruppamento diverse. Per impostazione predefinita, la mappa dell'applicazione fornisce due raggruppamenti:
+ **Servizi correlati**: raggruppa i servizi in base alle rispettive dipendenze
+ **Ambiente**: raggruppa i servizi in base all'ambiente
Se desideri definire un raggruppamento personalizzato, fai clic su **Gestisci gruppi** per definire gruppi personalizzati, quindi aggiungi tag ai servizi o aggiungi gli attributi di risorsa OTEL con la chiave di gruppo.
**Nota**
Per abilitare il raggruppamento tramite gli attributi delle risorse OTEL, la versione dell' CloudWatch agente deve essere v1.300056.0 o successiva.
![\[Crea un pannello di raggruppamento personalizzato\]](http://docs.aws.amazon.com/it_it/AmazonCloudWatch/latest/monitoring/images/explore-application-map-create-custom-grouping.png)
Il raggruppamento predefinito in Application Signals organizza automaticamente i servizi in base alle rispettive dipendenze a valle. Il sistema analizza il grafico delle dipendenze dei servizi e crea gruppi in cui il nodo principale (un servizio senza dipendenze a monte) diventa il nome del gruppo. Tutti i servizi che dipendono da questo servizio principale, direttamente o indirettamente, vengono automaticamente inclusi nel gruppo. Ad esempio, se il servizio A chiama il servizio B, che a sua volta chiama il servizio C, tutti e tre i servizi verranno raggruppati insieme al servizio A come nome del gruppo poiché è il servizio principale della catena di dipendenze. Questo meccanismo di raggruppamento automatico offre un modo naturale per visualizzare e gestire i servizi correlati in base alle interazioni e alle dipendenze effettive in fase di runtime.
### Operazioni e approfondimenti sui gruppi
Per ogni gruppo, puoi eseguire le seguenti operazioni:
+ Fai clic su **Visualizza altro** per visualizzare i grafici delle metriche, gli ultimi due eventi di modifica e l'ora dell'ultima implementazione per il gruppo
![\[Visualizza altri cassetti per gruppi nella mappa dell'applicazione\]](http://docs.aws.amazon.com/it_it/AmazonCloudWatch/latest/monitoring/images/explore-application-map-view-more.png)
+ Fai clic su **Visualizza dashboard** per visualizzare la dashboard delle metriche, la tabella degli eventi di modifica e l'elenco dei servizi per il gruppo
![\[Visualizza la dashboard dell'applicazione per il gruppo\]](http://docs.aws.amazon.com/it_it/AmazonCloudWatch/latest/monitoring/images/explore-application-map-team-overview.png)
![\[Visualizza la dashboard dell'applicazione per gruppi con grafici delle metriche\]](http://docs.aws.amazon.com/it_it/AmazonCloudWatch/latest/monitoring/images/explore-application-map-team-overview-2.png)
Puoi utilizzare **Group and filter** sulla barra di sinistra per filtrare i gruppi che dispongono di servizi con tempi di implementazione, stato di integrità SLI o tipo di piattaforma di elaborazione.
![\[Servizi di raggruppamento e filtro nella dashboard dell'applicazione\]](http://docs.aws.amazon.com/it_it/AmazonCloudWatch/latest/monitoring/images/explore-application-map-grouping-filter.png)
Puoi anche filtrare per account per visualizzare i servizi di AWS account specifici nella configurazione di osservabilità tra account.
![\[Filtra i servizi per account nella dashboard dell'applicazione\]](http://docs.aws.amazon.com/it_it/AmazonCloudWatch/latest/monitoring/images/explore-application-map-account-filter.png)
Utilizza la barra **Ricerca e filtra** per cercare gruppi per nome o gruppi di ricerca che contengono un ambiente di servizio o una dipendenza specifici. Filtra per ID account per concentrarti sui servizi di account specifici.
![\[Cerca e filtra i servizi nella mappa dell'applicazione\]](http://docs.aws.amazon.com/it_it/AmazonCloudWatch/latest/monitoring/images/explore-application-map-search-and-filter.png)
### Configurazione dei gruppi personalizzati
Il raggruppamento personalizzato consente di organizzare i servizi in modo logico in base ai requisiti aziendali e alle priorità operative. Questa funzionalità consente di visualizzare e salvare visualizzazioni definite in modo prioritario in base alle esigenze specifiche, creare gruppi basati sulla proprietà di uno specifico team e assemblare gruppi di servizi necessari per le transazioni aziendali critiche.
Crea i nomi dei gruppi personalizzati (i nomi dei gruppi che vedrai nell'interfaccia utente) e i nomi delle chiavi di gruppo corrispondenti. Completa questo passaggio dall'interfaccia utente di Application Signals o utilizzando l'[PutGroupingConfiguration](https://docs.aws.amazon.com/applicationsignals/latest/APIReference/API_PutGroupingConfiguration.html)API.
I nomi delle chiavi di gruppo possono essere una chiave di AWS tag o un attributo di risorsa OTEL per il servizio. Per stabilire se utilizzare i tag o gli attributi di risorsa OTEL, prendi in considerazione la tua piattaforma di elaborazione:
+ Per piattaforme a servizio singolo (ad esempio, Lambda o Auto Scaling Group), utilizza i tag AWS
+ Per le piattaforme multiservizio (ad esempio, cluster Amazon EKS), utilizza gli attributi di risorsa OTEL, che forniscono un raggruppamento più granulare
**Aggiungere tag AWS **
Aggiungi un AWS tag con la chiave di gruppo personalizzata come chiave e valore a un cluster Amazon EKS. Quando in un cluster Amazon EKS esistono più servizi in esecuzione, tutti sono etichettati con la stessa chiave di gruppo personalizzata. Ad esempio, quando Amazon EKS Cluster A ha Service 1, Service 2 e Service 3 in esecuzione, l'aggiunta di un AWS tag con la chiave *Team X* al cluster aggiungerà tutti e tre i servizi al *Team X.* Per aggiungere solo servizi specifici al *Team X*, aggiungi gli attributi delle risorse OTEL per i servizi come mostrato di seguito.
**Aggiunta degli attributi di risorsa OTEL**
Per aggiungere un attributo di risorsa OTEL, consulta la configurazione seguente:
**Configurazione generale**
Configura la variabile di ambiente `OTEL_RESOURCE_ATTRIBUTES` nella tua applicazione utilizzando le coppie chiave-valore del gruppo personalizzato. Le chiavi sono elencate sotto `aws.application_signals.metric_resource_keys` separate da `&`.
Ad esempio, per creare gruppi personalizzati utilizzando `Application=PetClinic` e `Owner=Test`, utilizza quanto segue:
```
OTEL_RESOURCE_ATTRIBUTES=Application=PetClinic,Owner=Test,aws.application_signals.metric_resource_keys=Application&Owner
```
**Configurazione specifica della piattaforma**
Di seguito sono riportate le specifiche di implementazione.
**Amazon EKS e Kubernetes nativi**
```
apiVersion: apps/v1
kind: Deployment
metadata:
...
spec:
replicas: 1
...
template:
spec:
containers:
- name: your-app
image: your-app-image
env:
...
- name: OTEL_RESOURCE_ATTRIBUTES
value: Application=PetClinic,Owner=Test,aws.application_signals.metric_resource_keys=Application&Owner
```
**Amazon EC2**
Aggiungi `OTEL_RESOURCE_ATTRIBUTES` allo script di avvio dell'applicazione. Per l'esempio completo, consulta [Adding `OTEL_RESOURCE_ATTRIBUTES`](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Application-Signals-Enable-EC2Main.html#CloudWatch-Application-Signals-Monitor-EC2).
```
...
OTEL_RESOURCE_ATTRIBUTES="service.name=$YOUR_SVC_NAME,Application=PetClinic,Owner=Test,aws.application_signals.metric_resource_keys=Application&Owner" \
java -jar $MY_JAVA_APP.jar
```
**Amazon ECS**
Aggiungi `OTEL_RESOURCE_ATTRIBUTES` a TaskDefinition. Per l'esempio completo, consulta [Enable on Amazon ECS](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Application-Signals-Enable-ECSMain.html).
```
{
"name": "my-app",
...
"environment": [
{
"name": "OTEL_RESOURCE_ATTRIBUTES",
"value": "service.name=$YOUR_SVC_NAME,Application=PetClinic,Owner=Test,aws.application_signals.metric_resource_keys=Applicationmanagement portalOwner"
},
...
]
}
```
**Lambda**
Aggiungi `OTEL_RESOURCE_ATTRIBUTES` alla variabile di ambiente Lambda.
```
OTEL_RESOURCE_ATTRIBUTES="Application=PetClinic,Owner=Test,aws.application_signals.metric_resource_keys=Application&Owner"
```
### Visualizzazione dei servizi all'interno dei gruppi
Per visualizzare i servizi e le relative dipendenze in un gruppo, fai clic sul nome del gruppo. Verrà visualizzata una mappa dei servizi all'interno del gruppo. Ogni nodo di servizio mostrerà l'integrità SLI, le metriche e i dettagli della piattaforma. Per facilitarne il riconoscimento, i servizi con violazione degli SLI sono evidenziati.
![\[CloudWatch servizi di mappe delle applicazioni all'interno del gruppo.\]](http://docs.aws.amazon.com/it_it/AmazonCloudWatch/latest/monitoring/images/View-services-groups.png)
I servizi non strumentati vengono visualizzati con un indicatore visivo distintivo (ad esempio un bordo tratteggiato o un colore diverso) per distinguerli dai servizi strumentati. Passa il mouse su un nodo di servizio non dotato di strumenti per visualizzare le linee guida sulla strumentazione e i collegamenti alla documentazione di configurazione.
![\[Filtra per servizi non strumentati sulla mappa dell'applicazione\]](http://docs.aws.amazon.com/it_it/AmazonCloudWatch/latest/monitoring/images/explore-application-map-uninstrumented-filter.png)
Per impostazione predefinita, tutti i nodi Canaries, RUM Clients e AWS Service verranno compressi. Se i servizi di questo gruppo chiamano servizi che non fanno parte di questo gruppo, per impostazione predefinita verranno anch'essi compressi.
![\[I nodi Canary vengono compressi in un gruppo nella mappa dell'applicazione\]](http://docs.aws.amazon.com/it_it/AmazonCloudWatch/latest/monitoring/images/explore-application-map-canary-collapse.png)
Se la mappa risulta ancora troppo grande per un'indagine efficace, puoi applicare il raggruppamento annidato per restringere l'indagine. Ad esempio, dopo aver raggruppato i servizi per **Unità aziendale**, se hai ancora troppi servizi in un gruppo, utilizza il menu a discesa Raggruppa per e seleziona **Team**, creando una struttura di raggruppamento annidata.
![\[Raggruppamento annidato nella mappa dell'applicazione\]](http://docs.aws.amazon.com/it_it/AmazonCloudWatch/latest/monitoring/images/explore-application-map-nested-grouping.png)
### Approfondimenti e dettagli sui servizi
In questa pagina puoi anche fare clic su **Salva visualizzazione** accanto alla barra di ricerca per salvare la visualizzazione in modo da non dover applicare nuovamente lo stesso raggruppamento e filtro.
![\[Salva la configurazione di raggruppamento\]](http://docs.aws.amazon.com/it_it/AmazonCloudWatch/latest/monitoring/images/explore-application-map-save-view.png)
Fai clic su **Visualizza altro** nel nodo del servizio per visualizzare i grafici di Service Audit, Change Events, SLI Health e Metrics.
![\[CloudWatch approfondimenti sul servizio di mappe delle applicazioni.\]](http://docs.aws.amazon.com/it_it/AmazonCloudWatch/latest/monitoring/images/explore-application-map-service-view-more.png)
Se desideri visualizzare il funzionamento del servizio e altri dettagli del servizio, fai clic su **Visualizza dashboard** per accedere alla pagina di panoramica del servizio.
![\[CloudWatch panoramica del servizio di mappe delle applicazioni.\]](http://docs.aws.amazon.com/it_it/AmazonCloudWatch/latest/monitoring/images/explore-application-map-service-overview.png)
In alternativa, puoi fare clic su Edge per visualizzare le metriche di una specifica chiamata di dipendenza di un servizio.
![\[CloudWatch Application Map Node Edge Drawer\]](http://docs.aws.amazon.com/it_it/AmazonCloudWatch/latest/monitoring/images/explore-application-map-edge.png)
### Cambia eventi
Tieni traccia degli eventi di modifica in tutta l'applicazione con l'elaborazione automatica degli eventi di CloudTrail Application Signals. Monitora gli eventi di configurazione e implementazione dei servizi e delle relative dipendenze, fornendo un contesto immediato per l'analisi operativa e la risoluzione dei problemi. Il rilevamento degli eventi di modifica è abilitato insieme all'abilitazione del rilevamento dei servizi tramite la CloudWatch console o l'API. StartDiscovery Per i servizi EKS, il rilevamento dell'implementazione richiede che i servizi EKS siano strumentati con l'SDK di strumentazione Application Signals. Application Signals correla automaticamente i tempi di implementazione con le variazioni delle prestazioni, aiutandoti a identificare rapidamente se le ultime implementazioni stanno causando problemi di servizio. Visualizza la cronologia degli eventi di modifica e l'impatto sui tuoi servizi senza requisiti di configurazione o configurazione aggiuntivi.
### Esiti degli audit
Scopri informazioni importanti grazie agli esiti degli audit di Application Signals. Il servizio analizza le applicazioni per segnalare osservazioni significative e potenziali problemi, semplificando l'analisi delle cause principali. Questi risultati automatizzati consolidano le tracce pertinenti, eliminando la necessità di navigare attraverso più clic. Il sistema di audit aiuta i team a identificare rapidamente i problemi e le loro cause sottostanti, consentendo una risoluzione più rapida dei problemi.
Per i servizi in esecuzione su Amazon Bedrock, Application Signals monitora automaticamente i modelli di utilizzo dei token GenAI. Il sistema di audit rileva anomalie nel consumo di token di input e output, confrontando l'utilizzo attuale con le baseline storiche. Quando l'utilizzo dei token supera i modelli normali, i risultati dell'audit forniscono un'analisi dettagliata, tra cui le tendenze del consumo dei token, le implicazioni in termini di costi e le raccomandazioni per l'ottimizzazione. Questo aiuta i team a identificare richieste inefficienti, picchi imprevisti dei token e opportunità per ridurre i costi operativi di GenAI.
### Osservabilità tra account sulla mappa delle applicazioni
Application Signals supporta l'osservabilità tra account, consentendo di monitorare e visualizzare i servizi distribuiti su più AWS account in un'unica mappa applicativa unificata. Questa funzionalità è essenziale per le organizzazioni con architetture multi-account che seguono le migliori pratiche. AWS
**Funzionalità chiave:**
+ *Visualizzazione unificata*: visualizza i servizi di più AWS account in un'unica mappa dell'applicazione, fornendo un quadro completo dell'architettura applicativa distribuita.
+ *Identificazione dell'account*: ogni nodo del servizio mostra chiaramente l'ID dell'account e la regione, facilitando l'identificazione della proprietà e dell'ubicazione del servizio.
+ *Monitoraggio centralizzato*: monitora lo stato, le prestazioni e lo stato SLO dei servizi su tutti gli account connessi da un unico account di monitoraggio.
+ *Filtraggio tra account*: filtra e raggruppa i servizi in base all'ID dell'account per concentrarti su account specifici o visualizzare le interazioni tra account.
**Come funziona:**
Application Signals utilizza AWS Organizations e la condivisione tra account per consentire l'osservabilità su più account. Per configurare l'osservabilità tra account, fare riferimento a. [CloudWatch osservabilità tra più account](CloudWatch-Unified-Cross-Account.md)
------
#### [ View your application services ]
**Servizio (con strumentazione)**
È possibile visualizzare i servizi applicativi e lo stato dei relativi indicatori SLOs e dei livelli di servizio (SLIs) nella **Application Map**. Se non l'hai creato SLOs per un servizio, scegli il pulsante **Crea SLO** sotto il nodo del servizio.
La **Mappa dell'applicazione** mostra tutti i servizi. Mostra anche i client e i canary che utilizzano il servizio e le dipendenze richiamate dai servizi, come mostrato nell'immagine seguente:
![\[Una mappa CloudWatch dell'applicazione che mostra il servizio funzionante e quello non funzionante.\]](http://docs.aws.amazon.com/it_it/AmazonCloudWatch/latest/monitoring/images/service-map-service-healthy-unhealthy.png)
Quando selezioni un nodo di servizio, si apre un pannello contenente informazioni dettagliate sul servizio:
+ Tasso totale di errori e guasti.
+ Il numero di SLIs e SLOs che sono `healthy` o`unhealthy`.
+ L'opzione per visualizzare ulteriori informazioni su uno SLO.
+ I valori di `Cluster`, `Namespace` e `Workload` per i servizi ospitati su Amazon EKS o l'ambiente per i servizi ospitati su Amazon ECS o Amazon EC2. Per i servizi ospitati su Amazon EKS, scegli un link qualsiasi per aprire CloudWatch Container Insights.
+ AccountId e regione.
+ La sezione **Modifica** che mostra gli eventi di modifica recenti e l'ora dell'ultima implementazione.
+ La scheda **Audit operativo**, che fornisce esiti e consigli di audit automatizzati.
+ Grafico delle metriche del servizio con informazioni su disponibilità, latenza, guasti ed errori.
Seleziona un edge o connessione tra un nodo di servizio e un servizio a valle o un nodo di dipendenza. Si apre un pannello contenente i percorsi principali per tasso di guasto, latenza e tasso di errore, come mostrato nella seguente immagine di esempio. Scegli un collegamento qualsiasi nel pannello per aprire la pagina [Dettagli del servizio](ServiceDetail.md) e visualizzare informazioni dettagliate sul servizio o sulla dipendenza scelti.
![\[Un servizio di mappe CloudWatch delle applicazioni (edge)\]](http://docs.aws.amazon.com/it_it/AmazonCloudWatch/latest/monitoring/images/App-signals-service-edge.png)
Quando selezioni un nodo edge, si apre un pannello contenente informazioni dettagliate sul servizio:
+ Numero totale di richieste, latenza, tasso di errore e tasso di guasto
+ Il percorso con il tasso di guasto più elevato
+ Il percorso con la latenza maggiore
+ Il percorso con il tasso di errore più elevato
**Servizio (senza strumentazione)**
I servizi non strumentati vengono visualizzati sulla mappa dell'applicazione anche quando non sono stati configurati con Application Signals. Questi servizi vengono scoperti automaticamente sfruttando Resource Explorer utilizzando nomi e tag delle applicazioni. Il sistema è in grado di rilevare automaticamente fino a 3.000 risorse nel tuo AWS account.
Quando si seleziona un nodo di servizio non strumentato, si apre un riquadro che mostra:
+ Nome del servizio e informazioni di identificazione
+ AccountId e regione in cui viene rilevato il servizio
+ Stato e guida della strumentazione
+ Pulsante di invito all'azione «Enable Application Signals» che fornisce istruzioni di configurazione
+ Tipo di piattaforma di calcolo (se rilevabile)
I servizi UN-Instrumented ti aiutano a:
+ Identifica le lacune nella tua copertura di osservabilità
+ Assegnate la priorità ai prossimi servizi da strumentare in base alla loro posizione nell'architettura
+ Comprendi la topologia completa dell'applicazione anche prima della strumentazione completa
+ Pianifica l'implementazione della strumentazione in tutta l'organizzazione
**Nota**
I servizi non strumentati visualizzano dati di telemetria limitati poiché non inviano attivamente metriche o tracce.
![\[CloudWatch filtro per la strumentazione della mappa dell'applicazione\]](http://docs.aws.amazon.com/it_it/AmazonCloudWatch/latest/monitoring/images/explore-application-map-instrumentation-filter.png)
------
#### [ View dependencies ]
Le dipendenze dell'applicazione vengono visualizzate sulla mappa dell'applicazione, collegate ai servizi che le chiamano.
Scegli un nodo di dipendenza per aprire un pannello contenente il tasso di errore, il tasso di guasto e il grafico delle metriche per richiesta, disponibilità, latenza, tasso di guasto e tasso di errore.
Se il nodo di dipendenza è un servizio o una risorsa, il riquadro mostrerà gli eventi di modifica per l'intervallo di tempo richiesto.
![\[Una mappa CloudWatch dell'applicazione che mostra un nodo di dipendenza del AWS servizio espandibile.\]](http://docs.aws.amazon.com/it_it/AmazonCloudWatch/latest/monitoring/images/service-map-dependency.png)
------
#### [ View clients ]
Dopo aver [attivato il tracciamento X-Ray](CloudWatch-RUM-get-started-create-app-monitor.md) per i client Web CloudWatch RUM, questi vengono visualizzati sulla mappa dell'applicazione connessi ai servizi che chiamano.
Scegli un nodo del client per aprire un pannello contenente informazioni dettagliate sul client:
+ Metriche relative al caricamento delle pagine, al tempo medio di caricamento, agli errori e ai parametri web vitali medi
+ Un grafico che mostra una suddivisione degli errori
+ Un link per visualizzare i dettagli del client in RUM CloudWatch
![\[Una mappa CloudWatch dell'applicazione che mostra un nodo client espandibile.\]](http://docs.aws.amazon.com/it_it/AmazonCloudWatch/latest/monitoring/images/service-map-client.png)
Scegli **Visualizza pannello di controllo** per aprire i dettagli del canary.
------
#### [ View synthetics canaries ]
Per visualizzare i canarini sulla mappa dell'applicazione, attiva il tracciamento a [raggi X](CloudWatch-RUM-get-started-create-app-monitor.md) per i CloudWatch canarini Synthetics. Una volta abilitati, i canary appariranno collegati ai servizi richiamati sulla mappa dell'applicazione.
Per impostazione predefinita, il sistema raggruppa i canary in un'unica icona espandibile. Il pannello dettagliato delle informazioni sui canary mostra metriche, tracce e informazioni sullo stato.
Scegli un nodo canary per aprire un pannello contenente informazioni dettagliate sul canary, come mostrato nell'immagine seguente:
![\[Una mappa CloudWatch dell'applicazione che mostra un nodo canarino sintetico espandibile.\]](http://docs.aws.amazon.com/it_it/AmazonCloudWatch/latest/monitoring/images/service-map-canary.png)
Scegli **Visualizza pannello di controllo** per aprire i dettagli del canary.
------
# Osservabilità dell'applicazione per l' AWS azione
L'Application Observability for AWS GitHub Action fornisce un flusso di lavoro di indagine sull'osservabilità delle end-to-end applicazioni che collega il codice sorgente e i dati di telemetria di produzione in tempo reale all'agente AI. Sfrutta CloudWatch MCPs e genera prompt personalizzati per fornire il contesto necessario agli agenti di intelligenza artificiale per la risoluzione dei problemi e l'applicazione di correzioni al codice.
L'azione imposta e configura [CloudWatch Application Signals MCP Server e [CloudWatch MCP Server](https://awslabs.github.io/mcp/servers/cloudwatch-applicationsignals-mcp-server)](https://awslabs.github.io/mcp/servers/cloudwatch-applicationsignals-mcp-server), consentendo loro di accedere ai dati di telemetria in tempo reale come contesto di risoluzione dei problemi. Puoi utilizzare il tuo modello di intelligenza artificiale preferito, tramite la tua chiave API, un modello di terze parti o Amazon Bedrock, per le indagini sulle prestazioni delle applicazioni.
Per iniziare, indica tra i tuoi GitHub problemi l'attivazione dell'agente AI. `@awsapm` L'agente risolverà i problemi di produzione, implementerà le correzioni e migliorerà la copertura dell'osservabilità sulla base dei dati delle applicazioni in tempo reale.
Questa azione di per sé non comporta costi diretti. Tuttavia, l'utilizzo di questa azione può comportare addebiti per AWS i servizi e l'utilizzo del modello di intelligenza artificiale. Per informazioni dettagliate sui [costi potenziali, consulta la documentazione relativa alle considerazioni](https://github.com/marketplace/actions/application-observability-for-aws#-cost-considerations) sui costi.
## Nozioni di base
Questa azione configura gli agenti AI all'interno del GitHub flusso di lavoro generando configurazioni MCP AWS specifiche e prompt di osservabilità personalizzati. Devi solo fornire il ruolo IAM da assumere e un [Bedrock Model ID](https://docs.aws.amazon.com/bedrock/latest/userguide/models-supported.html) che desideri utilizzare o un token API dal tuo abbonamento LLM esistente. L'esempio seguente illustra un modello di flusso di lavoro che integra questa azione con quella di [Anthropic](https://github.com/anthropics/claude-code-base-action) per eseguire indagini automatizzate. claude-code-base-action
### Prerequisiti
Prima di iniziare, assicurati di disporre di quanto segue:
+ **GitHub Autorizzazioni al repository**: accesso in scrittura o superiore al repository (necessario per attivare l'azione)
+ **AWS Ruolo IAM**: un ruolo IAM configurato con OpenID Connect (OIDC) for GitHub Actions con autorizzazioni per:
+ CloudWatch Segnali applicativi e accesso CloudWatch
+ Accesso al modello Amazon Bedrock (se si utilizzano modelli Bedrock)
+ **GitHub Token**: il flusso di lavoro utilizza automaticamente GITHUB\$1TOKEN con le autorizzazioni richieste
### Fasi di configurazione
#### Fase 1: Configurazione AWS delle credenziali
Questa azione si basa sull'azione [aws-actions/](https://github.com/aws-actions/configure-aws-credentials) per configurare AWS l'autenticazione nel tuo configure-aws-credentials Actions Environment. GitHub Ti consigliamo di utilizzare OpenID Connect (OIDC) per l'autenticazione. AWS OIDC consente ai flussi di lavoro GitHub Actions di accedere alle AWS risorse utilizzando credenziali di breve durata, in modo da non dover archiviare AWS credenziali a lungo termine nel repository.
1. **Crea un IAM Identity Provider**
Innanzitutto, crea un IAM Identity Provider che affidi l'endpoint OIDC GitHub dell'utente nella console di gestione: AWS
1. Apri la console IAM
1. Fai clic su **Provider di identità** in **Gestione degli accessi**
1. Fai clic sul pulsante **Aggiungi provider** per aggiungere un provider di GitHub identità se non è ancora stato creato
1. Seleziona il tipo di provider di **identità OpenID Connect**
1. Inserisci `https://token.actions.githubusercontent.com` la casella di immissione dell'**URL del provider**
1. Inserisci `sts.amazonaws.com` la casella di input **Audience**
1. Fai clic sul pulsante **Aggiungi fornitore**
1. **Crea una politica IAM**
Crea una policy IAM con le autorizzazioni necessarie per questa azione. Consulta la [Autorizzazioni richieste](#Service-Application-Observability-for-AWS-GitHub-Action-required-permissions) sezione seguente per i dettagli.
1. **Crea un ruolo IAM**
Crea un ruolo IAM (ad esempio,`AWS_IAM_ROLE_ARN`) nella console di AWS gestione con il seguente modello di policy di fiducia. Ciò consente ai GitHub repository autorizzati di assumere il ruolo:
```
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Principal": {
"Federated": "arn:aws:iam:::oidc-provider/token.actions.githubusercontent.com"
},
"Action": "sts:AssumeRoleWithWebIdentity",
"Condition": {
"StringEquals": {
"token.actions.githubusercontent.com:aud": "sts.amazonaws.com"
},
"StringLike": {
"token.actions.githubusercontent.com:sub": "repo:/:ref:refs/heads/"
}
}
}
]
}
```
Sostituisci i seguenti segnaposto nel modello:
+ ``- L'ID del tuo account AWS
+ ``- Il nome GitHub della tua organizzazione
+ ``- Il nome del tuo repository
+ ``- Il nome della filiale (ad esempio, principale)
1. **Allega la politica IAM**
Nella scheda Autorizzazioni del ruolo, allega la policy IAM che hai creato nel passaggio 2.
Per ulteriori informazioni sulla configurazione di OIDC con AWS, consulta la Guida rapida di avvio di [configure-aws-credentials OIDC](https://github.com/aws-actions/configure-aws-credentials/tree/main?tab=readme-ov-file#quick-start-oidc-recommended).
#### Fase 2: Configurazione dei segreti e aggiunta del flusso di lavoro
1. **Configura i segreti del repository**
Vai al tuo repository → Impostazioni → Segreti e variabili → Azioni.
+ Crea un nuovo repository secret denominato `AWS_IAM_ROLE_ARN` e imposta il suo valore sull'ARN del ruolo IAM che hai creato nella fase 1.
+ (Facoltativo) Crea una variabile di repository denominata `AWS_REGION` per specificare la tua AWS regione (il valore predefinito è se non è impostata) `us-east-1`
1. **Aggiungi il file del flusso di lavoro**
Di seguito è riportato un esempio di flusso di lavoro che dimostra l'utilizzo di questa azione con i modelli Amazon Bedrock. Crea il flusso di lavoro Application Observability Investigation da questo modello nella tua GitHub directory Repository. `.github/workflows`
```
name: Application observability for AWS
on:
issue_comment:
types: [created, edited]
issues:
types: [opened, assigned, edited]
jobs:
awsapm-investigation:
if: |
(github.event_name == 'issue_comment' && contains(github.event.comment.body, '@awsapm')) ||
(github.event_name == 'issues' && (contains(github.event.issue.body, '@awsapm') || contains(github.event.issue.title, '@awsapm')))
runs-on: ubuntu-latest
permissions:
contents: write # To create branches for PRs
pull-requests: write # To post comments on PRs
issues: write # To post comments on issues
id-token: write # Required for AWS OIDC authentication
steps:
- name: Checkout repository
uses: actions/checkout@v4
- name: Configure AWS credentials
uses: aws-actions/configure-aws-credentials@v4
with:
role-to-assume: ${{ secrets.AWS_IAM_ROLE_ARN }}
aws-region: ${{ vars.AWS_REGION || 'us-east-1' }}
# Step 1: Prepare AWS MCP configuration and investigation prompt
- name: Prepare Investigation Context
id: prepare
uses: aws-actions/application-observability-for-aws@v1
with:
bot_name: "@awsapm"
cli_tool: "claude_code"
# Step 2: Execute investigation with Claude Code
- name: Run Claude Investigation
id: claude
uses: anthropics/claude-code-base-action@beta
with:
use_bedrock: "true"
# Set to any Bedrock Model ID
model: "us.anthropic.claude-sonnet-4-5-20250929-v1:0"
prompt_file: ${{ steps.prepare.outputs.prompt_file }}
mcp_config: ${{ steps.prepare.outputs.mcp_config_file }}
allowed_tools: ${{ steps.prepare.outputs.allowed_tools }}
# Step 3: Post results back to GitHub issue/PR (reuse the same action)
- name: Post Investigation Results
if: always()
uses: aws-actions/application-observability-for-aws@v1
with:
cli_tool: "claude_code"
comment_id: ${{ steps.prepare.outputs.awsapm_comment_id }}
output_file: ${{ steps.claude.outputs.execution_file }}
output_status: ${{ steps.claude.outputs.conclusion }}
```
**Nota di configurazione:**
+ Questo flusso di lavoro si attiva automaticamente quando `@awsapm` viene menzionato in un problema o in un commento
+ Il flusso di lavoro utilizza il `AWS_IAM_ROLE_ARN` segreto configurato nel passaggio precedente
+ Aggiorna il parametro del modello nel passaggio 2 per specificare l'ID del modello Amazon Bedrock preferito
+ Puoi personalizzare il nome del bot (ad esempio`@awsapm-prod`,`@awsapm-staging`) nel parametro bot\$1name per supportare ambienti diversi
#### Passaggio 3: Inizia a utilizzare l'azione
Una volta configurato il flusso di lavoro, `@awsapm` segnalalo qualsiasi GitHub problema per avviare un'indagine basata sull'intelligenza artificiale. L'azione analizzerà la tua richiesta, accederà ai dati di telemetria in tempo reale e fornirà consigli o implementerà automaticamente le correzioni.
**Casi d'uso di esempio:**
1. Analizza i problemi di prestazioni e pubblica e correggi:
`@awsapm, can you help me investigate availability issues in my appointment service?`
![\[alt text not found\]](http://docs.aws.amazon.com/it_it/AmazonCloudWatch/latest/monitoring/images/github-availability-issue-investigate.png)
`@awsapm, can you post a fix?`
![\[alt text not found\]](http://docs.aws.amazon.com/it_it/AmazonCloudWatch/latest/monitoring/images/github-availability-issue-pr-fix.png)
1. Abilita la strumentazione:
`@awsapm, please enable Application Signals for lambda-audit-service and create a PR with the required changes.`
1. Interroga i dati di telemetria:
`@awsapm, how many GenAI tokens have been consumed by my services in the past 24 hours?`
**Cosa succede dopo:**
1. Il flusso di lavoro rileva la `@awsapm` menzione e avvia l'indagine
1. L'agente AI accede ai dati di AWS telemetria in tempo reale tramite i server MCP configurati
1. L'agente analizza il problema e può:
+ Pubblica risultati e consigli direttamente nel numero
+ Crea una pull request con modifiche al codice (per strumentazione o correzioni)
1. Puoi rivedere i risultati e continuare la conversazione citando nuovamente @awsapm con domande di follow-up
## Sicurezza
Questa azione dà priorità alla sicurezza con controlli di accesso rigorosi, AWS autenticazione basata su OIDC e protezioni integrate contro gli attacchi di pronta iniezione. Solo gli utenti con accesso in scrittura o superiore possono attivare l'azione e tutte le operazioni sono limitate al repository specifico.
Per informazioni dettagliate sulla sicurezza, tra cui:
+ Requisiti di autorizzazione e controllo degli accessi
+ AWS Autorizzazioni IAM e configurazione OIDC
+ Rischi e mitigazioni dell'iniezione tempestiva
+ Best practice di sicurezza
Consulta la documentazione sulla [sicurezza](https://github.com/aws-actions/application-observability-for-aws/blob/main/docs/security.md).
## Configurazione
### Autorizzazioni richieste
Il ruolo IAM assunto da GitHub Actions deve disporre delle seguenti autorizzazioni.
**Nota**: `bedrock:InvokeModel` `bedrock:InvokeModelWithResponseStream` sono obbligatori solo se utilizzi modelli Amazon Bedrock
```
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"application-signals:ListServices",
"application-signals:GetService",
"application-signals:ListServiceOperations",
"application-signals:ListServiceLevelObjectives",
"application-signals:GetServiceLevelObjective",
"application-signals:ListAuditFindings",
"cloudwatch:DescribeAlarms",
"cloudwatch:DescribeAlarmHistory",
"cloudwatch:ListMetrics",
"cloudwatch:GetMetricData",
"cloudwatch:GetMetricStatistics",
"logs:DescribeLogGroups",
"logs:DescribeQueryDefinitions",
"logs:ListLogAnomalyDetectors",
"logs:ListAnomalies",
"logs:StartQuery",
"logs:StopQuery",
"logs:GetQueryResults",
"logs:FilterLogEvents",
"xray:GetTraceSummaries",
"xray:GetTraceSegmentDestination",
"xray:BatchGetTraces",
"xray:ListRetrievedTraces",
"xray:StartTraceRetrieval",
"servicequotas:GetServiceQuota",
"synthetics:GetCanary",
"synthetics:GetCanaryRuns",
"s3:GetObject",
"s3:ListBucket",
"iam:GetRole",
"iam:ListAttachedRolePolicies",
"iam:GetPolicy",
"iam:GetPolicyVersion",
"bedrock:InvokeModel",
"bedrock:InvokeModelWithResponseStream"
],
"Resource": "*"
}
]
}
```
## Documentazione
Per ulteriori informazioni, consulta:
+ [CloudWatch Documentazione Application Signals](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Application-Monitoring-Intro.html): scopri le caratteristiche e le funzionalità di CloudWatch Application Signals
+ [Osservabilità delle applicazioni per AWS Action Public Documentation](https://github.com/marketplace/actions/application-observability-for-aws) - Guide e tutorial dettagliati
# Esempio: utilizzo di Application Signals per risolvere un problema di integrità operativa
Lo scenario seguente fornisce un esempio di come Application Signals può essere utilizzato per monitorare i servizi e identificare problemi di qualità. Approfondisci per identificare le cause principali potenziali e intervenire per risolvere il problema. Questo esempio è incentrato su un'applicazione per una clinica per animali composta da diversi microservizi che chiamano Servizi AWS DynamoDB.
Jane fa parte di un DevOps team che supervisiona lo stato operativo di un'applicazione di clinica per animali domestici. Il team di Jane si impegna a garantire che l'applicazione sia altamente disponibile e reattiva. Utilizzano [gli obiettivi del livello di servizio (SLOs)](CloudWatch-ServiceLevelObjectives.md) per misurare le prestazioni delle applicazioni rispetto a questi impegni aziendali. Riceve un avviso relativo a diversi indicatori del livello di servizio non corretti (SLIs). Apre la CloudWatch console e accede alla pagina Servizi, dove vede diversi servizi in uno stato non integro.
![\[Servizi con problemi di salute SLIs\]](http://docs.aws.amazon.com/it_it/AmazonCloudWatch/latest/monitoring/images/example-scenario-services-page.jpg)
Nella parte superiore della pagina, Jane vede che `visits-service` è il servizio migliore per quanto riguarda la percentuale di guasti. Seleziona il collegamento nel grafico, che apre la pagina dei dettagli del servizio. Vede che c'è un'operazione non integra nella tabella delle operazioni del servizio. Seleziona questa operazione e vede nel grafico Volume e Disponibilità che ci sono picchi periodici di volume delle chiamate che sembrano essere correlati ai cali di disponibilità.
![\[Volume e disponibilità delle operazioni del servizio\]](http://docs.aws.amazon.com/it_it/AmazonCloudWatch/latest/monitoring/images/example-scenario-unhealthy-operation.png)
Per esaminare ulteriormente i cali di disponibilità del servizio, Jane seleziona uno dei punti dati della disponibilità nel grafico. Si apre un cassetto che mostra le tracce X-Ray correlate al punto dati selezionato. Vede che ci sono più tracce contenenti errori.
![\[Disponibilità del servizio e tracce correlate\]](http://docs.aws.amazon.com/it_it/AmazonCloudWatch/latest/monitoring/images/example-scenario-correlated-traces.jpg)
Jane seleziona una delle tracce correlate con uno stato di errore, aprendo la relativa pagina dei dettagli del tracciamento X-Ray. Jane scorre verso il basso fino alla sezione relativa alla sequenza temporale dei segmenti e segue il percorso della chiamata finché non vede che le chiamate a una tabella DynamoDB restituiscono errori. Seleziona il segmento DynamoDB e accede alla scheda Eccezioni del cassetto a destra.
![\[Segmento di traccia con errori DynamoDB\]](http://docs.aws.amazon.com/it_it/AmazonCloudWatch/latest/monitoring/images/example-scenario-DDB-segment.jpg)
Jane rileva che una risorsa DynamoDB non è configurata correttamente, con conseguenti errori durante i picchi di richieste dei clienti. Il livello di throughput assegnato alla tabella DynamoDB viene periodicamente superato, con conseguenti problemi di disponibilità del servizio e problemi di integrità. SLIs Sulla base di queste informazioni, il suo team può configurare un livello più alto di velocità di trasmissione effettiva assegnata e garantire un'elevata disponibilità dell'applicazione.
# Esempio: utilizza Application Signals per risolvere i problemi delle applicazioni di intelligenza artificiale generativa che interagiscono con i modelli Amazon Bedrock
Puoi utilizzare Application Signals per risolvere i problemi delle tue applicazioni di intelligenza artificiale generativa che interagiscono con i modelli. Amazon Bedrock Application Signals semplifica questo processo fornendo dati di out-of-the-box telemetria e offrendo informazioni più approfondite sulle interazioni dell'applicazione con i modelli LLM. Aiuta a risolvere casi d'uso chiave come:
+ Problemi di configurazione del modello
+ Costi di utilizzo del modello
+ Latenza del modello
+ Motivi dell'interruzione nella generazione delle risposte del modello
[L'abilitazione di Application Signals](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Application-Signals-Enable.html) with LLM/GenAI Observability offre visibilità in tempo reale sulle interazioni dell'applicazione con i servizi Amazon Bedrock. Application Signals genera e correla automaticamente i parametri e le tracce delle prestazioni per le chiamate API. Amazon Bedrock
Application Signals attualmente supporta i seguenti modelli LLM di Amazon Bedrock.
+ AI21 Jamba
+ Amazon Titan
+ Anthropic Claude
+ Cohere Command
+ Meta Llama
+ Mistral AI
+ Nova
## Metriche e tracce granulari
Per ogni chiamata Amazon Bedrock API, Application Signals genera metriche dettagliate sulle prestazioni a livello di risorsa, tra cui:
+ ID modello
+ ID guardrail
+ ID Knowledge Base
+ ID dell'agente Bedrock
Inoltre, gli intervalli di traccia correlati allo stesso livello aiutano a fornire una visione completa dell'esecuzione delle richieste e delle dipendenze.
![\[Metriche delle prestazioni con Application Signals.\]](http://docs.aws.amazon.com/it_it/AmazonCloudWatch/latest/monitoring/images/AppSignalsAIExample.png)
## OpenTelemetry Supporto per gli attributi GenAI
Application Signals genera i seguenti attributi GenAI per le chiamate Amazon Bedrock API con convenzione OpenTelemetry semantica. Questi attributi aiutano ad analizzare l'utilizzo del modello, i costi e la qualità della risposta e possono essere impiegati con [Transaction Search](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Transaction-Search.html) per ottenere informazioni più approfondite.
+ gen\$1ai.system
+ gen\$1ai.request.model
+ gen\$1ai.request.max\$1tokens
+ gen\$1ai.request.temperature
+ gen\$1ai.request.top\$1p
+ gen\$1ai.usage.input\$1tokens
+ gen\$1ai.usage.output\$1tokens
+ gen\$1ai.response.finish\$1reasons
![\[Attributi di IA generativa che utilizzano Application Signals.\]](http://docs.aws.amazon.com/it_it/AmazonCloudWatch/latest/monitoring/images/AppSignalsAIExample_1.png)
Ad esempio, è possibile sfruttare la capacità analitica di Transaction Search per confrontare l'utilizzo e il costo dei token tra diversi modelli LLM per lo stesso prompt, consentendo di selezionare i modelli in base all'efficienza in termini di costi.
![\[Attributi di IA generativa che utilizzano Application Signals.\]](http://docs.aws.amazon.com/it_it/AmazonCloudWatch/latest/monitoring/images/AppSignalsAIExample_2.png)
Per ulteriori informazioni, consulta [Migliorare l' Amazon Bedrock osservabilità con CloudWatch ](https://aws.amazon.com/blogs/mt/improve-amazon-bedrock-observability-with-amazon-cloudwatch-appsignals/) Application Signals.