

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.

# Erkunden verwandter Telemetrie
<a name="ExploreRelated"></a>

Computersysteme können eine große Menge an Telemetriedaten generieren, einschließlich Metriken und Protokollen, und komplexe Systeme erst recht. Wenn Sie sich einen bestimmten Telemetriedatensatz ansehen, kann es schwierig sein, andere Telemetriedaten zu finden, die sich auf Ihren ursprünglichen Satz beziehen. Gegebenenfalls kann eine Schulung für Fortgeschrittene zum Erwerb der erforderlichen Fähigkeiten nötig sein, um Probleme zu finden und zu beheben. Da Systeme komplex sind, kann zum Verständnis der Vorgänge das Aufrufen von Metriken und Protokollen von vielen verschiedenen Services und Ressourcen erforderlich sein, was einen Kontextwechsel und die Navigation zwischen den Systemen erfordert.

Die **zugehörige Funktion Amazon CloudWatch Explore** bietet Zugriff auf AWS Ressourcenbeziehungen, zugehörige Kennzahlen und Protokolle auf allen Servicekonsolen und verbessert so die Beobachtbarkeit und Effizienz für Bediener aller Qualifikationsstufen. Bei der Anzeige von Alarmen oder Anomalien in CloudWatch Dashboards oder in AWS Metriken können Benutzer schnell Metriken und Protokolle für verwandte Ressourcen in Ihrem System finden und einsehen.

CloudWatch bietet Einblick in Metriken und Protokolle, die mit bestimmten Ressourcen verknüpft sind, und der Themenbereich „**Erkunden“ erweitert diesen Bereich, indem Sie Ihre Infrastrukturressourcen mit Ihren Workloads und allen zugehörigen** Telemetriedaten korrelieren können. Auf diese Weise haben Sie schnellen Zugang zu den benötigten Informationen zur Behebung von Infrastrukturproblemen. Die Beziehung zwischen Ressourcen und der zugehörigen Telemetrie wird im Bereich **Verwandte erkunden** angezeigt. Der **Themenbereich „Erkunden**“ wird von oder von anderen AWS Konsolen aus aufgerufen und zeigt Ressourcen CloudWatch oder Telemetrie an.

**Anmerkung**  
„**Related erkunden**“ ist derzeit auf Konten beschränkt, die im Rahmen der CloudWatch kontenübergreifenden Beobachtbarkeit als Monitoring-Konten eingerichtet wurden. Sie sollten von den Quellkonten aus, in denen die Ressourcen ursprünglich erstellt und verwaltet wurden, auf **Verwandte erkunden** zugreifen. In Quellkonten können Sie zwischen verbundenen Ressourcen navigieren und verwandte Protokolle und Metriken einsehen.

In den folgenden Themen werden die Einzelheiten beim Untersuchen verwandter Telemetrie behandelt.

