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

# Come aggiungere informazioni correlate alla telemetria personalizzata inviata a CloudWatch
<a name="adding-your-own-related-telemetry"></a>

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
<a name="custom-related-telemetry-keyattributes"></a>

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": "<resource-type>"`— 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": "<resource-id>"`: 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": "<service-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": "<service-name>"`: rappresenta il nome del servizio che invia le metriche. Ad esempio `my-service-frontend` o `api.myservice.com`.
+ `"Environment": "<environment-name>"`: 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": "<resource-type>"`: una stringa che specifica il tipo di risorsa. Ad esempio, `K8s::Pod` per un pod Kubernetes.
+ `"Identifier": "<resource-id>"`: 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": "<remote-service-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
<a name="custom-related-telemetry-attributes"></a>

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` |