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 CloudWatch oder Logs an CloudWatch Logs senden (mit den [PutLogEvents](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutLogEvents.html)Operationen [PutMetricData](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_PutMetricData.html)oder), 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](CloudWatch_Embedded_Metric_Format_Specification.md#entity-information-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.
## Identifizieren der Entität mit dem KeyAttributes Objekt
Die `KeyAttributes` Eigenschaft der Entity-Objekte ([in CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_Entity.html) oder [in CloudWatch Protokollen](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_Entity.html)) 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 aufgerufen`KeyAttributes`. In der CloudWatch Logs-API wird die Eigenschaft aufgerufen`keyAttributes`. 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 Amazon EC2 EC2-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": ""`— Der Zeichenkettenwert von `ResourceType` ist der CloudFormation [Ressourcentyp](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-template-resource-type-ref.html) string. Beispiel, `AWS::DynamoDB::Table`.
+ `"Identifier": ""` – Die primäre Kennung für die Ressource. Weitere Informationen finden Sie unter [PrimaryIdentifier](https://docs.aws.amazon.com/cloudformation-cli/latest/userguide/resource-type-schema.html#schema-properties-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": ""` – Der Wert von `Name` ist die CloudFormation -[Servicenamen](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-template-resource-type-ref.html)-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": ""` – Das steht für den Namen des Services, der die Metriken sendet. Zum Beispiel `my-service-frontend` oder `api.myservice.com`.
+ `"Environment": ""` – 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": ""` – Eine Zeichenfolge, die den Ressourcentyp angibt. Beispielsweise `K8s::Pod` für einen Kubernetes-Pod.
+ `"Identifier": ""` – 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": ""` – Gibt an, wie sich die Anwendung bei einem Remote-Aufruf auf den externen Service bezieht. Beispiel, `api.test.myservice.com`.
------
## Bereitstellung zusätzlicher Details über die Entität mit dem Objekt „Attributes“
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 aufgerufen`Attributes`. In der CloudWatch Logs-API wird die Eigenschaft aufgerufen`attributes`. 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 Amazon-EC2-Instance). | `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 Amazon EC2 AutoScaling EC2-Gruppe. | Alphanumerische Zeichenfolge mit grundlegendem Trennzeichen. | `my-asg-name-1` |
| `EC2.InstanceId` | Identität der Amazon-EC2-Instance. | Amazon-EC2-Instance-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` |