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à correlata Esplora 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 dell'entità KeyAttributes e, facoltativamente, Attributes l'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 informazioni su come aggiungere informazioni sull'entità, vedere. Informazioni sull'entità in formato EMF

Le sezioni seguenti descrivono come creare KeyAttributes e Attributes in modo che CloudWatch possano identificare le risorse e i servizi associati alla telemetria.

La KeyAttributes proprietà degli oggetti Entity (nei CloudWatch o nei CloudWatch log) identifica in modo univoco l'entità per. CloudWatch È un elenco di coppie chiave-valore. Le entità con lo stesso KeyAttributes sono considerate la stessa entità. La telemetria associata alla stessa entità è considerata correlata e può essere facilmente trovata nel riquadro Esplora correlati.

Nota

Nell' CloudWatch API, viene chiamata la proprietà. KeyAttributes Nell'API CloudWatch Logs, viene chiamata keyAttributes la proprietà. Qui vengono trattati come la stessa proprietà.

Esistono cinque tipi possibili di oggetti che un uomo 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. Questo potrebbe essere usato, ad esempio, quando si chiama l'ListBucketsoperazione, 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 si sta cercando di rappresentare, è necessario fornire le coppie chiave-valore corrette per. KeyAttributes Di seguito viene descritto ogni 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 AWS CloudFormation risorsa. Ad esempio, AWS::DynamoDB::Table.

  • "Identifier": "<resource-id>"— L'identificatore principale della risorsa. Per ulteriori informazioni, vedere PrimaryIdentifier nella Extension Development for User Guide. CloudFormation

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 AWS CloudFormation servizio. 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 esempious-west-2, omyservice.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 Kubernetes Pod.

  • "Identifier": "<resource-id>"— Un identificatore di stringa per la risorsa. Può contenere più nomi, separati da pipe. Ad esempio, un Kubernetes Pod potrebbe essere rappresentato dal nome del cluster, dallo spazio dei nomi e dal nome del pod, ad esempio. MyCluster|MyNamespace|MyPod

RemoteService

Per specificare un servizio remoto, devi includere le seguenti due coppie chiave-valore:

  • "Type": "RemoteService"— Questa coppia chiave-valore identifica l'entità come servizio remoto.

  • "Name": "<remote-service-name>"— Speciifica in che modo l'applicazione si riferisce al servizio esterno in una chiamata remota. Ad esempio, api.test.myservice.com.

Puoi fornire ulteriori dettagli su Entity ciò che fornisci con la telemetria. Ciò può includere dettagli sulla piattaforma, sulla risorsa, sull'applicazione o sul provider 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 trattati come la stessa proprietà.

Dettagli della piattaforma

Parola chiave Utilizzo Dominio dei valori Esempi

PlatformType

Definisce la piattaforma ospitata.

AWS::EKS, AWS::ECS, AWS::EC2, AWS::Lambda, K8s, generico

AWS::EC2

EKS.Cluster

Nome del cluster Amazon EKS.

Stringa alfanumerica con delimitatori di base.

FlyingSquad

K8s.Cluster

Nome del cluster Kubernetes ospitato autonomamente.

Stringa alfanumerica con delimitatori di base.

minicube

K8s.Namespace

Nome dello spazio dei nomi Kubernetes nei cluster Amazon EKS o K8s.

Stringa alfanumerica con delimitatori di base.

default, pet-clinic

K8s.Workload

Nome del carico di lavoro Kubernetes nei cluster Amazon EKS e K8s.

Stringa alfanumerica con delimitatori di base.

frontend

K8s.Node

Identità del nodo Kubernetes nei cluster Amazon EKS e K8s.

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

ip-11-22-33-44.ec2.internal

K8s.Pod

Identità del pod Kubernetes nei cluster Amazon EKS e K8s.

Identificatore del pod K8s.

frontend-1234abcd56-ef7890

EC2.AutoScalingGroup

Nome del EC2 AutoScaling gruppo Amazon.

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

Identità del cluster Amazon ECS.

Nome del cluster Amazon ECS.

MyCluster

ECS.Service

Identità del servizio Amazon ECS.

Nome del servizio Amazon ECS.

MyService

ECS.Task

Identità dell'attività Amazon ECS.

ID attività Amazon ECS.

task-123abc

Lambda.Function

Identità della funzione Lambda.

Nome della funzione Lambda.

MyFunction

Host

Nome dell'host per tutti i tipi di piattaforma.

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

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 dell'applicazione in AppRegistry.

Stringa alfanumerica con delimitatori di base.

PetClinicApp

AWS.Application.ARN

ARN dell'applicazione in. AppRegistry

Stringa alfanumerica con delimitatori di base.

arn:aws:servicecatalog:us-east-1:1234567890:/applications/...

Dettagli del provider di telemetria

Parola chiave Utilizzo Dominio dei valori Esempi

Telemetry.SDK

L'impronta digitale della versione OTEL SDK per servizi strumentati.

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.

Stringa alfanumerica con delimitatori di base.

CWAgent/1.300026.3, ADOTCollector/1.x

Telemetry.Source

Speciifica il punto dell'applicazione in cui è stata raccolta la telemetria o cosa è stato utilizzato come fonte dei dati di telemetria.

ServerSpan,,, Span, ClientSpan JMX ProducerSpan, sistema operativo ConsumerSpan. LocalRoot

ClientSpan, JMX