Come aggiungere informazioni correlate alla telemetria personalizzata inviata a CloudWatch - Amazon CloudWatch
Entità KeyAttributesAttributi dell'entità

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

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 PutLogEventsoperazioni or), puoi aggiungere informazioni sull'entità a tali log PutMetricDatao 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 telemetria limitata (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.

Nelle sezioni seguenti viene descritto come creare e identificare le risorse KeyAttributes e i servizi associati Attributes alla CloudWatch telemetria.

La KeyAttributes proprietà degli oggetti Entity (nei CloudWatch o nei CloudWatch log) 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. Ad esempio, AWS::DynamoDB::Table.

  • "Identifier": "<resource-id>": l'identificativo primario della risorsa. Per ulteriori informazioni, vedere 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 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.

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.

Nome del nodo K8s (ad esempio, nome DNS dell' EC2 istanza Amazon).

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 EC2 AutoScaling gruppo Amazon.

Una stringa alfanumerica con delimitatori di base.

my-asg-name-1

EC2.InstanceId

Identità dell' EC2 istanza Amazon.

Identificatore di EC2 istanza Amazon.

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