Wie füge ich verwandte Informationen zur benutzerdefinierten Telemetrie hinzu, die an gesendet wird CloudWatch - Amazon CloudWatch
Entität KeyAttributesEntitätsattribute

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Wie füge ich verwandte Informationen zur benutzerdefinierten Telemetrie hinzu, die an gesendet wird CloudWatch

Wenn Sie Ihre eigenen Messwerte und Logs veröffentlichen, sind die Entitätsinformationen CloudWatch, die für die zugehörige Telemetrie benötigt werden, standardmäßig nicht vorhanden. Wenn Sie Metriken an Logs CloudWatch oder Logs an CloudWatch Logs senden (mit den PutLogEventsOperationen PutMetricDataoder), können Sie Entitätsinformationen zu diesen Logs oder Metriken hinzufügen. Die Entitätsinformationen werden mit der Telemetrie verknüpft und im Feature Verwandte erkunden verwendet, um verwandte Telemetriedaten zu finden, die derselben Entität zugeordnet sind.

Die mit den Telemetriedaten gesendete Entität stellt eine Ressource oder einen Service dar, mit dem die Telemetrie verknüpft ist. Zum Beispiel eine Metrik über einen Service oder eine Metrik, die von einer AWS Ressource stammt. Um die Entität zu identifizieren, die mit Ihrem Code verknüpft ist, erstellen Sie eine Gruppe von KeyAttributes und optional Attributes der Entität.

Anmerkung

CloudWatch kann nur verwandte Ressourcen für Entitäten finden, an die innerhalb der letzten drei Stunden Telemetriedaten gesendet wurden. Wenn Ihre Ressource nur spärliche Telemetriedaten sendet (weniger als einmal alle 3 Stunden), möchten Sie möglicherweise zusätzliche Heartbeat-Telemetriedaten senden, damit die Entität innerhalb dieser Zeit aktiv bleibt. CloudWatch

Weitere Informationen über das Hinzufügen von Entitätsinformationen finden Sie unter Entity-Informationen im EMF-Format.

In den folgenden Abschnitten wird beschrieben, wie Sie das und erstellen, Attributes damit Sie die Ressourcen KeyAttributes und Dienste identifizieren CloudWatch können, die mit der Telemetrie verknüpft sind.

Die KeyAttributes Eigenschaft der Entity-Objekte (in CloudWatch oder in CloudWatch Protokollen) identifiziert die Entität für eindeutig CloudWatch. Der Wert ist eine Auflistung von Schlüssel-Wert-Paaren. Entitätseigenschaften mit denselben KeyAttributes werden als dieselbe Entität betrachtet. Telemetriedaten, die derselben Entität zugeordnet sind, werden als verwandt betrachtet und können leicht im Bereich Verwandte erkunden gefunden werden.

Anmerkung

In der CloudWatch API wird die Eigenschaft aufgerufenKeyAttributes. In der CloudWatch Logs-API wird die Eigenschaft aufgerufenkeyAttributes. Hier wird das als dieselbe Eigenschaft behandelt.

Es gibt fünf mögliche Objekttypen, die Entity darstellen kann.

  • AWS::Resource— Die Entität stellt eine AWS Ressource dar, z. B. eine DynamoDB-Tabelle oder eine EC2 Amazon-Instance.

  • AWS::Service— Die Entität repräsentiert einen AWS Service wie Amazon S3. Das kann beispielsweise verwendet werden, wenn der ListBuckets-Vorgang aufgerufen wird, der keiner bestimmten Amazon-S3-Ressource zugeordnet ist.

  • Service – Die Entität stellt eine Workload dar, die in Ihrem Konto ausgeführt wird. Zum Beispiel eine Anwendung oder einen Service, den Sie verwalten.

  • Ressource — Die Entität stellt eine Ressource dar AWS, die nicht von Betriebssystemressourcen wie Prozessen oder Dateivolumes verwaltet wird.

  • RemoteService— Die Entität stellt einen externen Dienst in einem Fernanruf dar. Zum Beispiel ein Remoteaufruf einer Datenbank, eines externen Caches oder externen Endpunkts.

