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à.
# Esplorazione della telemetria correlata
I sistemi informatici possono generare una grande quantità di telemetria, inclusi metriche e log, e i sistemi complessi tendono a farlo ancora di più. Quando si esamina un insieme specifico di telemetria, può essere difficile trovare altri dati di telemetria correlati all'insieme iniziale. Per acquisire le competenze necessarie per individuare i problemi e risolverli potrebbe occorrere una formazione avanzata. Poiché i sistemi sono complessi, per comprendere ciò che sta accadendo può essere necessario visualizzare metriche e log di molti servizi e risorse differenti, con la necessità di spostarsi tra contesti e sistemi diversi.
La funzionalità **correlata ad Amazon CloudWatch Explore** offre l'accesso alle relazioni tra le AWS risorse, alle metriche correlate e ai log tra le console di servizio, migliorando l'osservabilità e l'efficienza per gli operatori di tutti i livelli di abilità. Quando visualizzano allarmi o anomalie nelle CloudWatch dashboard o nelle metriche AWS, gli utenti possono trovare e visualizzare rapidamente metriche e registri relativi alle risorse correlate del sistema.
CloudWatch offre visibilità sulle metriche e sui log legati a risorse specifiche e il riquadro **relativo Esplora estende tale visibilità consentendoti di correlare** le risorse dell'infrastruttura ai carichi di lavoro con tutta la telemetria associata. Ciò consente di accedere rapidamente alle informazioni necessarie per risolvere i problemi relativi all'infrastruttura. È possibile visualizzare la relazione tra le risorse e la relativa telemetria nel pannello **Esplora le informazioni correlate**. Il riquadro **relativo a Esplora** è accessibile da CloudWatch o da altre console che mostrano risorse o telemetria AWS .
**Nota**
**Explore related** è attualmente limitato agli account configurati come account di monitoraggio nell'osservabilità tra account. CloudWatch È necessario accedere a **Esplora le informazioni correlate** dagli account di origine in cui le risorse sono state originariamente create e gestite. Negli account di origine, puoi navigare tra le risorse connesse e visualizzare i log e le metriche correlati.
Negli argomenti seguenti vengono descritti i dettagli dell'esplorazione della telemetria correlata.
**Topics**
+ [Cos'è la telemetria correlata?](#what-is-related-telemetry)
+ [Come accedere al pannello Esplora le informazioni correlate](#access-related-telemetry)
+ [Esplorazione della telemetria correlata](#using-related-telemetry)
+ [Utilizzo della mappa della topologia](#using-related-telemetry-map)
+ [Ricerca di una risorsa specifica](#using-related-telemetry-find)
+ [Autorizzazioni e prerequisiti necessari per visualizzare ed esplorare la telemetria correlata](#related-telemetry-permissions)
+ [Come si fa a CloudWatch trovare la telemetria correlata?](how-does-related-telemetry-work.md)
+ [AWS servizi che supportano la telemetria correlata](services-with-related-telemetry.md)
+ [Come aggiungere informazioni correlate alla telemetria personalizzata inviata a CloudWatch](adding-your-own-related-telemetry.md)
## Cos'è la telemetria correlata?
La telemetria correlata è costituita da metriche e dati di log provenienti da risorse correlate alla risorsa o al servizio corrente. Tradizionalmente, è possibile esaminare le metriche e i log relativi a un singolo bilanciatore del carico o tutta la telemetria relativa ad Amazon EC2. La funzionalità **relativa a Explore** in Amazon CloudWatch aggiunge una *mappa topologica* interattiva. La mappa è una visualizzazione incentrata sulle risorse in cui puoi trovare metriche e log per una risorsa specifica, ma puoi anche vedere come quella risorsa è collegata ad altre risorse.
Ad esempio, se stai esaminando la telemetria di un bilanciatore del carico nel pannello **Esplora le informazioni correlate**, oltre alle metriche e ai log associati a quel bilanciatore del carico, le mappe mostrano i gruppi di destinazione per tale bilanciatore. La selezione di uno dei gruppi di destinazione ti mostrerà quindi le istanze Amazon EC2 associate a tale gruppo di destinazione. In ogni fase di questo processo, viene mostrata la telemetria, incluse metriche e log, per le risorse selezionate, in modo da trovare rapidamente la telemetria che stai cercando o esplorarla per individuare la causa di un problema specifico.
## Come accedere al pannello Esplora le informazioni correlate
All'interno della CloudWatch console, ci sono diversi modi per accedere alla telemetria relativa alla visualizzazione corrente. Ad esempio, se stai guardando un grafico su un pannello di controllo e desideri visualizzare la telemetria relativa a tale grafico o a un aspetto dello stesso, puoi scegliere di esplorare i dati correlati direttamente da quel grafico. Da molte posizioni della console, puoi scegliere la voce di menu **Esplora le informazioni correlate** o selezionare l'icona a forma di bussola (![\[Compass icon representing navigation or direction in a user interface.\]](http://docs.aws.amazon.com/it_it/AmazonCloudWatch/latest/monitoring/images/compass-icon.png)) per visualizzare il pannello **Esplora le informazioni correlate**.
Puoi accedere all'esperienza di esplorazione dai punti di accesso della CloudWatch console (e di altre AWS console), tra cui:
+ **Navigazione tra le metriche**: quando scegli **Metriche** quindi **Tutte le metriche** dal menu a sinistra della CloudWatch console, il riquadro relativo a qualsiasi servizio o fonte metrica supportato mostrerà l'icona a forma di bussola che mostra la telemetria correlata nell'angolo in basso a destra.
+ **Legenda metrica**: quando si visualizza un grafico metrico (su CloudWatch o altre AWS console), passando il mouse sulla legenda del grafico vengono visualizzate le informazioni sui dati, oltre a un pulsante **relativo a Esplora** che visualizza la relativa telemetria.
+ **Punti dati delle metriche**: quando si visualizza il grafico di una metrica, il passaggio del mouse su un punto dati nel grafico mostra le informazioni sulla metrica, oltre a un'icona a forma di bussola, per mostrare la relativa telemetria.
+ **Ricerca metrica**: quando cerchi metriche in CloudWatch, se scegli il nome di una metrica trovata, puoi selezionare **Esplora correlato dal menu che compare, che mostrerà la relativa** telemetria.
+ **Barra degli strumenti della console****: in molte pagine della AWS console, la barra degli strumenti della console (in genere nella parte superiore destra della console) include un'icona di CloudWatch servizio, che consente di visualizzare gli strumenti, incluso il riquadro relativo a Esplora. CloudWatch **
A seconda della posizione da cui si accede al pannello, il contesto predefinito del pannello mostrerà un filtro appropriato, se possibile.
## Esplorazione della telemetria correlata
Quando selezioni uno dei punti di accesso al riquadro **relativo a Esplora**, questo viene visualizzato sul lato destro della CloudWatch console. Questo pannello consente di visualizzare e trovare la telemetria relativa alle *entità* nel sistema. Un'entità è una risorsa, ad esempio un'istanza Amazon EC2, o un servizio, ad esempio un'applicazione che hai creato. Puoi lavorare all'interno di questo pannello senza interrompere il flusso di lavoro corrente, poiché si apre sul lato della pagina iniziale.
L'immagine seguente mostra il pannello **Esplora le informazioni correlate** incentrato su una singola istanza Amazon EC2 e le entità associate.
![\[Il pannello Esplora le informazioni correlate, con una singola istanza Amazon EC2 in primo piano e le entità associate.\]](http://docs.aws.amazon.com/it_it/AmazonCloudWatch/latest/monitoring/images/compass-explore-main.png)
La parte superiore del pannello **Esplora le informazioni correlate** è una *mappa della topologia* visiva (mappa) dell'entità corrente e di altre entità correlate. L'entità attualmente selezionata determina il focus del pannello. Esistono due modi per selezionare un'entità.
+ [Mappa della topologia](#using-related-telemetry-map): la *mappa* è una visualizzazione incentrata sull'entità corrente. Visualizza anche tutte le entità correlate, permettendo di navigare all'interno dell'insieme di risorse e servizi correlati tra loro.
+ [Trova altre risorse](#using-related-telemetry-find): puoi utilizzare il pulsante **Trova altre risorse** per filtrare e cercare le entità da utilizzare come focus.
La parte inferiore del pannello mostra una ricerca automatica di metriche e log incentrate sull'entità corrente.
Per impostazione predefinita, il focus è impostato sull'entità corrispondente alla posizione da cui è stato effettuato l'accesso al pannello **Esplora le informazioni correlate**. Ad esempio, se hai effettuato l'accesso facendo clic sull'icona della bussola associata a una metrica di un'istanza Amazon EC2 specifica, il focus verrà impostato su tale istanza Amazon EC2.
Quando selezioni una AWS risorsa come focus nel riquadro **relativo a Esplora**, puoi passare alla console specifica della risorsa per la risorsa selezionata. Ad esempio, se hai selezionato un'istanza Amazon EC2, puoi selezionare il collegamento **Visualizza nella console EC2** per aprire la console Amazon EC2 con tale istanza selezionata.
Quando imposti un focus, le metriche e i log vengono filtrati automaticamente per mostrare la telemetria relativa al focus.
+ **Metriche**: ogni metrica viene mostrata come un grafico per il periodo di tempo che hai scelto.
Proprio come qualsiasi altro grafico della dashboard CloudWatch, puoi passare il mouse sopra o selezionare un grafico per ottenere maggiori informazioni sul grafico metrico e per visualizzare le opzioni, inclusa la visualizzazione nelle metriche. CloudWatch Se si sceglie di visualizzare in, si CloudWatch aprirà la vista delle metriche con lo stesso contesto di visualizzazione del riquadro **correlato a Esplora**, che include le risorse e l'intervallo di tempo.
+ **Schemi di registro**: CloudWatch analizza i gruppi di log associati alla risorsa principale e mostra gli schemi comuni in tali registri. Per ulteriori informazioni sui modelli di log, consulta [l'analisi dei pattern](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/CWL_AnalyzeLogData_Patterns.html) nella *Amazon CloudWatch Logs User Guide*.
Puoi selezionare **Confronta l'intervallo di tempo** per scegliere un altro intervallo di tempo e confrontare i log rispetto ai due intervalli di tempo.
Puoi selezionare **Visualizza in Logs Insights** per analizzare i log in CloudWatch Logs Insights con le stesse opzioni della visualizzazione corrente, tra cui risorse, gruppo di log e intervallo di tempo. Per ulteriori informazioni, consulta [Analyzing log data with CloudWatch Logs Insights](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AnalyzingLogData.html) nella *Amazon CloudWatch Logs* User Guide.
+ **Gruppi di log**: vengono visualizzati i [gruppi di log](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/Working-with-log-groups-and-streams.html) che contengono i log.
Puoi selezionare i gruppi di log ed eseguire una delle operazioni seguenti:
+ Scegli **Inizia tailing nella coda in tempo reale** per visualizzare un elenco di streaming dei nuovi eventi del log man mano che vengono importati per i gruppi di log selezionati. La sessione Live Tail viene avviata nella console. CloudWatch Per ulteriori informazioni su Live Tail, consulta [Troubleshoot with CloudWatch Logs LiveTail nella *Amazon CloudWatch Logs*](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/CloudWatchLogs_LiveTail.html) User Guide.
+ Scegli **Query in Approfondimenti di Logs** per aprire Approfondimenti di Logs con una query rivolta solo a quei gruppi di log, applicando il contesto corrente, comprese le risorse e l'intervallo di tempo.
## Utilizzo della mappa della topologia
La *mappa della topologia* (mappa) è una visualizzazione incentrata sull'entità corrente e sulle relative risorse o servizi. È possibile utilizzare questa visualizzazione interattiva per visualizzare le connessioni tra diverse risorse e servizi ed esplorare le relazioni tra i componenti del sistema. Ad esempio, se stai visualizzando una risorsa di *bilanciatore del carico*, la mappa mostrerà le risorse del *gruppo di destinazione* connesso. La selezione di un gruppo di destinazione mostrerà le istanze associate. La visualizzazione della connettività aiuta gli operatori a comprendere ed esplorare le relazioni tra le diverse risorse e servizi del sistema.
Puoi trascinare la mappa e ingrandirla e rimpicciolirla per vedere più entità associate o concentrarti su un numero inferiore di entità.
Quando selezioni un'entità associata, ad esempio un gruppo di destinazione, il focus del pannello si sposta per mostrare la telemetria relativa a quell'entità. La mappa si aggiorna per concentrarsi sul gruppo di destinazione selezionato, mostrandone le connessioni con altre entità, come il bilanciatore del carico e tutte le istanze Amazon EC2 specificate in tale gruppo di destinazione. Mentre navighi tra le diverse entità nella mappa, le metriche e i log nella parte inferiore del pannello si aggiornano dinamicamente, fornendo la telemetria pertinente per le nuove risorse selezionate.
## Ricerca di una risorsa specifica
Se una risorsa non viene visualizzata nella mappa della topologia, è possibile utilizzare la funzionalità **Trova altre risorse** per individuarla. Puoi filtrare le risorse per tag o tipo, quindi selezionare quelle che stai cercando. Dopo aver trovato le risorse su cui concentrarti, torna alla mappa della topologia incentrata sulle risorse selezionate per esplorare le entità e la telemetria associate.
**Nota**
Le tue risorse potrebbero non comparire nella mappa della topologia per numerose ragioni. Esempio:
La risorsa non è correlata all'entità attualmente selezionata.
Non disponi delle [autorizzazioni](#related-telemetry-permissions) per accedere alle entità o alla telemetria associate.
[La risorsa o il servizio](services-with-related-telemetry.md) potrebbero non supportare la telemetria o le entità associate.
Utilizzando **Trova altre risorse**, puoi scoprire e visualizzare risorse che potrebbero non essere direttamente collegate o visibili nella mappa corrente. In questo modo è possibile accedere a tutti i componenti pertinenti dell'infrastruttura e analizzarli.
**Seleziona una risorsa con Trova risorse.**
1. Apri il riquadro **relativo a Esplora** da uno qualsiasi dei [punti di ingresso della console](#access-related-telemetry). CloudWatch
1. Scegli **Trova risorse**.
1. Scegli l'intervallo di tempo per il quale desideri visualizzare i log o le metriche.
1. Scegli **Tipi di risorsa**, quindi seleziona il tipo di risorsa su cui vuoi concentrarti dall'elenco a discesa, ad esempio le **istanze EC2**.
1. Facoltativamente, filtra il set di risorse fornendo un tag in base a cui filtrare. Puoi farlo selezionando il filtro **Filtra le risorse per tag** o scegliendo l'etichetta **5 tag trovati** (il numero dipende dai tag presenti nel sistema). Questa ti fornisce un elenco di tag tra cui scegliere.
Dopo aver selezionato i tag, l'elenco delle risorse viene automaticamente filtrato solo in base a quelle associate a tali tag.
1. Facoltativamente, scegli una o più risorse specifiche tra quelle trovate che corrispondono ai tuoi filtri.
1. Scegli **Mostra sulla mappa** per tornare alla **Mappa della topologia** con le risorse selezionate.
L'elenco di **Metriche** e **Log** è ora filtrato solo in base ai log e alle metriche associati a quel tipo di risorsa. Puoi scegliere la scheda **Metriche** o **Log** per visualizzare il tipo di telemetria che desideri visualizzare.
## Autorizzazioni e prerequisiti necessari per visualizzare ed esplorare la telemetria correlata
Per esplorare la telemetria correlata, devi ottenere informazioni sulle entità con la telemetria dai tuoi carichi di lavoro e devi disporre delle autorizzazioni appropriate per visualizzare tali dati.
Molti servizi inviano automaticamente le informazioni sulle entità. Per i carichi di lavoro che utilizzano l' CloudWatchagente, è necessario disporre almeno `1.300049.1` della versione dell'agente e configurarlo correttamente. Per informazioni sulla configurazione dell'agente, consulta [Come aggiungere informazioni correlate alla telemetria personalizzata inviata a CloudWatch](adding-your-own-related-telemetry.md). Per i carichi di lavoro in esecuzione su Amazon EKS, devi disporre almeno `v2.3.1-eksbuild.1` della versione del componente aggiuntivo Amazon CloudWatch Observability EKS. Per ulteriori informazioni su questo componente aggiuntivo, consulta [Avvio rapido con il componente aggiuntivo Amazon CloudWatch Observability EKS](Container-Insights-setup-EKS-addon.md).
Per esplorare la telemetria correlata devi accedere con determinate autorizzazioni. L'esplorazione della telemetria correlata è un'attività di sola lettura e richiede almeno l'accesso in sola lettura a. CloudWatch
Le autorizzazioni necessarie per visualizzare le associazioni tra telemetria ed entità sono: `logs:ListLogGroupsForEntity`, `logs:ListEntitiesForLogGroup`, `cloudwatch:ListEntitiesForMetric` e `application-signals:ListObservedEntities`.
Ciascuna delle seguenti policy AWS gestite fornirà le CloudWatch autorizzazioni necessarie per accedere alla telemetria correlata nella console: CloudWatch
+ [CloudWatchFullAccessV2: fornisce accesso completo](https://docs.aws.amazon.com/aws-managed-policy/latest/reference/CloudWatchFullAccessV2.html) a. CloudWatch
+ [CloudWatchReadOnlyAccess](https://docs.aws.amazon.com/aws-managed-policy/latest/reference/CloudWatchReadOnlyAccess.html)— Fornisce accesso in sola lettura a. CloudWatch
+ [ReadOnlyAccess](https://docs.aws.amazon.com/aws-managed-policy/latest/reference/ReadOnlyAccess.html)— Fornisce accesso in sola lettura a AWS servizi e risorse.
Inoltre, è necessario disporre almeno dell'accesso in sola lettura (`Describe*`e`Get*`) a tutte le risorse della mappa topologica, per scoprire e CloudWatch visualizzare le relazioni.
Per ulteriori informazioni sull'utilizzo delle policy per controllare l'accesso, consulta [Gestione dell’accesso tramite policy](auth-and-access-control-cw.md#security_iam_access-manage).
# Come si fa a CloudWatch trovare la telemetria correlata?
Il riquadro **relativo a CloudWatch Esplora** mostra metriche e log correlati tra loro, ma come funziona?
Le metriche e i log a cui vengono inviati CloudWatch possono includere un'*entità* opzionale a cui sono correlati. In genere, l'entità è una rappresentazione dell'oggetto della telemetria. Ad esempio, una metrica sull'utilizzo della CPU riguarda un'istanza Amazon EC2 e utilizza tale istanza come entità. Quando visualizzi tale metrica nel pannello **Esplora le informazioni correlate**, ti vengono mostrati altri dati di telemetria per la stessa istanza.
La *mappa della topologia* (mappa) nel pannello **Esplora le informazioni correlate** mostra la risorsa attualmente selezionata e le *risorse correlate*. Per AWS le risorse, visualizza CloudWatch automaticamente altre risorse che sa essere correlate. Ad esempio, se stai visualizzando un'istanza Amazon EC2, la mappa mostra anche tutti i volumi Amazon EBS collegati all'istanza. La selezione di un volume mostra la telemetria del volume e la mappa viene aggiornata per visualizzare le risorse relative al volume. Visualizza anche le risorse che fanno parte dello stesso *servizio*.
Le informazioni sull'entità associata alla telemetria definiscono la risorsa a cui è associata la telemetria, ad esempio l'istanza Amazon EC2. Tuttavia, possono includere anche dati contestuali sulla risorsa. Ad esempio, se disponi di un'applicazione web che include risorse come un'istanza Amazon EC2 e un database, le informazioni sull'entità possono includere l'applicazione del sito web come servizio. In questo caso, la mappa della topologia mostra il servizio come entità correlata e, quando lo selezioni, visualizza le istanze e il database. Ciò può semplificare la ricerca di tutta la telemetria per un servizio.
**Nota**
CloudWatch deve aver ricevuto dati di telemetria con informazioni sull'entità nelle ultime tre ore per trovare risorse e telemetria correlate.
## Da dove provengono i dati sull'entità?
Esistono diversi modi per ottenere le entità per la telemetria: CloudWatch
+ La maggior parte della telemetria inviata CloudWatch dai AWS servizi viene associata automaticamente alle risorse. Per un elenco completo delle risorse supportate, consulta [AWS servizi che supportano la telemetria correlata](services-with-related-telemetry.md).
+ L' CloudWatch agente aggiunge automaticamente le informazioni sull'entità alla telemetria a cui invia. CloudWatch
**Nota**
Potrebbe essere necessario aggiornare l' CloudWatch agente alla versione più recente per includere i dati dell'entità. Per ulteriori informazioni, consulta [Raccogli metriche, log e tracce utilizzando l'agente CloudWatch](Install-CloudWatch-Agent.md) e [Configura i nomi dei servizi e degli ambienti dell' CloudWatch agente per le entità correlate](CloudWatch-Agent-configure-related-telemetry.md).
+ Quando invii la telemetria, puoi aggiungere ai dati informazioni sulle entità. Per ulteriori informazioni, consulta [Come aggiungere informazioni correlate alla telemetria personalizzata inviata a CloudWatch](adding-your-own-related-telemetry.md).
+ CloudWatch si impegna al massimo per riconoscere le informazioni sull'entità associate ad altri dati di telemetria (ad esempio, telemetria personalizzata a CloudWatch cui si invia senza alcuna informazione sull'entità).
## Da dove provengono i dati sul servizio?
*Oltre a riconoscere le connessioni naturali tra le risorse, ad esempio una risorsa di istanza e una risorsa di volume associata, CloudWatch può anche raggruppare le risorse per servizio.* Ad esempio, un servizio potrebbe essere un'applicazione web. Un'istanza Amazon EC2 con un server web e un'altra con un database possono entrambe far parte dello stesso servizio e risultano collegate nella mappa della topologia basata su tale servizio.
Esistono diversi modi per CloudWatch ottenere un nome di servizio per la telemetria, tra cui:
+ I segnali applicativi per la telemetria strumentata di Hotel utilizzano la variabile di `OTEL_SERVICE_NAME` ambiente utilizzata dalle librerie di OpenTelemetry strumentazione supportate per impostare il nome del servizio.
+ La configurazione dell' CloudWatch agente consente di configurare un nome di servizio. Per ulteriori informazioni, consulta [Configura i nomi dei servizi e degli ambienti dell' CloudWatch agente per le entità correlate](CloudWatch-Agent-configure-related-telemetry.md).
+ I carichi di lavoro Kubernetes utilizzano un nome corrispondente dal cluster, ad esempio Deployment, Pod o Container ReplicaSet, per il nome del servizio.
+ Per i carichi di lavoro Amazon EC2, il servizio può provenire da tag (i tag `service`, `application` o `app`).
**Nota**
Per utilizzare i tag per generare nomi di servizio, devi prima [configurare i metadati dell'istanza](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/work-with-tags-in-IMDS.html#allow-access-to-tags-in-IMDS) per l'istanza Amazon EC2.
+ Quando invii la telemetria di tua proprietà, puoi aggiungere ai dati informazioni sulle entità. Per ulteriori informazioni, consulta [Come aggiungere informazioni correlate alla telemetria personalizzata inviata a CloudWatch](adding-your-own-related-telemetry.md).
+ Quando non può utilizzare quanto sopra, CloudWatch utilizza il nome del ruolo IAM che invia le metriche come nome del servizio. Questo, ad esempio, può fornire un nome del servizio per la telemetria di Amazon ECS.
# AWS servizi che supportano la telemetria correlata
La tabella seguente elenca i AWS servizi che supportano le informazioni relative alle entità correlate nella loro telemetria. CloudWatch Nei servizi o nelle risorse non elencati nella tabella non sono esposte informazioni sulle entità correlate. CloudWatch
**Nota**
Per i servizi che utilizzano l'[CloudWatch agente](Install-CloudWatch-Agent.md), potrebbe essere necessario aggiornare l'agente alla versione più recente per ottenere la telemetria correlata. Per informazioni sull'invio di informazioni sulle entità correlate con metriche personalizzate, consulta [Come aggiungere informazioni correlate alla telemetria personalizzata inviata a CloudWatch](adding-your-own-related-telemetry.md).
| AWS Servizio | Risorsa | Metriche | Log |
| --- | --- | --- | --- |
| Gateway Amazon API | `AWS::ApiGateway::Method` | Sì | No |
| Gateway Amazon API | `AWS::ApiGateway::Resource` | Sì | No |
| Gateway Amazon API | `AWS::ApiGateway::RestApi` | Sì | No |
| Gateway Amazon API | `AWS::ApiGateway::Stage` | Sì | Sì |
| Gateway Amazon API | `AWS::ApiGateway::VpcLink` | Sì | No |
| Gateway Amazon API V2 | `AWS::ApiGatewayV2::Integration` | Sì | No |
| Gateway Amazon API V2 | `AWS::ApiGatewayV2::Route` | Sì | No |
| Gateway Amazon API V2 | `AWS::ApiGatewayV2::Stage` | No | Sì |
| Gateway Amazon API V2 | `AWS::ApiGatewayV2::Api` | Sì | No |
| AWS App Runner | `AWS::AppRunner::Service` | No | Sì |
| AWS Application Migration Service | `AWS::MGN::SourceServer` | Sì | No |
| WorkSpaces Applicazioni Amazon | `AWS::AppStream::Fleet` | Sì | Sì |
| AWS AppSync | `AWS::AppSync::GraphQLApi` | Sì | Sì |
| AWS Scambio di dati B2B | `AWS::B2BI::Transformer` | No | Sì |
| AWS Backup gateway | `AWS::BackupGateway::Hypervisor` | No | Sì |
| Amazon Bedrock | `AWS::Bedrock::KnowledgeBase` | No | Sì |
| Amazon Bedrock | `AWS::Bedrock::ModelId` | Sì | No |
| Amazon Chime | `AWS::Chime::SipMediaApplication` | No | Sì |
| Amazon Chime | `AWS::Chime::VoiceConnector` | No | Sì |
| AWS Clean Rooms | `AWS::CleanRooms::Membership` | No | Sì |
| AWS CloudFormation | | No | Sì |
| AWS CloudFormation Ganci | | No | Sì |
| Amazon CloudFront | `AWS::CloudFront::Distribution` | Sì | Sì |
| AWS CloudTrail | `AWS::CloudTrail::EventDataStore` | No | Sì |
| AWS CloudTrail | `AWS::CloudTrail::Trail` | No | Sì |
| Amazon CloudWatch | `AWS::CloudWatch::MetricStream` | Sì | No |
| CloudWatch Registri Amazon | `AWS::Logs::LogGroup` | Sì | No |
| Amazon CloudWatch RUM | `AWS::RUM::AppMonitor` | No | Sì |
| Amazon CloudWatch Synthetics | `AWS::Synthetics::Canary` | Sì | No |
| AWS CodeBuild | `AWS::CodeBuild::Project` | Sì | No |
| Amazon CodeWhisperer | `AWS::CodeWhisperer::Customization` | No | Sì |
| Pool di utenti Amazon Cognito | `AWS::Cognito::UserPool` | Sì | Sì |
| AWS Config | `AWS::Config::ConfigRule` | No | Sì |
| Amazon Connect | `AWS::Connect::Instance` | No | Sì |
| AWS Database Migration Service | `AWS::DMS::ReplicationInstance` | Sì | No |
| AWS Database Migration Service | `AWS::DMS::ReplicationTask` | Sì | No |
| AWS DataSync | `AWS::Datasync::Agent` | Sì | No |
| AWS DataSync | `AWS::DataSync::Task` | Sì | Sì |
| AWS Directory Service | `AWS::DirectoryService::MicrosoftAD` | No | Sì |
| Amazon DynamoDB | `AWS::DynamoDB::Table` | Sì | No |
| DynamoDB Accelerator | `AWS::DAX::Cluster` | Sì | No |
| Amazon EC2 | `AWS::EC2::CapacityReservation` | Sì | No |
| Amazon EC2 | `AWS::EC2::Instance` | Sì | No |
| Amazon EC2 | `AWS::EC2::FlowLog` | Sì | No |
| Amazon EC2 | `AWS::EC2::NATGateway` | Sì | No |
| Amazon EC2 | `AWS::EC2::NetworkInterface` | Sì | Sì |
| Amazon EC2 | `AWS::EC2::Subnet` | Sì | Sì |
| Amazon EC2 | `AWS::EC2::TransitGateway` | Sì | No |
| Amazon EC2 | `AWS::EC2::TransitGatewayAttachment` | Sì | Sì |
| Amazon EC2 | `AWS::EC2::VerifiedAccessInstance` | No | Sì |
| Amazon EC2 | `AWS::EC2::Volume` | Sì | No |
| Amazon EC2 | `AWS::EC2::VPC` | No | Sì |
| Amazon EC2 | `AWS::EC2::VPNConnection` | Sì | Sì |
| Amazon EC2 Auto Scaling | `AWS::AutoScaling::AutoScalingGroup` | Sì | No |
| AWS Elastic Beanstalk | `AWS::ElasticBeanstalk::Environment` | Sì | No |
| Amazon Elastic Container Service | `AWS::ECS::Cluster` | Sì | Sì |
| Amazon Elastic Container Service | `AWS::ECS::Service` | Sì | Sì |
| Amazon Elastic File System | `AWS::EFS::AccessPoint` | Sì | No |
| Amazon Elastic File System | `AWS::EFS::FileSystem` | Sì | No |
| Amazon Elastic File System | `AWS::EFS::MountTarget` | Sì | No |
| Amazon Elastic Kubernetes Service | `AWS::EKS::Cluster` | Sì | Sì |
| Amazon Elastic Kubernetes Service attivo AWS Fargate | | No | Sì |
| Elastic Load Balancing | `AWS::ElasticLoadBalancing::LoadBalancer` | Sì | No |
| Elastic Load Balancing V2 | `AWS::ElasticLoadBalancingV2::LoadBalancer` | Sì | No |
| Elastic Load Balancing V2 | `AWS::ElasticLoadBalancingV2::TargetGroup` | Sì | No |
| Amazon ElastiCache | `AWS::ElastiCache::CacheCluster` | Sì | Sì |
| AWS Elemental MediaConvert | `AWS::MediaConvert::Queue` | Sì | No |
| AWS Elemental MediaLive | | No | Sì |
| AWS Elemental MediaLive | `AWS::MediaLive::Channel` | Sì | No |
| AWS Elemental MediaPackage | `AWS::MediaPackage::Channel` | Sì | No |
| AWS Elemental MediaStore | `AWS::MediaStore::Container` | Sì | Sì |
| AWS Elemental MediaTailor | | No | Sì |
| Amazon EMR | `AWS::EMR::Cluster` | Sì | Sì |
| Amazon EventBridge | `AWS::Events::Rule` | Sì | Sì |
| EventBridge Tubi Amazon | `AWS::Pipes::Pipe` | Sì | Sì |
| AWS Fault Injection Service | `AWS::FIS::ExperimentTemplate` | No | Sì |
| Amazon FinSpace | `AWS::FinSpace::Environment` | No | Sì |
| Amazon FSx | `AWS::FSx::FileSystem` | Sì | No |
| GameLift Server Amazon | `AWS::GameLift::Fleet` | Sì | No |
| AWS Glue | `AWS::Glue::Job` | No | Sì |
| AWS Sincronizzazione identità | `AWS::IdentitySync::Profile` | No | Sì |
| Amazon Interactive Video Service | `AWS::IVSChat::LoggingConfiguration` | Sì | Sì |
| AWS IoT | `AWS::IoT::TopicRule` | Sì | Sì |
| AWS IoT 1-Click | `AWS::IoT1Click::Device` | Sì | No |
| AWS IoT Events | | No | Sì |
| AWS IoT FleetWise | `AWS::IoTFleetWise::Vehicle` | No | Sì |
| AWS IoT SiteWise | | No | Sì |
| AWS Key Management Service | `AWS::KMS::Key` | Sì | No |
| Servizio gestito da Amazon per Apache Flink | `AWS::KinesisAnalytics::Application` | Sì | Sì |
| Amazon Data Firehose | `AWS::KinesisFirehose::DeliveryStream` | Sì | Sì |
| Amazon Kinesis Data Streams | `AWS::Kinesis::Stream` | Sì | No |
| Amazon Kinesis Video Streams | `AWS::KinesisVideo::Stream` | Sì | No |
| AWS Lambda | `AWS::Lambda::Function` | Sì | No |
| Amazon Lex | | No | Sì |
| Modernizzazione del mainframe AWS | `AWS::M2::Application` | No | Sì |
| Amazon Managed Streaming per Apache Kafka | `AWS::Kafka::Cluster` | Sì | No |
| Amazon Managed Streaming per Apache Kafka | `AWS::KafkaConnect::Connector` | No | Sì |
| Amazon Managed Streaming per Apache Kafka | `AWS::MSK::Cluster` | Sì | Sì |
| Amazon MemoryDB | `AWS::Mmemorydb::Cluster` | Sì | No |
| Amazon MQ | `AWS::AmazonMQ::Broker` | Sì | Sì |
| AWS Network Firewall | `AWS::NetworkFirewall::Firewall` | Sì | Sì |
| OpenSearch Servizio Amazon | `AWS::OpenSearchService::Domain` | Sì | No |
| OpenSearch Servizio Amazon | | No | Sì |
| Ingestione OpenSearch di servizi Amazon | `AWS::OSIS::Pipeline` | No | Sì |
| AWS Organizations | `AWS::Organizations::Organization` | No | Sì |
| AWS Outposts | `AWS::Outposts::Outpost` | Sì | No |
| Amazon Managed Service per Prometheus | `AWS::Prometheus::Resource` | Sì | No |
| Amazon Q Business | | No | Sì |
| Amazon QLDB | `AWS::QLDB::Ledger` | Sì | No |
| Amazon Quick | `AWS::Quicksight::Dashboard` | Sì | No |
| Amazon Quick | `AWS::Quicksight::DataSet` | Sì | No |
| Amazon Redshift | `AWS::Redshift::Cluster` | Sì | Sì |
| Amazon Redshift Serverless | `AWS::RedshiftServerless::Workgroup` | Sì | No |
| Amazon Relational Database Service | `AWS::RDS::DBCluster` | Sì | Sì |
| Amazon Relational Database Service | `AWS::RDS::DBInstance` | Sì | Sì |
| Amazon Route 53 | `AWS::Route53::HealthCheck` | Sì | Sì |
| Amazon Route 53 | `AWS::Route53::HostedZone` | Sì | No |
| Amazon Route 53 Resolver | `AWS::Route53Resolver::ResolverEndpoint` | Sì | No |
| Simple Storage Service (Amazon S3) | `AWS::S3::Bucket` | Sì | No |
| Amazon SageMaker AI | `AWS::SageMaker::Endpoint` | Sì | No |
| Amazon SageMaker AI | `AWS::SageMaker::Workteam` | No | Sì |
| AWS Service Catalog | `AWS::ServiceCatalog::CloudFormationProduct` | Sì | No |
| Amazon Simple Email Service | `AWS::SES::ConfigurationSet` | Sì | No |
| Amazon Simple Notification Service | `AWS::SNS::Topic` | Sì | Sì |
| Amazon Simple Notification Service | | No | Sì |
| Amazon Simple Queue Service | `AWS::SQS::Queue` | Sì | No |
| AWS Step Functions | `AWS::StepFunctions::Activity` | Sì | No |
| AWS Step Functions | `AWS::StepFunctions::StateMachine` | Sì | Sì |
| Gateway di archiviazione AWS | `AWS::StorageGateway::Gateway` | Sì | No |
| Gateway di archiviazione AWS | `AWS::StorageGateway::Share` | No | Sì |
| AWS Transfer Family | `AWS::Transfer::Server` | Sì | Sì |
| Amazon VPC Lattice | `AWS::VpcLattice::Service` | No | Sì |
| AWS WAFV2 | `AWS::WAFv2::WebAcl` | No | Sì |
| Amazon WorkMail | `AWS::WorkMail::Organization` | Sì | No |
| Amazon WorkSpaces | `AWS::WorkSpaces::Workspace` | Sì | Sì |
# Come aggiungere informazioni correlate alla telemetria personalizzata inviata a CloudWatch
Quando pubblichi le tue metriche e i tuoi log su CloudWatch, le informazioni sull'entità necessarie per la telemetria correlata non sono presenti per impostazione predefinita. Quando invii metriche CloudWatch o registri a CloudWatch Logs (con le [PutLogEvents](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutLogEvents.html)operazioni or), puoi aggiungere informazioni sull'entità a tali log [PutMetricData](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_PutMetricData.html)o metriche. Le informazioni sull'entità sono associate alla telemetria e utilizzate nella funzionalità **Esplora le informazioni correlate** per trovare la telemetria correlata associata alla stessa entità.
L'entità inviata con la telemetria rappresenta una risorsa o un servizio a cui è associata la telemetria, Ad esempio, una metrica relativa a un servizio o che proviene da una risorsa. AWS Per identificare l'entità associata al codice, è necessario creare un insieme di `KeyAttributes` e, facoltativamente, `Attributes` dell'entità.
**Nota**
CloudWatch può trovare risorse correlate solo per le entità a cui è stata inviata la telemetria nelle tre ore precedenti. Se la tua risorsa emette solo pochi dati di telemetria (meno di una volta ogni 3 ore), potresti voler inviare ulteriori dati di telemetria del *battito cardiaco*, per mantenere attiva l'entità all'interno. CloudWatch
Per ulteriori informazioni su come aggiungere informazioni sulle entità, consulta [Informazioni sulle entità in formato EMF](CloudWatch_Embedded_Metric_Format_Specification.md#entity-information-emf-format).
Nelle sezioni seguenti viene descritto come creare e identificare le risorse `KeyAttributes` e i servizi associati `Attributes` alla CloudWatch telemetria.
## Identificazione dell'entità con l'oggetto KeyAttributes
La `KeyAttributes` proprietà degli oggetti Entity ([nei CloudWatch o nei CloudWatch ](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_Entity.html) [log](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_Entity.html)) identifica in modo univoco l'entità per. CloudWatch Si tratta di un elenco di coppie chiave-valore. Le entità aventi il medesimo valore di `KeyAttributes` sono considerate come aventi lo stesso valore. La telemetria associata alla stessa entità è considerata correlata e può essere facilmente individuata nel pannello **Esplora le informazioni correlate**.
**Nota**
Nell' CloudWatch API, viene chiamata la proprietà. `KeyAttributes` Nell'API CloudWatch Logs, viene chiamata `keyAttributes` la proprietà. Qui vengono trattate come la medesima proprietà.
Esistono cinque tipi possibili di oggetti che un valore `Entity` può rappresentare.
+ **AWS::Resource**— L'entità rappresenta una AWS risorsa, ad esempio una tabella DynamoDB o un'istanza Amazon EC2.
+ **AWS::Service**— L'entità rappresenta un AWS servizio, ad esempio Amazon S3. Questa potrebbe essere usata, ad esempio, quando si chiama l'operazione `ListBuckets`, che non è associata a una risorsa Amazon S3 specifica.
+ **Servizio**: l'entità rappresenta un carico di lavoro in esecuzione nel tuo account. Ad esempio, un'applicazione o un servizio che gestisci.
+ **Risorsa**: l'entità rappresenta una risorsa che non è gestita AWS, ad esempio, dalle risorse del sistema operativo, come processi o volumi di file.
+ **RemoteService**— L'entità rappresenta un servizio esterno in una chiamata remota. Ad esempio, una chiamata remota a un database, una cache esterna o un endpoint esterno.
A seconda del tipo di cui sopra che desideri rappresentare, è necessario fornire le coppie chiave-valore corrette per `KeyAttributes`. Di seguito viene descritto ciascun tipo.
------
#### [ AWS::Resource ]
Per specificare una AWS risorsa, è necessario includere le seguenti tre coppie chiave-valore:
+ `"Type": "AWS::Resource"`— Questa coppia chiave-valore identifica l'entità come risorsa. AWS
+ `"ResourceType": ""`— Il valore di stringa di `ResourceType` è la stringa del tipo di CloudFormation [risorsa](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-template-resource-type-ref.html). Ad esempio, `AWS::DynamoDB::Table`.
+ `"Identifier": ""`: l'identificativo primario della risorsa. Per ulteriori informazioni, vedere [PrimaryIdentifier](https://docs.aws.amazon.com/cloudformation-cli/latest/userguide/resource-type-schema.html#schema-properties-primaryidentifier) nella *Extension Development for CloudFormation * User Guide.
------
#### [ AWS::Service ]
Per specificare un AWS servizio, è necessario includere le due coppie chiave-valore seguenti:
+ `"Type": "AWS::Service"`— Questa coppia chiave-valore identifica l'entità come servizio. AWS
+ `"Name": ""`: il valore di `Name` è la stringa del [nome del servizio](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-template-resource-type-ref.html) CloudFormation . Ad esempio, `AWS::DynamoDB`.
------
#### [ Service ]
Per specificare un servizio che non è gestito da AWS, è necessario includere le seguenti tre coppie chiave-valore:
+ `"Type": "Service"`: questa coppia chiave-valore identifica l'entità come servizio.
+ `"Name": ""`: rappresenta il nome del servizio che invia le metriche. Ad esempio `my-service-frontend` o `api.myservice.com`.
+ `"Environment": ""`: questo attributo specifica dove è ospitato il servizio o l'ambiente a cui appartiene. Ad esempio `us-west-2` o `myservice.production`.
------
#### [ Resource ]
Per specificare una risorsa non fornita da AWS, è necessario includere le tre coppie chiave-valore seguenti:
+ `"Type": "Resource"`: questa coppia chiave-valore identifica l'entità come risorsa.
+ `"ResourceType": ""`: una stringa che specifica il tipo di risorsa. Ad esempio, `K8s::Pod` per un pod Kubernetes.
+ `"Identifier": ""`: l'identificativo della stringa per la risorsa. Può contenere più nomi, separati da barre verticali. Ad esempio, un pod Kubernetes potrebbe essere rappresentato dal nome del cluster, dal namespace e dal nome del pod, ad esempio `MyCluster|MyNamespace|MyPod`.
------
#### [ RemoteService ]
Per specificare un servizio remoto, è necessario includere le seguenti due coppie chiave-valore:
+ `"Type": "RemoteService"`: questa coppia chiave-valore identifica l'entità come servizio remoto.
+ `"Name": ""`: specifica in che modo l'applicazione si riferisce al servizio esterno in una chiamata remota. Ad esempio, `api.test.myservice.com`.
------
## Fornitura di dettagli aggiuntivi sull'entità con l'oggetto Attributi
Puoi fornire ulteriori dettagli sulla `Entity` che fornisci con la telemetria. Ad esempio, dettagli sulla piattaforma, sulla risorsa, sull'applicazione o sul fornitore di telemetria. Le tabelle seguenti descrivono le parole chiave che è possibile utilizzare per ciascuno di questi tipi di dati.
**Nota**
Nell' CloudWatch API, viene chiamata la proprietà`Attributes`. Nell'API CloudWatch Logs, viene chiamata `attributes` la proprietà. Qui vengono trattate come la medesima proprietà.
**Dettagli della piattaforma**
| Parola chiave | Utilizzo | Dominio dei valori | Esempi |
| --- | --- | --- | --- |
| `PlatformType` | Definisce la piattaforma ospitante. | AWS::EKS, AWS::ECS, AWS::EC2, AWS::Lambda, K8s, Generico | `AWS::EC2` |
| `EKS.Cluster` | Il nome del cluster Amazon EKS. | Una stringa alfanumerica con delimitatori di base. | `FlyingSquad` |
| `K8s.Cluster` | Il nome del cluster Kubernetes in hosting autonomo. | Una stringa alfanumerica con delimitatori di base. | `minicube` |
| `K8s.Namespace` | Il nome del namespace Kubernetes nei cluster Amazon EKS o K8s. | Una stringa alfanumerica con delimitatori di base. | `default`, `pet-clinic` |
| `K8s.Workload` | Il nome del carico di lavoro Kubernetes nei cluster Amazon EKS o K8s. | Una stringa alfanumerica con delimitatori di base. | `frontend` |
| `K8s.Node` | L'identità del nodo Kubernetes nei cluster Amazon EKS o K8s. | Il nome del nodo K8s (ad esempio, nome DNS dell'istanza Amazon EC2). | `ip-11-22-33-44.ec2.internal` |
| `K8s.Pod` | L'identità del pod Kubernetes nei cluster Amazon EKS o K8s. | L'identificativo del pod K8s. | `frontend-1234abcd56-ef7890` |
| `EC2.AutoScalingGroup` | Nome del gruppo Amazon EC2 AutoScaling . | Una stringa alfanumerica con delimitatori di base. | `my-asg-name-1` |
| `EC2.InstanceId` | L'identità dell'istanza Amazon EC2. | L'identificativo dell'istanza Amazon EC2. | `i-1234abcd5678ef90` |
| `ECS.Cluster` | L'identità del cluster Amazon ECS. | Il nome del cluster Amazon ECS. | `MyCluster` |
| `ECS.Service` | L'identità del servizio Amazon ECS. | Il nome del servizio Amazon ECS. | `MyService` |
| `ECS.Task` | L'identità dell'attività Amazon ECS. | L'ID dell'attività Amazon ECS. | `task-123abc` |
| `Lambda.Function` | L'identità della funzione Lambda. | Il nome della funzione Lambda. | `MyFunction` |
| `Host` | Il nome dell'host per tutti i tipi di piattaforma. | Il formato del sottodominio. | `ip-111-22-33-44.example.com` |
**Dettagli delle risorse**
| Parola chiave | Utilizzo | Dominio dei valori | Esempi |
| --- | --- | --- | --- |
| `AWS.Resource.ARN` | ARN per la risorsa. AWS | Una stringa alfanumerica con delimitatori di base. | `arn:aws:dynamodb:us-east-1:123456789012:table/myDynamoDBTable` |
**Dettagli dell'applicazione**
| Parola chiave | Utilizzo | Dominio dei valori | Esempi |
| --- | --- | --- | --- |
| `AWS.Application` | Nome della domanda in AppRegistry. | Una stringa alfanumerica con delimitatori di base. | `PetClinicApp` |
| `AWS.Application.ARN` | ARN dell'applicazione in. AppRegistry | Una stringa alfanumerica con delimitatori di base. | `arn:aws:servicecatalog:us-east-1:1234567890:/applications/...` |
**Dettagli del fornitore di telemetria**
| Parola chiave | Utilizzo | Dominio dei valori | Esempi |
| --- | --- | --- | --- |
| `Telemetry.SDK` | L'impronta digitale della versione dell'SDK OTEL per servizi instrumentati. | Una stringa alfanumerica con delimitatori di base. | `opentelemetry,1.32.0-aws-SNAPSHOT,java,Auto` |
| `Telemetry.Agent` | L'impronta digitale dell'agente utilizzata per raccogliere e inviare dati di telemetria. | Una stringa alfanumerica con delimitatori di base. | `CWAgent/1.300026.3, ADOTCollector/1.x` |
| `Telemetry.Source` | Specifica il punto dell'applicazione in cui è stata raccolta la telemetria o cosa è stato utilizzato come origine dei dati di telemetria. | ServerSpan,, ClientSpan, ProducerSpan, LocalRoot Span ConsumerSpan, JMX, sistema operativo. | `ClientSpan, JMX` |