**Topics**
+ [Was versteht man unter verwandter Telemetrie?](#what-is-related-telemetry)
+ [Zugriff auf den Bereich „Verwandte erkunden“](#access-related-telemetry)
+ [Navigation in verwandter Telemetrie](#using-related-telemetry)
+ [Verwendung der Topologiekarte](#using-related-telemetry-map)
+ [Auffinden einer bestimmten Ressource](#using-related-telemetry-find)
+ [Berechtigungen und Voraussetzungen, die zum Anzeigen und Erkunden der verwandten Telemetrie erforderlich sind](#related-telemetry-permissions)
+ [Wie CloudWatch findet man verwandte Telemetrie?](how-does-related-telemetry-work.md)
+ [AWS Dienste, die entsprechende Telemetrie unterstützen](services-with-related-telemetry.md)
+ [Wie füge ich verwandte Informationen zur benutzerdefinierten Telemetrie hinzu, die an gesendet wird CloudWatch](adding-your-own-related-telemetry.md)

## Was versteht man unter verwandter Telemetrie?
<a name="what-is-related-telemetry"></a>

Bei verwandter Telemetrie handelt es sich um Metriken und Protokolldaten von Ressourcen, die sich auf die aktuelle Ressource oder den aktuellen Service beziehen. Üblicherweise könnten Sie sich die Metriken und Protokolle ansehen, die sich auf einen einzelnen Load Balancer beziehen, oder die gesamte Telemetrie, die sich auf Amazon EC2 bezieht. Die **zugehörige Explore-Funktion** in Amazon CloudWatch fügt eine interaktive *Topologiekarte* hinzu. Bei der Übersicht handelt es sich um eine ressourcenzentrierte Ansicht, in der Sie Metriken und Protokolle für eine bestimmte Ressource finden, aber auch sehen können, wie diese Ressource mit anderen Ressourcen verbunden ist.

Wenn Sie sich beispielsweise die Telemetrie für einen Load Balancer im Bereich **Verwandte erkunden** ansehen, werden Ihnen in den Übersichten neben den Metriken und Protokollen, die mit diesem Load Balancer verknüpft sind, auch die Zielgruppen für diesen Load Balancer angezeigt. Wenn Sie eine der Zielgruppen auswählen, werden Ihnen dann die Amazon-EC2-Instances angezeigt, die dieser Zielgruppe zugeordnet sind. Bei jedem Schritt in diesem Prozess werden die Telemetriedaten, einschließlich Metriken und Protokollen, für die ausgewählten Ressourcen angezeigt, sodass Sie schnell die gesuchte Telemetrie finden oder die Telemetrie untersuchen und die Ursache eines bestimmten Problems ermitteln können.

## Zugriff auf den Bereich „Verwandte erkunden“
<a name="access-related-telemetry"></a>

In der CloudWatch Konsole gibt es mehrere Möglichkeiten, auf Telemetrie zuzugreifen, die sich auf Ihre aktuelle Ansicht bezieht. Wenn Sie sich beispielsweise ein Diagramm auf einem Dashboard ansehen und Telemetrie im Zusammenhang mit diesem Diagramm oder einem Aspekt des Diagramms aufrufen möchten, können Sie auswählen, dass verwandte Daten direkt von diesem Diagramm aus erkundet werden können. An vielen Stellen in der Konsole können Sie ein Menüelement **Verwandte erkunden** oder ein Kompasssymbol (![\[Compass icon representing navigation or direction in a user interface.\]](http://docs.aws.amazon.com/de_de/AmazonCloudWatch/latest/monitoring/images/compass-icon.png)) auswählen, um den Bereich **Verwandte erkunden** anzuzeigen.

Sie können auf der CloudWatch Konsole (und auf anderen AWS Konsolen) von Einstiegspunkten aus auf das Erkundungserlebnis zugreifen, darunter:
+ **Metriken-Navigation** **— Wenn Sie im linken Menü der CloudWatch Konsole **Metriken und dann Alle Metriken** auswählen, wird auf der Kachel für jeden unterstützten Service oder jede Metrikquelle das Kompasssymbol angezeigt, das die zugehörige Telemetrie in der unteren rechten Ecke anzeigt.**
+ **Metrik-Legende** — Wenn Sie ein Metrikdiagramm (in CloudWatch oder anderen AWS Konsolen) aufrufen und den Mauszeiger über die Legende des Diagramms bewegen, werden Informationen zu den Daten sowie eine Schaltfläche zum Thema **Erkunden angezeigt, über die die zugehörige** Telemetrie aufgerufen wird.
+ **Metrikdatenpunkte** – Wenn Sie sich ein Metrikdiagramm ansehen, werden beim Bewegen des Mauszeigers über einen Datenpunkt im Diagramm Informationen zur Metrik sowie ein Kompasssymbol angezeigt, um die verwandte Telemetrie aufzurufen.
+ **Metriksuche** — Wenn Sie in CloudWatch nach Metriken suchen und den Namen einer gefundenen Metrik auswählen, können Sie im daraufhin angezeigten Menü die Option **Verwandtes erkunden** auswählen, wodurch die zugehörige Telemetrie angezeigt wird.
+ **Konsolen-Symbolleiste** — Auf vielen AWS Konsolenseiten enthält die Konsolensymbolleiste (normalerweise oben rechts in der Konsole) ein CloudWatch Dienstsymbol, über das CloudWatch Tools aufgerufen werden, darunter der Themenbereich **Erkunden**.

Je nachdem, von wo aus Sie auf den Bereich zugreifen, zeigt der Standardkontext des Bereichs, sofern möglich, einen entsprechenden Filter an.

## Navigation in verwandter Telemetrie
<a name="using-related-telemetry"></a>

Wenn Sie einen der Einstiegspunkte zum **Themenbereich „Erkunden**“ auswählen, wird dieser auf der rechten Seite der CloudWatch Konsole angezeigt. In diesem Bereich können Sie Telemetriedaten zu *Entitäten* in Ihrem System ansehen und danach suchen. Eine Entität ist eine Ressource, z. B. eine Amazon-EC2-Instance, oder ein Service, z. B. eine Anwendung, die Sie erstellt haben. Sie können in diesem Bereich arbeiten, ohne den aktuellen Workflow zu unterbrechen, da er neben der ersten Seite geöffnet wird.

Die folgende Abbildung zeigt den Bereich **Verwandte erkunden**, der sich auf eine einzelne Amazon-EC2-Instance und die zugehörigen Entitäten konzentriert.

![\[Der Bereich „Verwandte erkunden“, mit dem Fokus auf eine einzelne Amazon-EC2-Instance und die zugehörigen Entitäten.\]](http://docs.aws.amazon.com/de_de/AmazonCloudWatch/latest/monitoring/images/compass-explore-main.png)


Am oberen Rand des Bereichs **Verwandte erkunden** befindet sich eine visuelle *Topologieübersicht* (Karte) der aktuellen Entität und anderer verwandter Entitäten. Die derzeit ausgewählte Entität legt den Fokus für den Bereich fest. Es gibt zwei Möglichkeiten für eine Entitätsauswahl.
+ [Topologieübersicht](#using-related-telemetry-map) – Die *Karte* ist eine visuelle Darstellung der aktuellen Entität mit Fokus. Sie zeigt auch alle zugehörigen Entitäten an, sodass Sie sich in der Gruppe der Ressourcen und Services zurechtfinden können, die miteinander in Beziehung stehen.
+ [Weitere Ressourcen suchen](#using-related-telemetry-find) – Sie können mithilfe der Schaltfläche **Weitere Ressourcen suchen** nach Entitäten filtern und suchen, auf die Sie den Fokus legen möchten.

Im unteren Teil des Bereichs wird eine automatisierte Suche nach Metriken und Protokollen für die aktuell fokussierte Entität dargestellt.

Standardmäßig ist der Fokus auf eine Entität gesetzt, die der Position entspricht, von der aus Sie auf den Bereich **Verwandte erkunden** zugegriffen haben. Wenn Sie beispielsweise darauf zugegriffen haben, indem Sie auf das Kompasssymbol geklickt haben, das einer Metrik aus einer bestimmten Amazon-EC2-Instance zugeordnet ist, dann wird der Fokus auf diese Amazon-EC2-Instance gesetzt.

Wenn Sie im **Themenbereich „Erkunden**“ eine AWS Ressource für den Fokus auswählen, können Sie zur ressourcenspezifischen Konsole für die ausgewählte Ressource navigieren. Wenn Sie beispielsweise eine Amazon-EC2-Instance ausgewählt haben, können Sie den Link **In EC2-Konsole anzeigen** auswählen, um die Amazon-EC2-Konsole mit dieser ausgewählten Instance zu öffnen.

Wenn Sie einen Fokus festlegen, werden die Metriken und Protokolle automatisch gefiltert, sodass die Telemetrie dargestellt wird, die sich auf Ihren Fokus bezieht.
+ **Metriken** – Jede Metrik wird als Diagramm für den von Ihnen ausgewählten Zeitraum angezeigt.

  Wie bei jedem anderen Dashboard-Diagramm in können Sie den Mauszeiger über ein Diagramm bewegen oder es auswählen CloudWatch, um weitere Informationen über das Metrikdiagramm zu erhalten und Optionen wie die Anzeige in Metriken anzuzeigen. CloudWatch Wenn Sie sich für die Anzeige in entscheiden, CloudWatch wird die Metrikansicht mit demselben Anzeigekontext wie der **Themenbereich Erkunden** geöffnet, einschließlich Ressourcen und Zeitbereich.
+ **Protokollmuster** — CloudWatch analysiert die Protokollgruppen, die der zentralen Ressource zugeordnet sind, und zeigt allgemeine Muster in diesen Protokollen auf. Weitere Informationen zu Protokollmustern finden Sie unter [Musteranalyse](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/CWL_AnalyzeLogData_Patterns.html) im *Amazon CloudWatch Logs-Benutzerhandbuch*.

  Sie können **Zeitbereich vergleichen** auswählen, um einen anderen Zeitraum auszuwählen und die Protokolle der beiden Zeitbereiche zu vergleichen.

  Sie können **In Logs Insights anzeigen** auswählen, um die CloudWatch Protokolle in Logs Insights mit den gleichen Optionen wie in Ihrer aktuellen Ansicht zu analysieren, einschließlich Ressource, Protokollgruppe und Zeitraum. Weitere Informationen finden Sie unter [Analysieren von Protokolldaten mit CloudWatch Logs Insights](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AnalyzingLogData.html) im *Amazon CloudWatch Logs-Benutzerhandbuch*.
+ **Protokollgruppen** – Die [Protokollgruppen](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/Working-with-log-groups-and-streams.html), welche die Protokolle enthalten, werden angezeigt.

  Sie können die Protokollgruppen wählen und dann eine der folgenden Aktionen ausführen:
  + Wählen Sie **Überwachen in Live Tail starten** aus, um eine Streamingliste mit neuen Protokollereignissen anzusehen, sobald sie für die ausgewählten Protokollgruppen erfasst werden. Die Live-Tail-Sitzung wird in der CloudWatch Konsole gestartet. Weitere Informationen zu Live Tail finden Sie unter [Problembehandlung mit CloudWatch Protokollen LiveTail](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/CloudWatchLogs_LiveTail.html) im *Amazon CloudWatch Logs-Benutzerhandbuch*.
  + Wählen Sie **Abfrage in Logs Insights**, um Logs Insights mit einer Abfrage zu öffnen, die nur auf diese Protokollgruppen beschränkt ist und den aktuellen Kontext, einschließlich Ressourcen und Zeitbereich, berücksichtigt.

## Verwendung der Topologiekarte
<a name="using-related-telemetry-map"></a>

Die *Topologieübersicht* (Karte) ist eine visuelle Darstellung der aktuell fokussierten Entität und der zugehörigen Ressourcen oder Services. Sie können diese interaktive Visualisierung nutzen, um die Verbindungen zwischen verschiedenen Ressourcen und Services zu erkennen und die Beziehungen zwischen Komponenten in Ihrem System zu untersuchen. Wenn Sie sich beispielsweise eine *Load-Balancer*-Ressource ansehen, zeigt die Übersicht verbundene *Zielgruppenressourcen*. Wenn Sie eine Zielgruppe auswählen, werden die zugehörigen Instances angezeigt. Die Visualisierung der Konnektivität hilft den Betreibern, die Beziehungen zwischen verschiedenen Ressourcen und Services in Ihrem System zu verstehen und zu untersuchen.

Sie können die Karte ziehen und die Ansicht vergrößern oder verkleinern, um mehr von den zugehörigen Entitäten zu sehen oder sich auf weniger Entitäten zu konzentrieren.

Wenn Sie eine verknüpfte Entität auswählen, z. B. eine Zielgruppe, verschiebt sich der Fokus des Bereichs und zeigt die Telemetrie für diese Entität an. Die Übersicht wird aktualisiert, sodass sie sich auf die ausgewählte Zielgruppe konzentriert und ihre Verbindungen zu anderen Entitäten wie dem Load Balancer und allen Amazon-EC2-Instances, die in dieser Zielgruppe angegeben sind, anzeigt. Während Sie durch die verschiedenen Entitäten in der Übersicht navigieren, werden die Metriken und Protokolle am unteren Rand des Bereichs dynamisch aktualisiert, sodass Sie die relevanten Telemetriedaten für die neu ausgewählten Ressourcen erhalten.

## Auffinden einer bestimmten Ressource
<a name="using-related-telemetry-find"></a>

Wenn eine Ressource nicht auf der Topologiekarte angezeigt wird, können Sie zum Auffinden die Funktion **Andere Ressourcen suchen** verwenden. Sie können Ressourcen nach Tag oder Typ filtern und dann die Ressourcen auswählen, nach denen Sie suchen. Nachdem Sie Ressourcen gefunden haben, auf die Sie sich konzentrieren können, kehren Sie zur Topologiekarte zurück, in diese Ressourcen ausgewählt wurden, um die zugehörigen Entitäten und die Telemetrie zu durchsuchen.

**Anmerkung**  
Es gibt viele Gründe, weshalb Ihre Ressourcen ggf. nicht auf der Topologiekarte angezeigt werden. Beispiel:  
Das hat nichts mit der aktuell fokussierten Entität zu tun.
Sie haben keine [Berechtigung](#related-telemetry-permissions), auf zugehörige Entitäten oder Telemetrie zuzugreifen.
Die [Ressource oder der Service](services-with-related-telemetry.md) unterstützt möglicherweise keine Telemetrie oder zugehörige Entitäten.

Mithilfe der Option **Andere Ressourcen suchen** können Sie Ressourcen finden und visualisieren, die ggf. nicht direkt miteinander verbunden sind oder in der aktuellen Übersicht nicht sichtbar sind. Das sorgt dafür, dass Sie auf alle relevanten Komponenten Ihrer Infrastruktur zugreifen und diese analysieren können.

**Wählen Sie mit „Ressourcen suchen“ eine Ressource aus.**

1. Öffnen **Sie den Themenbereich „Erkunden**“ von einem beliebigen [Einstiegspunkt](#access-related-telemetry) in der CloudWatch Konsole aus.

1. Wählen Sie anschließend **Ressourcen suchen** aus.

1. Wählen Sie den Zeitrahmen aus, für den Sie Protokolle oder Metriken ansehen möchten.

1. Wählen Sie **Ressourcentypen** und anschließend aus der Drop-down-Liste den Ressourcentyp aus, auf den Sie sich konzentrieren möchten, z. B. **EC2-Instances**.

1. Filtern Sie optional nach der Ressourcengruppe, indem Sie ein Tag angeben, nach dem gefiltert werden soll. Sie können dazu den Filter **Ressourcen nach Tags filtern** oder die Bezeichnung auswählen, die besagt, dass **5 Tags gefunden** wurden (die Anzahl hängt von den Tags im System ab). Dadurch erhalten Sie eine Liste von Tags, aus der Sie auswählen können.

   Nach der Tag-Auswahl wird die Liste der Ressourcen automatisch auf diejenigen gefiltert, die diesen Tags zugeordnet sind.

1. Wählen Sie optional eine oder mehrere spezifische Ressourcen aus den gefundenen Ressourcen aus, die den Filtern entsprechen.

1. Wählen Sie **Auf Übersicht anzeigen** aus, um mit den ausgewählten Ressourcen zur **Topologieübersicht** zurückzukehren.

Ihre Liste mit **Metriken** und **Protokollen** wird jetzt nur nach Protokollen und Metriken gefiltert, die diesem Ressourcentyp zugeordnet sind. Sie können die Registerkarte **Metriken** oder **Protokolle** auswählen, um die Art der Telemetrie aufzurufen, die Sie ansehen möchten.

## Berechtigungen und Voraussetzungen, die zum Anzeigen und Erkunden der verwandten Telemetrie erforderlich sind
<a name="related-telemetry-permissions"></a>

Um verwandte Telemetrie erkunden zu können, müssen Sie Entity-Informationen mit der Telemetrie aus Ihren Workloads abrufen, und Sie müssen über die entsprechenden Berechtigungen zum Aufrufen dieser Daten verfügen.

Viele Services senden Entitätsinformationen automatisch. Für Workloads, die den CloudWatch Agenten verwenden, benötigen Sie mindestens eine Version `1.300049.1` des Agenten, und Sie müssen ihn korrekt konfigurieren. Informationen zur Konfiguration des Agenten finden Sie unter [Wie füge ich verwandte Informationen zur benutzerdefinierten Telemetrie hinzu, die an gesendet wird CloudWatch](adding-your-own-related-telemetry.md). Für Workloads, die auf Amazon EKS ausgeführt werden, benötigen Sie mindestens eine Version `v2.3.1-eksbuild.1` des Amazon CloudWatch Observability EKS-Add-ons. Weitere Informationen zu diesem Add-On finden Sie unter [Schneller Start mit dem Amazon CloudWatch Observability EKS-Add-on](Container-Insights-setup-EKS-addon.md).

Um die verwandte Telemetrie zu untersuchen, müssen Sie mit bestimmten Berechtigungen angemeldet sein. Die Untersuchung verwandter Telemetriedaten ist nur lesbar und erfordert mindestens schreibgeschützten Zugriff auf. CloudWatch

Für das Anzeigen von Verknüpfungen zwischen Telemetrie und Entitäten sind folgende Berechtigungen erforderlich: `logs:ListLogGroupsForEntity`, `logs:ListEntitiesForLogGroup`, `cloudwatch:ListEntitiesForMetric` und `application-signals:ListObservedEntities`.

Jede der folgenden AWS verwalteten Richtlinien stellt die CloudWatch Berechtigungen bereit, die für den Zugriff auf die zugehörige Telemetrie in der Konsole erforderlich sind: CloudWatch 
+ [CloudWatchFullAccessV2](https://docs.aws.amazon.com/aws-managed-policy/latest/reference/CloudWatchFullAccessV2.html) — Bietet vollen Zugriff auf CloudWatch.
+ [CloudWatchReadOnlyAccess](https://docs.aws.amazon.com/aws-managed-policy/latest/reference/CloudWatchReadOnlyAccess.html)— Bietet schreibgeschützten Zugriff auf. CloudWatch
+ [ReadOnlyAccess](https://docs.aws.amazon.com/aws-managed-policy/latest/reference/ReadOnlyAccess.html)— Bietet schreibgeschützten Zugriff auf Dienste und Ressourcen. AWS 

Darüber hinaus benötigen Sie mindestens schreibgeschützten Zugriff (`Describe*`und`Get*`) auf alle Ressourcen in der Topologiekarte, um Beziehungen erkennen und anzeigen CloudWatch zu können.

Weitere Informationen über die Verwendung von Richtlinien zur Zugriffskontrolle finden Sie unter [Verwalten des Zugriffs mit Richtlinien](auth-and-access-control-cw.md#security_iam_access-manage).

# Wie CloudWatch findet man verwandte Telemetrie?
<a name="how-does-related-telemetry-work"></a>

Im CloudWatch **Themenbereich „Erkunden**“ werden Ihnen Metriken und Protokolle angezeigt, die miteinander in Beziehung stehen, aber wie funktioniert das?

Metriken und Protokolle, an die gesendet werden, CloudWatch können eine optionale *Entität* enthalten, mit der sie verknüpft sind. Üblicherweise stellt die Entität dar, worum es bei der Telemetrie geht. Eine Metrik zur CPU-Auslastung bezieht sich beispielsweise auf eine Amazon-EC2-Instance und nutzt diese Instance als ihre Entität. Wenn Sie sich diese Metrik im Bereich **Verwandte erkunden** ansehen, werden Ihnen weitere Telemetriedaten für dieselbe Instance angezeigt.

In der *Topologieübersicht* (Karte) im Bereich **Verwandte erkunden** wird die aktuell ausgewählte Ressource zusammen mit den *verwandten Ressourcen* angezeigt. Zeigt bei AWS Ressourcen CloudWatch automatisch andere Ressourcen an, von denen es weiß, dass sie miteinander verknüpft sind. Wenn Sie sich beispielsweise eine Amazon-EC2-Instance ansehen, zeigt die Übersicht auch alle Amazon-EBS-Volumes an, die der Instance zugeordnet sind. Wenn Sie ein Volume auswählen, wird die Telemetrie für das Volume angezeigt, und die Übersicht wird aktualisiert, sodass Ressourcen angezeigt werden, die sich auf das Volume beziehen. Außerdem werden Ressourcen angezeigt, die Teil desselben *Service* sind.

Die mit Ihrer Telemetrie verknüpften Entitätsinformationen definieren die Ressource, mit der die Telemetrie verknüpft ist, z. B. die Amazon-EC2-Instance. Sie können aber auch Kontextdaten über die Ressource enthalten. Wenn Sie beispielsweise über eine Website-Anwendung verfügen, die Ressourcen wie eine Amazon-EC2-Instance und eine Datenbank umfasst, können die Entitätsinformationen die Website-Anwendung als Service enthalten. In diesem Fall zeigt die Topologieübersicht den Service als verwandte Entität, und wenn Sie ihn auswählen, werden die Instances und die Datenbank dargestellt. Das kann das Auffinden der gesamten Telemetriedaten für einen Service vereinfachen.

**Anmerkung**  
CloudWatch muss innerhalb der letzten drei Stunden Telemetrie mit Entitätsinformationen empfangen haben, um verwandte Ressourcen und Telemetrie zu finden.

## Was ist der Ursprung der Entitätsdaten?
<a name="how-does-related-telemetry-work-entity"></a>

Es gibt verschiedene Möglichkeiten, Entitäten für die CloudWatch Telemetrie abzurufen:
+ Die meisten Telemetriedaten, an die CloudWatch von AWS Diensten gesendet werden, werden automatisch Ressourcen zugeordnet. Eine vollständige Liste der unterstützten Ressourcen finden Sie unter [AWS Dienste, die entsprechende Telemetrie unterstützen](services-with-related-telemetry.md).
+ Der CloudWatch Agent fügt der Telemetrie, an die er sendet, automatisch Entitätsinformationen hinzu. CloudWatch
**Anmerkung**  
Möglicherweise müssen Sie Ihren CloudWatch Agenten auf die neueste Version aktualisieren, um Entitätsdaten aufzunehmen. Weitere Informationen finden Sie unter [Erfassen Sie Metriken, Logs und Traces mithilfe des CloudWatch Agenten](Install-CloudWatch-Agent.md) und [Konfigurieren Sie CloudWatch Agentendienst- und Umgebungsnamen für verwandte Entitäten](CloudWatch-Agent-configure-related-telemetry.md).
+ Wenn Sie Ihre eigenen Telemetriedaten übermitteln, können Sie die Daten um Entitätsinformationen ergänzen. Weitere Informationen finden Sie unter [Wie füge ich verwandte Informationen zur benutzerdefinierten Telemetrie hinzu, die an gesendet wird CloudWatch](adding-your-own-related-telemetry.md).
+ CloudWatch bemüht sich nach besten Kräften, die mit anderen Telemetriedaten verknüpften Entitätsinformationen zu erkennen (z. B. benutzerdefinierte Telemetriedaten, an die Sie CloudWatch ohne Entitätsinformationen senden).

## Woher stammen die Servicedaten?
<a name="how-does-related-telemetry-work-service"></a>

*Neben der Erkennung der natürlichen Verbindungen zwischen Ressourcen, z. B. einer Instanzressource und einer angehängten Volumenressource, CloudWatch können Ressourcen auch nach Diensten gruppiert werden.* Bei einem Service kann es sich beispielsweise um eine Website-Anwendung handeln. Eine Amazon-EC2-Instance mit einem Webserver und eine andere mit einer Datenbank können beide Teil desselben Services sein und sind auf der Topologieübersicht verbunden, die auf diesem Service basiert.

Es gibt verschiedene Möglichkeiten, einen CloudWatch Dienstnamen für Telemetrie zu erhalten, darunter:
+ Anwendungssignale oder Otel-instrumentierte Telemetrie verwenden die `OTEL_SERVICE_NAME` Umgebungsvariable, die von unterstützten OpenTelemetry Instrumentierungsbibliotheken verwendet wird, um den Dienstnamen festzulegen.
+ Die CloudWatch Agentenkonfiguration ermöglicht die Konfiguration eines Dienstnamens. Weitere Informationen finden Sie unter [Konfigurieren Sie CloudWatch Agentendienst- und Umgebungsnamen für verwandte Entitäten](CloudWatch-Agent-configure-related-telemetry.md).
+ Kubernetes-Workloads verwenden einen entsprechenden Namen aus dem Cluster, z. B. Deployment ReplicaSet, Pod oder Container, für den Dienstnamen.
+ Bei Amazon-EC2-Workloads kann der Service aus Tags (den Tags `service`, `application` oder `app`) stammen.
**Anmerkung**  
Um Tags zur Generierung von Servicenamen zu verwenden, müssen Sie zunächst [Instance-Metadaten für die Amazon-EC2-Instance einrichten](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/work-with-tags-in-IMDS.html#allow-access-to-tags-in-IMDS).
+ Wenn Sie Ihre eigenen Telemetriedaten übermitteln, können Sie die Daten um Serviceinformationen ergänzen. Weitere Informationen finden Sie unter [Wie füge ich verwandte Informationen zur benutzerdefinierten Telemetrie hinzu, die an gesendet wird CloudWatch](adding-your-own-related-telemetry.md).
+ Wenn die oben genannten Angaben nicht CloudWatch verwendet werden können, wird der Name der IAM-Rolle, die die Metriken sendet, als Dienstnamen verwendet. Dies kann beispielsweise einen Servicenamen für Amazon-ECS-Telemetrie bereitstellen.

# AWS Dienste, die entsprechende Telemetrie unterstützen
<a name="services-with-related-telemetry"></a>

In der folgenden Tabelle sind die AWS Dienste aufgeführt, die zugehörige Entitätsinformationen in ihrer CloudWatch Telemetrie unterstützen. Für Dienste oder Ressourcen, die nicht in der Tabelle aufgeführt sind, sind keine zugehörigen Entitätsinformationen verfügbar. CloudWatch

**Anmerkung**  
Bei Diensten, die den [CloudWatch Agenten](Install-CloudWatch-Agent.md) verwenden, müssen Sie den Agenten möglicherweise auf die neueste Version aktualisieren, um die zugehörige Telemetrie zu erhalten. Informationen zum Senden verwandter Entitätsinformationen mit Ihren eigenen benutzerdefinierten Metriken finden Sie unter [Wie füge ich verwandte Informationen zur benutzerdefinierten Telemetrie hinzu, die an gesendet wird CloudWatch](adding-your-own-related-telemetry.md).


| AWS Dienst | Ressource | Kennzahlen | Protokolle | 
| --- | --- | --- | --- | 
|  Amazon API Gateway  |  `AWS::ApiGateway::Method`  |  Ja  |  Nein  | 
|  Amazon API Gateway  |  `AWS::ApiGateway::Resource`  |  Ja  |  Nein  | 
|  Amazon API Gateway  |  `AWS::ApiGateway::RestApi`  |  Ja  |  Nein  | 
|  Amazon API Gateway  |  `AWS::ApiGateway::Stage`  |  Ja  |  Ja  | 
|  Amazon API Gateway  |  `AWS::ApiGateway::VpcLink`  |  Ja  |  Nein  | 
|  Amazon API Gateway V2  |  `AWS::ApiGatewayV2::Integration`  |  Ja  |  Nein  | 
|  Amazon API Gateway V2  |  `AWS::ApiGatewayV2::Route`  |  Ja  |  Nein  | 
|  Amazon API Gateway V2  |  `AWS::ApiGatewayV2::Stage`  |  Nein  |  Ja  | 
|  Amazon API Gateway V2  |  `AWS::ApiGatewayV2::Api`  |  Ja  |  Nein  | 
|  AWS App Runner  |  `AWS::AppRunner::Service`  |  Nein  |  Ja  | 
|  AWS Application Migration Service  |  `AWS::MGN::SourceServer`  |  Ja  |  Nein  | 
|   WorkSpaces Amazon-Anwendungen  |  `AWS::AppStream::Fleet`  |  Ja  |  Ja  | 
|  AWS AppSync  |  `AWS::AppSync::GraphQLApi`  |  Ja  |  Ja  | 
|  AWS B2B-Datenaustausch  |  `AWS::B2BI::Transformer`  |  Nein  |  Ja  | 
|  AWS Backup gateway  |  `AWS::BackupGateway::Hypervisor`  |  Nein  |  Ja  | 
|  Amazon Bedrock  |  `AWS::Bedrock::KnowledgeBase`  |  Nein  |  Ja  | 
|  Amazon Bedrock  |  `AWS::Bedrock::ModelId`  |  Ja  |  Nein  | 
|  Amazon Chime  |  `AWS::Chime::SipMediaApplication`  |  Nein  |  Ja  | 
|  Amazon Chime  |  `AWS::Chime::VoiceConnector`  |  Nein  |  Ja  | 
|  AWS Clean Rooms  |  `AWS::CleanRooms::Membership`  |  Nein  |  Ja  | 
|  AWS CloudFormation  |  |  Nein  |  Ja  | 
|  AWS CloudFormation Haken  |  |  Nein  |  Ja  | 
|  Amazon CloudFront  |  `AWS::CloudFront::Distribution`  |  Ja  |  Ja  | 
|  AWS CloudTrail  |  `AWS::CloudTrail::EventDataStore`  |  Nein  |  Ja  | 
|  AWS CloudTrail  |  `AWS::CloudTrail::Trail`  |  Nein  |  Ja  | 
|  Amazon CloudWatch  |  `AWS::CloudWatch::MetricStream`  |  Ja  |  Nein  | 
|   CloudWatch Amazon-Protokolle  |  `AWS::Logs::LogGroup`  |  Ja  |  Nein  | 
|  Amazon CloudWatch RUM  |  `AWS::RUM::AppMonitor`  |  Nein  |  Ja  | 
|  Amazon CloudWatch Synthetics  |  `AWS::Synthetics::Canary`  |  Ja  |  Nein  | 
|  AWS CodeBuild  |  `AWS::CodeBuild::Project`  |  Ja  |  Nein  | 
|  Amazon CodeWhisperer  |  `AWS::CodeWhisperer::Customization`  |  Nein  |  Ja  | 
|  Amazon-Cognito-Benutzerpools  |  `AWS::Cognito::UserPool`  |  Ja  |  Ja  | 
|  AWS Config  |  `AWS::Config::ConfigRule`  |  Nein  |  Ja  | 
|  Amazon Connect  |  `AWS::Connect::Instance`  |  Nein  |  Ja  | 
|  AWS Database Migration Service  |  `AWS::DMS::ReplicationInstance`  |  Ja  |  Nein  | 
|  AWS Database Migration Service  |  `AWS::DMS::ReplicationTask`  |  Ja  |  Nein  | 
|  AWS DataSync  |  `AWS::Datasync::Agent`  |  Ja  |  Nein  | 
|  AWS DataSync  |  `AWS::DataSync::Task`  |  Ja  |  Ja  | 
|  AWS Directory Service  |  `AWS::DirectoryService::MicrosoftAD`  |  Nein  |  Ja  | 
|  Amazon DynamoDB  |  `AWS::DynamoDB::Table`  |  Ja  |  Nein  | 
|  DynamoDB Accelerator  |  `AWS::DAX::Cluster`  |  Ja  |  Nein  | 
|  Amazon EC2  |  `AWS::EC2::CapacityReservation`  |  Ja  |  Nein  | 
|  Amazon EC2  |  `AWS::EC2::Instance`  |  Ja  |  Nein  | 
|  Amazon EC2  |  `AWS::EC2::FlowLog`  |  Ja  |  Nein  | 
|  Amazon EC2  |  `AWS::EC2::NATGateway`  |  Ja  |  Nein  | 
|  Amazon EC2  |  `AWS::EC2::NetworkInterface`  |  Ja  |  Ja  | 
|  Amazon EC2  |  `AWS::EC2::Subnet`  |  Ja  |  Ja  | 
|  Amazon EC2  |  `AWS::EC2::TransitGateway`  |  Ja  |  Nein  | 
|  Amazon EC2  |  `AWS::EC2::TransitGatewayAttachment`  |  Ja  |  Ja  | 
|  Amazon EC2  |  `AWS::EC2::VerifiedAccessInstance`  |  Nein  |  Ja  | 
|  Amazon EC2  |  `AWS::EC2::Volume`  |  Ja  |  Nein  | 
|  Amazon EC2  |  `AWS::EC2::VPC`  |  Nein  |  Ja  | 
|  Amazon EC2  |  `AWS::EC2::VPNConnection`  |  Ja  |  Ja  | 
|  Amazon EC2 Auto Scaling  |  `AWS::AutoScaling::AutoScalingGroup`  |  Ja  |  Nein  | 
|  AWS Elastic Beanstalk  |  `AWS::ElasticBeanstalk::Environment`  |  Ja  |  Nein  | 
|  Amazon Elastic Container Service  |  `AWS::ECS::Cluster`  |  Ja  |  Ja  | 
|  Amazon Elastic Container Service  |  `AWS::ECS::Service`  |  Ja  |  Ja  | 
|  Amazon Elastic File System  |  `AWS::EFS::AccessPoint`  |  Ja  |  Nein  | 
|  Amazon Elastic File System  |  `AWS::EFS::FileSystem`  |  Ja  |  Nein  | 
|  Amazon Elastic File System  |  `AWS::EFS::MountTarget`  |  Ja  |  Nein  | 
|  Amazon Elastic Kubernetes Service  |  `AWS::EKS::Cluster`  |  Ja  |  Ja  | 
|  Amazon Elastic Kubernetes Service auf AWS Fargate  |  |  Nein  |  Ja  | 
|  Elastic Load Balancing  |  `AWS::ElasticLoadBalancing::LoadBalancer`  |  Ja  |  Nein  | 
|  Elastic Load Balancing V2  |  `AWS::ElasticLoadBalancingV2::LoadBalancer`  |  Ja  |  Nein  | 
|  Elastic Load Balancing V2  |  `AWS::ElasticLoadBalancingV2::TargetGroup`  |  Ja  |  Nein  | 
|  Amazon ElastiCache  |  `AWS::ElastiCache::CacheCluster`  |  Ja  |  Ja  | 
|  AWS Elemental MediaConvert  |  `AWS::MediaConvert::Queue`  |  Ja  |  Nein  | 
|  AWS Elemental MediaLive  |  |  Nein  |  Ja  | 
|  AWS Elemental MediaLive  |  `AWS::MediaLive::Channel`  |  Ja  |  Nein  | 
|  AWS Elemental MediaPackage  |  `AWS::MediaPackage::Channel`  |  Ja  |  Nein  | 
|  AWS Elemental MediaStore  |  `AWS::MediaStore::Container`  |  Ja  |  Ja  | 
|  AWS Elemental MediaTailor  |  |  Nein  |  Ja  | 
|  Amazon EMR  |  `AWS::EMR::Cluster`  |  Ja  |  Ja  | 
|  Amazon EventBridge  |  `AWS::Events::Rule`  |  Ja  |  Ja  | 
|   EventBridge Amazon-Pfeifen  |  `AWS::Pipes::Pipe`  |  Ja  |  Ja  | 
|  AWS Fault Injection Service  |  `AWS::FIS::ExperimentTemplate`  |  Nein  |  Ja  | 
|  Amazon FinSpace  |  `AWS::FinSpace::Environment`  |  Nein  |  Ja  | 
|  Amazon FSx  |  `AWS::FSx::FileSystem`  |  Ja  |  Nein  | 
|   GameLift Amazon-Server  |  `AWS::GameLift::Fleet`  |  Ja  |  Nein  | 
|  AWS Glue  |  `AWS::Glue::Job`  |  Nein  |  Ja  | 
|  AWS Identity-Synchronisierung  |  `AWS::IdentitySync::Profile`  |  Nein  |  Ja  | 
|  Amazon Interactive Video Service  |  `AWS::IVSChat::LoggingConfiguration`  |  Ja  |  Ja  | 
|  AWS IoT  |  `AWS::IoT::TopicRule`  |  Ja  |  Ja  | 
|  AWS IoT 1-Click  |  `AWS::IoT1Click::Device`  |  Ja  |  Nein  | 
|  AWS IoT Events  |  |  Nein  |  Ja  | 
|  AWS IoT FleetWise  |  `AWS::IoTFleetWise::Vehicle`  |  Nein  |  Ja  | 
|  AWS IoT SiteWise  |  |  Nein  |  Ja  | 
|  AWS Key Management Service  |  `AWS::KMS::Key`  |  Ja  |  Nein  | 
|  Amazon Managed Service für Apache Flink  |  `AWS::KinesisAnalytics::Application`  |  Ja  |  Ja  | 
|  Amazon Data Firehose  |  `AWS::KinesisFirehose::DeliveryStream`  |  Ja  |  Ja  | 
|  Amazon Kinesis Data Streams  |  `AWS::Kinesis::Stream`  |  Ja  |  Nein  | 
|  Amazon Kinesis Video Streams  |  `AWS::KinesisVideo::Stream`  |  Ja  |  Nein  | 
|  AWS Lambda  |  `AWS::Lambda::Function`  |  Ja  |  Nein  | 
|  Amazon Lex  |  |  Nein  |  Ja  | 
|  AWS Mainframe Modernization  |  `AWS::M2::Application`  |  Nein  |  Ja  | 
|  Amazon Managed Streaming für Apache Kafka  |  `AWS::Kafka::Cluster`  |  Ja  |  Nein  | 
|  Amazon Managed Streaming für Apache Kafka  |  `AWS::KafkaConnect::Connector`  |  Nein  |  Ja  | 
|  Amazon Managed Streaming für Apache Kafka  |  `AWS::MSK::Cluster`  |  Ja  |  Ja  | 
|  Amazon MemoryDB  |  `AWS::Mmemorydb::Cluster`  |  Ja  |  Nein  | 
|  Amazon MQ  |  `AWS::AmazonMQ::Broker`  |  Ja  |  Ja  | 
|  AWS Network Firewall  |  `AWS::NetworkFirewall::Firewall`  |  Ja  |  Ja  | 
|   OpenSearch Amazon-Dienst  |  `AWS::OpenSearchService::Domain`  |  Ja  |  Nein  | 
|   OpenSearch Amazon-Dienst  |  |  Nein  |  Ja  | 
|  Amazon OpenSearch Service Investion  |  `AWS::OSIS::Pipeline`  |  Nein  |  Ja  | 
|  AWS Organizations  |  `AWS::Organizations::Organization`  |  Nein  |  Ja  | 
|  AWS Outposts  |  `AWS::Outposts::Outpost`  |  Ja  |  Nein  | 
|  Amazon Managed Service für Prometheus  |  `AWS::Prometheus::Resource`  |  Ja  |  Nein  | 
|  Amazon Q Business  |  |  Nein  |  Ja  | 
|  Amazon QLDB  |  `AWS::QLDB::Ledger`  |  Ja  |  Nein  | 
|  Amazon Quick  |  `AWS::Quicksight::Dashboard`  |  Ja  |  Nein  | 
|  Amazon Quick  |  `AWS::Quicksight::DataSet`  |  Ja  |  Nein  | 
|  Amazon Redshift  |  `AWS::Redshift::Cluster`  |  Ja  |  Ja  | 
|  Amazon Redshift Serverless  |  `AWS::RedshiftServerless::Workgroup`  |  Ja  |  Nein  | 
|  Amazon Relational Database Service  |  `AWS::RDS::DBCluster`  |  Ja  |  Ja  | 
|  Amazon Relational Database Service  |  `AWS::RDS::DBInstance`  |  Ja  |  Ja  | 
|  Amazon Route 53  |  `AWS::Route53::HealthCheck`  |  Ja  |  Ja  | 
|  Amazon Route 53  |  `AWS::Route53::HostedZone`  |  Ja  |  Nein  | 
|  Amazon Route 53 Resolver  |  `AWS::Route53Resolver::ResolverEndpoint`  |  Ja  |  Nein  | 
|  Amazon S3  |  `AWS::S3::Bucket`  |  Ja  |  Nein  | 
|  Amazon SageMaker KI  |  `AWS::SageMaker::Endpoint`  |  Ja  |  Nein  | 
|  Amazon SageMaker KI  |  `AWS::SageMaker::Workteam`  |  Nein  |  Ja  | 
|  AWS Service Catalog  |  `AWS::ServiceCatalog::CloudFormationProduct`  |  Ja  |  Nein  | 
|  Amazon Simple Email Service  |  `AWS::SES::ConfigurationSet`  |  Ja  |  Nein  | 
|  Amazon Simple Notification Service  |  `AWS::SNS::Topic`  |  Ja  |  Ja  | 
|  Amazon Simple Notification Service  |  |  Nein  |  Ja  | 
|  Amazon Simple Queue Service  |  `AWS::SQS::Queue`  |  Ja  |  Nein  | 
|  AWS Step Functions  |  `AWS::StepFunctions::Activity`  |  Ja  |  Nein  | 
|  AWS Step Functions  |  `AWS::StepFunctions::StateMachine`  |  Ja  |  Ja  | 
|  AWS Storage Gateway  |  `AWS::StorageGateway::Gateway`  |  Ja  |  Nein  | 
|  AWS Storage Gateway  |  `AWS::StorageGateway::Share`  |  Nein  |  Ja  | 
|  AWS Transfer Family  |  `AWS::Transfer::Server`  |  Ja  |  Ja  | 
|  Amazon VPC Lattice  |  `AWS::VpcLattice::Service`  |  Nein  |  Ja  | 
|  AWS WAFV2  |  `AWS::WAFv2::WebAcl`  |  Nein  |  Ja  | 
|  Amazon WorkMail  |  `AWS::WorkMail::Organization`  |  Ja  |  Nein  | 
|  Amazon WorkSpaces  |  `AWS::WorkSpaces::Workspace`  |  Ja  |  Ja  | 

# Wie füge ich verwandte Informationen zur benutzerdefinierten Telemetrie hinzu, die an gesendet wird CloudWatch
<a name="adding-your-own-related-telemetry"></a>

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

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": "<resource-type>"`— 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": "<resource-id>"` – 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": "<service-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": "<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`.

------

## Bereitstellung zusätzlicher Details über die Entität mit dem Objekt „Attributes“
<a name="custom-related-telemetry-attributes"></a>

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