Je nachdem, welchen der oben genannten Typen Sie darstellen möchten, müssen Sie die richtigen Schlüssel-Wert-Paare für KeyAttributes angeben. Nachfolgend werden die einzelnen Typen beschrieben.

AWS::Resource

Um eine AWS Ressource anzugeben, müssen Sie die folgenden drei Schlüsselwertpaare angeben:

  • "Type": "AWS::Resource"— Dieses Schlüssel-Wert-Paar identifiziert die Entität als AWS Ressource.

  • "ResourceType": "<resource-type>"— Der Zeichenkettenwert von ResourceType ist der CloudFormation Ressourcentyp string. Beispiel, AWS::DynamoDB::Table.

  • "Identifier": "<resource-id>" – Die primäre Kennung für die Ressource. Weitere Informationen finden Sie unter PrimaryIdentifier im Handbuch zur Entwicklung von Erweiterungen für CloudFormation Benutzer.

AWS::Service

Um einen AWS Dienst anzugeben, müssen Sie die folgenden zwei Schlüssel-Wert-Paare angeben:

  • "Type": "AWS::Service"— Dieses Schlüssel-Wert-Paar identifiziert die Entität als AWS Dienst.

  • "Name": "<service-name>" – Der Wert von Name ist die CloudFormation -Servicenamen-Zeichenfolge. Beispiel, AWS::DynamoDB.

Service

Um einen Dienst anzugeben, der nicht von betrieben wird AWS, müssen Sie die folgenden drei Schlüssel-Wert-Paare angeben:

  • "Type": "Service" – Dieses Schlüssel-Wert-Paar identifiziert die Entität als einen Service.

  • "Name": "<service-name>" – Das steht für den Namen des Services, der die Metriken sendet. Zum Beispiel my-service-frontend oder api.myservice.com.

  • "Environment": "<environment-name>" – Dieses Attribut gibt an, wo der Service gehostet wird oder zu welcher Umgebung er gehört. Zum Beispiel us-west-2 oder myservice.production.

Resource

Um eine Ressource anzugeben, die nicht von bereitgestellt wird AWS, müssen Sie die folgenden drei Schlüssel-Wert-Paare angeben:

  • "Type": "Resource" – Dieses Schlüssel-Wert-Paar identifiziert die Entität als eine Ressource.

  • "ResourceType": "<resource-type>" – Eine Zeichenfolge, die den Ressourcentyp angibt. Beispielsweise K8s::Pod für einen Kubernetes-Pod.

  • "Identifier": "<resource-id>" – Eine Zeichenfolgenkennung für die Ressource. Kann mehrere durch Pipes getrennte Namen enthalten. Ein Kubernetes-Pod kann beispielsweise durch seinen Clusternamen, seinen Namespace und seinen Pod-Namen dargestellt werden, z. B. MyCluster|MyNamespace|MyPod.

RemoteService

Um einen Remote-Service anzugeben, müssen Sie die folgenden drei Schlüssel-Wert-Paare angeben:

  • "Type": "RemoteService" – Dieses Schlüssel-Wert-Paar identifiziert die Entität als einen Remote-Service.

  • "Name": "<remote-service-name>" – Gibt an, wie sich die Anwendung bei einem Remote-Aufruf auf den externen Service bezieht. Beispiel, api.test.myservice.com.

Sie können zusätzliche Details zu Entity angeben, die Sie mit Ihrer Telemetrie bereitstellen. Das kann Details über die Plattform, die Ressource, die Anwendung oder den Telemetrieanbieter beinhalten. In den folgenden Tabellen werden die Schlüsselwörter beschrieben, die Sie für jeden dieser Datentypen nutzen können.

Anmerkung

In der CloudWatch API wird die Eigenschaft aufgerufenAttributes. In der CloudWatch Logs-API wird die Eigenschaft aufgerufenattributes. Hier wird das als dieselbe Eigenschaft behandelt.

Plattformdetails

Stichwort Usage Domain der Werte Beispiele

PlatformType

Definiert die Hosting-Plattform.

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

AWS::EC2

EKS.Cluster

Der Name des Amazon EKS-Clusters.

Alphanumerische Zeichenfolge mit grundlegendem Trennzeichen.

FlyingSquad

K8s.Cluster

Name des selbstgehosteten Kubernetes-Clusters.

Alphanumerische Zeichenfolge mit grundlegendem Trennzeichen.

minicube

K8s.Namespace

Name des Kubernetes-Namespace in Amazon-EKS- oder K8s-Clustern.

Alphanumerische Zeichenfolge mit grundlegendem Trennzeichen.

default, pet-clinic

K8s.Workload

Name des Kubernetes-Workloads in Amazon-EKS- und K8s-Clustern.

Alphanumerische Zeichenfolge mit grundlegendem Trennzeichen.

frontend

K8s.Node

Identität des Kubernetes-Knotens in Amazon-EKS- und K8s-Clustern.

K8s-Knotenname (z. B. DNS-Name der EC2 Amazon-Instanz).

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

K8s.Pod

Identität des Kubernetes-Pods in Amazon-EKS- und K8s-Clustern.

K8s-Pod-ID.

frontend-1234abcd56-ef7890

EC2.AutoScalingGroup

Name der EC2 AutoScaling Amazon-Gruppe.

Alphanumerische Zeichenfolge mit grundlegendem Trennzeichen.

my-asg-name-1

EC2.InstanceId

Identität der EC2 Amazon-Instance.

EC2 Amazon-Instanz-ID.

i-1234abcd5678ef90

ECS.Cluster

Identität des Amazon-ECS-Clusters.

Amazon-ECS-Clustername.

MyCluster

ECS.Service

Identität des Amazon-ECS-Services.

Amazon-ECS-Servicename.

MyService

ECS.Task

Identität der Amazon-ECS-Aufgabe.

Amazon-ECS-Aufgaben-ID.

task-123abc

Lambda.Function

Identität der Lambda-Funktion.

Lambda-Funktionsname.

MyFunction

Host

Name des Hosts für alle Plattformtypen.

Subdomain-Format.

ip-111-22-33-44.example.com

Einzelheiten zur Ressource

Stichwort Usage Domain der Werte Beispiele

AWS.Resource.ARN

ARN für die AWS Ressource.

Alphanumerische Zeichenfolge mit grundlegendem Trennzeichen.

arn:aws:dynamodb:us-east-1:123456789012:table/myDynamoDBTable

Einzelheiten zur Bewerbung

Stichwort Usage Domain der Werte Beispiele

AWS.Application

Name der Anwendung in AppRegistry.

Alphanumerische Zeichenfolge mit grundlegendem Trennzeichen.

PetClinicApp

AWS.Application.ARN

ARN der Anwendung in AppRegistry.

Alphanumerische Zeichenfolge mit grundlegendem Trennzeichen.

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

Details zum Telemetrieanbieter

Stichwort Usage Domain der Werte Beispiele

Telemetry.SDK

Der Fingerabdruck der OTEL-SDK-Version für instrumentierte Services.

Alphanumerische Zeichenfolge mit grundlegendem Trennzeichen.

opentelemetry,1.32.0-aws-SNAPSHOT,java,Auto

Telemetry.Agent

Der Fingerabdruck des Agenten, der zum Sammeln und Senden von Telemetriedaten genutzt wird.

Alphanumerische Zeichenfolge mit grundlegendem Trennzeichen.

CWAgent/1.300026.3, ADOTCollector/1.x

Telemetry.Source

Gibt den Anwendungspunkt an, an dem die Telemetriedaten erfasst wurden, oder welche Quelle für die Telemetriedaten verwendet wurde.

ServerSpan, ClientSpan, ProducerSpan, LocalRoot Spanien ConsumerSpan, JMX, OS.

ClientSpan, JMX