# Exploración de la telemetría relacionada
Los sistemas de computación pueden generar una gran cantidad de telemetría (incluidas métricas y registros) y los sistemas complejos, aún más. Al analizar un conjunto específico de telemetría, puede resultar difícil encontrar otro conjunto de telemetría relacionado con el conjunto inicial. Puede ser necesaria una capacitación avanzada para adquirir las habilidades necesarias para detectar problemas y solucionarlos. Dado que los sistemas son complejos, comprender lo que sucede puede implicar ver las métricas y los registros de muchos servicios y recursos diferentes, lo que requiere cambiar de contexto y navegar entre sistemas.
La característica **Explorar lo relacionado** de Amazon CloudWatch ofrece acceso a las relaciones entre los recursos de AWS, las métricas relacionadas y los registros en todas las consolas de servicio, lo que mejora la observabilidad y la eficiencia de los operadores de todos los niveles de habilidad. Al ver las alarmas o anomalías en los paneles de CloudWatch o las métricas en AWS, los usuarios pueden buscar y ver rápidamente las métricas y los registros de los recursos relacionados del sistema.
CloudWatch proporciona visibilidad de las métricas y los registros vinculados a recursos específicos, y el panel **Explorar lo relacionado** lo amplía al permitirle correlacionar los recursos de la infraestructura con las cargas de trabajo con toda la telemetría asociada. Esto le brinda un acceso rápido a la información que necesita para solucionar problemas relacionados con la infraestructura. Puede ver la relación entre los recursos y su telemetría relacionada en el panel **Explorar lo relacionado**. Puede acceder al panel **Explorar lo relacionado** desde CloudWatch o desde otras consolas de AWS donde se muestren los recursos o la telemetría.
**nota**
Actualmente, **Explorar lo relacionado** está limitado a las cuentas configuradas como cuentas de supervisión en la observabilidad entre cuentas de CloudWatch. Debe acceder a **Explorar lo relacionado** desde las cuentas de origen en las que se crearon y administraron originalmente los recursos. En las cuentas de origen, puede navegar entre los recursos conectados y ver los registros y las métricas relacionados.
En los temas siguientes se describen los detalles de la exploración de la telemetría relacionada.
**Topics**
+ [¿Qué es la telemetría relacionada?](#what-is-related-telemetry)
+ [Acceso al panel Explorar lo relacionado](#access-related-telemetry)
+ [Navegación por la telemetría relacionada](#using-related-telemetry)
+ [Uso del mapa topológico](#using-related-telemetry-map)
+ [Búsqueda de un recurso específico](#using-related-telemetry-find)
+ [Permisos y requisitos previos necesarios para ver y explorar la telemetría relacionada](#related-telemetry-permissions)
+ [¿Cómo hace CloudWatch para buscar la telemetría relacionada?](how-does-related-telemetry-work.md)
+ [Servicios de AWS que admiten la telemetría relacionada](services-with-related-telemetry.md)
+ [Cómo agregar información relacionada a la telemetría personalizada que se envía a CloudWatch](adding-your-own-related-telemetry.md)
## ¿Qué es la telemetría relacionada?
La telemetría relacionada consiste en métricas y datos de registros de los recursos que están relacionados con el recurso o servicio actuales. Normalmente, puede consultar las métricas y los registros relacionados con un único equilibrador de carga o toda la telemetría relacionada con Amazon EC2. La característica **Explorar lo relacionado** de Amazon CloudWatch agrega un *mapa topológico* interactivo. El mapa es una vista centrada en los recursos en la que puede encontrar métricas y registros de un recurso específico, pero también puede ver cómo ese recurso se conecta con otros recursos.
Por ejemplo, si busca la telemetría de un equilibrador de carga en el panel **Explorar lo relacionado**, además de las métricas y los registros asociados a ese equilibrador de carga, los mapas muestran los grupos de destino de ese equilibrador de carga. Al seleccionar uno de los grupos de destino, se mostrarán las instancias de Amazon EC2 asociadas a ese grupo de destino. En cada paso de este proceso, se muestra la telemetría, incluidas las métricas y los registros, de los recursos seleccionados, lo que facilita la búsqueda rápida de la telemetría que busca o la exploración de la telemetría para determinar la causa de un problema específico.
## Acceso al panel Explorar lo relacionado
En la consola de CloudWatch, hay varias formas de acceder a la telemetría relacionada con la vista actual. Por ejemplo, si está viendo un gráfico en un panel y desea ver la telemetría relacionada con ese gráfico o con un aspecto del gráfico, puede elegir explorar los datos relacionados directamente desde ese gráfico. En muchos lugares de la consola, puede elegir un elemento del menú **Explorar lo relacionado** o seleccionar el ícono de la brújula (![\[Compass icon representing navigation or direction in a user interface.\]](http://docs.aws.amazon.com/es_es/AmazonCloudWatch/latest/monitoring/images/compass-icon.png)) para mostrar el panel **Explorar lo relacionado**.
Puede acceder a la experiencia de exploración desde los puntos de entrada de la consola CloudWatch (y otras consolas de AWS), que incluyen:
+ **Navegación por métricas**: si selecciona **Métricas** y luego **Todas las métricas** en el menú de la izquierda de la consola de CloudWatch, el mosaico de cualquier servicio u origen de una métrica admitidos mostrará el ícono de la brújula, que muestra la telemetría relacionada en la esquina inferior derecha.
+ **Leyenda de la métrica**: al ver el gráfico de cualquier métrica (en la consola de CloudWatch u otras consolas de AWS), al pasar el ratón sobre la leyenda del gráfico, se muestra información sobre los datos, así como un botón **Explorar lo relacionado** que muestra la telemetría relacionada.
+ **Puntos de datos de métricas**: al ver el gráfico de cualquier métrica, al pasar el ratón sobre un punto de datos del gráfico, se muestra información sobre la métrica, así como un ícono de brújula, que muestra la telemetría relacionada.
+ **Búsqueda de métricas**: al buscar métricas en CloudWatch, si elige el nombre de una métrica encontrada, puede seleccionar **Explorar lo relacionado** en el menú que aparece, lo que mostrará la telemetría relacionada.
+ **Barra de herramientas de la consola**: en muchas páginas de la consola de AWS, la barra de herramientas de la consola (normalmente en la parte superior derecha de la consola) incluye un ícono del servicio CloudWatch, que mostrará las herramientas de CloudWatch, incluido el panel **Explorar lo relacionado**.
Según el lugar desde el que acceda al panel, el contexto predeterminado del panel mostrará un filtro adecuado, si es posible.
## Navegación por la telemetría relacionada
Al seleccionar cualquiera de los puntos de entrada al panel **Explorar lo relacionado**, aparece en la parte derecha de la consola de CloudWatch. Este panel le permite ver y buscar la telemetría relacionada con las *entidades* de su sistema. Una entidad es un recurso, como una instancia de Amazon EC2, o un servicio, como una aplicación que haya creado. Puede trabajar en este panel sin interrumpir el flujo de trabajo actual, ya que se abre a un lado de la página inicial.
En la siguiente imagen se muestra el panel **Explorar lo relacionado** centrado en una única instancia de Amazon EC2 y las entidades asociadas.
![\[El panel Explorar lo relacionado, enfocado en una única instancia de Amazon EC2 y sus entidades asociadas.\]](http://docs.aws.amazon.com/es_es/AmazonCloudWatch/latest/monitoring/images/compass-explore-main.png)
La parte superior del panel **Explorar lo relacionado** es un *mapa topológico* (mapa) visual de la entidad actual y otras entidades relacionadas. La entidad actualmente seleccionada establece el foco del panel. Hay dos formas de seleccionar una entidad.
+ [Mapa topológico](#using-related-telemetry-map): el *mapa* es una representación visual de la entidad actual con un enfoque. También muestra todas las entidades relacionadas, lo que le permite navegar por el conjunto de recursos y servicios que se relacionan entre sí.
+ [Buscar otros recursos](#using-related-telemetry-find): puede usar el botón **Buscar otros recursos** para filtrar y buscar entidades para usarlas como foco.
En la parte inferior del panel se muestra una búsqueda automática de métricas y registros de la entidad focal actual.
De forma predeterminada, el foco se pone en una entidad que coincide con la ubicación desde la que accedió al panel **Explorar lo relacionado**. Por ejemplo, si accedió luego de hacer clic en el ícono de la brújula asociado a una métrica de una instancia de Amazon EC2 específica, el foco se fijará en esa instancia de Amazon EC2.
Al seleccionar un recurso de AWS para el foco en el panel **Explorar lo relacionado**, puede navegar hasta la consola específica del recurso seleccionado. Por ejemplo, si seleccionó una instancia de Amazon EC2, puede seleccionar el enlace **Ver en la consola de EC2** para abrir la consola de Amazon EC2 con esa instancia seleccionada.
Cuando establece un foco, las métricas y los registros se filtran automáticamente para mostrar la telemetría relacionada con el foco.
+ **Métricas**: cada métrica se muestra en forma de gráfico para el periodo que haya elegido.
Al igual que con el gráfico de cualquier panel de CloudWatch, puede pasar el ratón sobre un gráfico o seleccionarlo para obtener más información sobre el gráfico de métricas y ver opciones, incluida la visualización de las métricas en CloudWatch. Si elige la vista en CloudWatch, se abrirá la vista de métricas con el mismo contexto de visualización que el panel **Explorar lo relacionado**, incluidos los recursos y el intervalo de tiempo.
+ **Patrones de registro**: CloudWatch analiza los grupos de registros asociados al recurso focal y muestra patrones comunes en esos registros. Para obtener más información acerca de patrones de registros, consulte [Pattern analysis](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/CWL_AnalyzeLogData_Patterns.html) en la *Guía del usuario de Registros de Amazon CloudWatch*.
Puede seleccionar **Intervalo de tiempo de comparación** para elegir otro intervalo de tiempo y comparar los registros de los dos intervalos de tiempo.
Puede seleccionar **Ver en Información de registros** para analizar los registros en Información de registros de CloudWatch con las mismas opciones de la vista actual, incluido el recurso, el grupo de registros y el intervalo de tiempo. Para obtener más información, consulte [Análisis de los datos de registro con la información de Registros de CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AnalyzingLogData.html) en la *Guía del usuario de Registros de Amazon CloudWatch*.
+ **Grupos de registros**: se muestran los [grupos de registros](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/Working-with-log-groups-and-streams.html) que contienen los registros.
Puede seleccionar los grupos de registro y, a continuación, llevar a cabo una de las siguientes acciones:
+ Elija **Empezar a seguir en Live Tail** para ver una lista en streaming de los nuevos eventos de registro a medida que se incorporan en los grupos de registro seleccionados. La sesión de Live Tail se inicia en la consola de CloudWatch. Para obtener más información sobre Live Tail, consulte [Solución de problemas con Live Tail de Registros de CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/CloudWatchLogs_LiveTail.html) en la *Guía del usuario de Registros de Amazon CloudWatch*.
+ Seleccione **Consulta en Información de registros** para abrir Información de registros con una consulta que se limite únicamente a esos grupos de registros y aplique el contexto actual, incluidos los recursos y el intervalo de tiempo.
## Uso del mapa topológico
El *mapa topológico* (mapa) es una representación visual de la entidad focal actual y los recursos o servicios relacionados. Puede utilizar esta visualización interactiva para ver las conexiones entre los distintos recursos y servicios y explorar las relaciones entre los componentes del sistema. Por ejemplo, si está viendo un recurso de *equilibrador de carga*, el mapa mostrará los recursos del *grupo de destino* conectado. Al seleccionar un grupo de destino, se mostrarán las instancias asociadas. La visualización de la conectividad ayuda a los operadores a comprender y explorar las relaciones entre los distintos recursos y servicios del sistema.
Puede arrastrar el mapa y acercarlo o alejarlo para ver más entidades asociadas o para enfocarse en menos entidades.
Al seleccionar una entidad asociada, como un grupo de destino, el foco del panel cambia para mostrar la telemetría de esa entidad. El mapa se actualiza para centrarse en el grupo de destino seleccionado y muestra sus conexiones a otras entidades, como el equilibrador de carga y las instancias de Amazon EC2 que se especifiquen en ese grupo de destino. A medida que navega por las distintas entidades del mapa, las métricas y los registros de la parte inferior del panel se actualizan dinámicamente, lo que le brinda la telemetría pertinente para los recursos recién seleccionados.
## Búsqueda de un recurso específico
Si un recurso no aparece en el mapa topológico, puede utilizar la característica **Buscar otros recursos** para ubicarlo. Puede filtrar los recursos por etiqueta o tipo y, a continuación, seleccionar los que busca. Una vez que haya encontrado los recursos en los que quiere enfocarse, volverá al mapa topológico, con esos recursos seleccionados, para buscar las entidades asociadas y la telemetría.
**nota**
Hay muchos motivos por los que es posible que no vea los recursos en el mapa topológico. Por ejemplo:
No se relacionan con la entidad focal actual.
No tiene [permisos](#related-telemetry-permissions) para acceder a las entidades asociadas ni a la telemetría.
Es posible que el [recurso o servicio](services-with-related-telemetry.md) no admitan la telemetría o las entidades asociadas.
Al utilizar **Buscar otros recursos**, puede descubrir y visualizar recursos que tal vez no estén directamente conectados o no sean visibles en el mapa actual. Esto garantiza que pueda acceder a todos los componentes pertinentes de la infraestructura y analizarlos.
**Selección de un recurso con Buscar recursos**
1. Abra el panel **Explorar lo relacionado** desde cualquiera de los [puntos de entrada](#access-related-telemetry) de la consola de CloudWatch.
1. Elija **Buscar recursos**.
1. Elija el intervalo de tiempo para el que quiere ver los registros o las métricas.
1. Elija **Tipos de recurso** y, a continuación, seleccione el tipo de recurso en el que quiere centrarse de la lista desplegable, por ejemplo, **Instancias de EC2**.
1. De manera opcional, filtre el conjunto de recursos mediante una etiqueta por la que filtrar. Para ello, puede seleccionar el filtro **Filtrar recursos por etiquetas** o elegir la etiqueta que diga que **Se encontraron 5 etiquetas** (el número dependerá de las etiquetas del sistema). Esto le devuelve una lista de etiquetas entre las que puede elegir.
Una vez que haya seleccionado las etiquetas, la lista de recursos se filtra automáticamente para incluir solo los que están asociados a esas etiquetas.
1. Si lo desea, elija uno o más recursos específicos de los que se encontraron que coincidan con los filtros.
1. Seleccione **Mostrar en el mapa** para volver al **mapa topológico** con los recursos seleccionados.
Las listas de **Métricas** y **Registros** ahora están filtradas para incluir solo las métricas y los registros que están asociados a ese tipo de recurso. Puede elegir la pestaña **Métricas** o **Registros** para ver el tipo de telemetría que quiere consultar.
## Permisos y requisitos previos necesarios para ver y explorar la telemetría relacionada
Para explorar la telemetría relacionada, debe obtener información de la entidad junto con la telemetría de las cargas de trabajo y debe tener los permisos adecuados para ver esos datos.
Muchos servicios envían la información de la entidad automáticamente. Para las cargas de trabajo que utilizan el agente de CloudWatch, debe tener al menos la versión `1.300049.1` del agente y configurarla correctamente. Para obtener información acerca de cómo configurar el agente, consulte [Cómo agregar información relacionada a la telemetría personalizada que se envía a CloudWatch](adding-your-own-related-telemetry.md). Para las cargas de trabajo que se ejecutan en Amazon EKS, debe tener al menos la versión `v2.3.1-eksbuild.1` del complemento de observabilidad de EKS de Amazon CloudWatch. Para obtener más información acerca de este complemento, consulte [Inicio rápido con el complemento de observabilidad de EKS de Amazon CloudWatch](Container-Insights-setup-EKS-addon.md).
Para explorar la telemetría relacionada, tiene que haber iniciado sesión con ciertos permisos. La exploración de la telemetría relacionada es una actividad de solo lectura y requiere al menos acceso de solo lectura a CloudWatch.
Los permisos necesarios para ver las asociaciones entre la telemetría y las entidades son `logs:ListLogGroupsForEntity`, `logs:ListEntitiesForLogGroup`, `cloudwatch:ListEntitiesForMetric` y `application-signals:ListObservedEntities`.
Cada una de las siguientes políticas administradas de AWS proporcionará los permisos de CloudWatch necesarios para acceder a la telemetría relacionada en la consola de CloudWatch:
+ [CloudWatchFullAccessV2](https://docs.aws.amazon.com/aws-managed-policy/latest/reference/CloudWatchFullAccessV2.html): concede acceso total a CloudWatch.
+ [CloudWatchReadOnlyAccess](https://docs.aws.amazon.com/aws-managed-policy/latest/reference/CloudWatchReadOnlyAccess.html): concede acceso de solo lectura a CloudWatch.
+ [ReadOnlyAccess](https://docs.aws.amazon.com/aws-managed-policy/latest/reference/ReadOnlyAccess.html): concede acceso de solo lectura a los servicios y recursos de AWS.
Además, debe tener al menos acceso de solo lectura (`Describe*` y `Get*`) a todos los recursos del mapa topológico para que CloudWatch detecte y muestre las relaciones.
Para obtener más información sobre cómo usar políticas para controlar el acceso, consulte [Administración del acceso con políticas](auth-and-access-control-cw.md#security_iam_access-manage).
# ¿Cómo hace CloudWatch para buscar la telemetría relacionada?
El panel **Explorar lo relacionado** de CloudWatch muestra las métricas y los registros que se relacionan entre sí, pero ¿cómo funciona esto?
Las métricas y los registros que se envían a CloudWatch pueden incluir una *entidad* opcional con la que se relacionen. Por lo general, la entidad será una representación de lo que trata la telemetría. Por ejemplo, una métrica sobre el uso de la CPU hace referencia a una instancia de Amazon EC2 y utilizará esa instancia como entidad. Al ver esa métrica en el panel **Explorar lo relacionado**, se muestra otra telemetría para esa misma instancia.
El *mapa topológico* (mapa) del panel **Explorar lo relacionado** muestra el recurso seleccionado actualmente, junto con los *recursos relacionados*. En el caso de los recursos de AWS, CloudWatch muestra automáticamente otros recursos que sabe que están relacionados. Por ejemplo, si está viendo una instancia de Amazon EC2, el mapa también mostrará los volúmenes de Amazon EBS que estén conectados a la instancia. Al seleccionar un volumen, se muestra la telemetría del volumen, y el mapa se actualiza para mostrar los recursos relacionados con el volumen. También muestra los recursos que forman parte del mismo *servicio*.
La información de la entidad asociada a la telemetría define el recurso al que está asociada la telemetría; por ejemplo, la instancia de Amazon EC2. Sin embargo, también puede incluir datos contextuales sobre el recurso. Por ejemplo, si tiene una aplicación de un sitio web que incluye recursos, como una instancia de Amazon EC2 y una base de datos, la información de la entidad puede incluir la aplicación del sitio web como servicio. En este caso, el mapa topológico muestra el servicio como una entidad relacionada y, cuando se selecciona, muestra las instancias y la base de datos. Esto puede facilitar la búsqueda de toda la telemetría de un servicio.
**nota**
CloudWatch debe haber recibido telemetría con información de la entidad en las últimas tres horas para poder encontrar recursos relacionados y telemetría.
## ¿De dónde provienen los datos de una entidad?
CloudWatch obtiene entidades para telemetría de diferentes maneras:
+ La mayoría de los datos de telemetría que se envían a CloudWatch desde los servicios de AWS se asocian automáticamente a los recursos. Para obtener una lista completa de los recursos admitidos, consulte [Servicios de AWS que admiten la telemetría relacionada](services-with-related-telemetry.md).
+ El agente de CloudWatch agrega automáticamente la información de la entidad a la telemetría que envía a CloudWatch.
**nota**
Es posible que tenga que actualizar el agente de CloudWatch a la versión más reciente para poder incluir los datos de la entidad. Para obtener más información, consulte [Recopile las métricas, registros y seguimientos con el agente de CloudWatch](Install-CloudWatch-Agent.md) y [Configuración de los nombres de entorno y servicio del agente de CloudWatch para las entidades relacionadas](CloudWatch-Agent-configure-related-telemetry.md).
+ Al enviar su propia telemetría, puede agregar información de la entidad a los datos. Para obtener más información, consulte [Cómo agregar información relacionada a la telemetría personalizada que se envía a CloudWatch](adding-your-own-related-telemetry.md).
+ CloudWatch hace todo lo posible por reconocer la información de la entidad asociada a otros datos de telemetría (por ejemplo, la telemetría personalizada que se envía a CloudWatch sin ninguna información de la entidad).
## ¿De dónde provienen los datos de servicio?
Además de reconocer las conexiones naturales entre los recursos, como un recurso de instancia y un recurso de volumen conectado, CloudWatch también puede agrupar los recursos por *servicio*. Por ejemplo, un servicio puede ser la aplicación de un sitio web. Es posible que una instancia de Amazon EC2 con un servidor web y otra con una base de datos formen parte del mismo servicio y estén conectadas en el mapa topológico en función de ese servicio.
CloudWatch obtiene un nombre de servicio para telemetría de diferentes maneras, entre otras:
+ Para establecer el nombre del servicio, las señales de aplicaciones o la telemetría instrumentada de otel utilizan la variable de entorno `OTEL_SERVICE_NAME` que utilizan las bibliotecas de instrumentación de OpenTelemetry admitidas.
+ La configuración del agente de CloudWatch permite configurar un nombre de servicio. Para obtener más información, consulte [Configuración de los nombres de entorno y servicio del agente de CloudWatch para las entidades relacionadas](CloudWatch-Agent-configure-related-telemetry.md).
+ Las cargas de trabajo de Kubernetes utilizan un nombre correspondiente del clúster, como Deployment, ReplicaSet, Pod o Container, como nombre del servicio.
+ En el caso de las cargas de trabajo de Amazon EC2, el servicio puede proceder de etiquetas (las etiquetas `service`, `application` o `app`).
**nota**
A fin de usar etiquetas para generar nombres de servicios, primero debe [configurar los metadatos de la instancia](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/work-with-tags-in-IMDS.html#allow-access-to-tags-in-IMDS) de Amazon EC2.
+ Al enviar su propia telemetría, puede agregar información del servicio a los datos. Para obtener más información, consulte [Cómo agregar información relacionada a la telemetría personalizada que se envía a CloudWatch](adding-your-own-related-telemetry.md).
+ Cuando no se puede usar lo anterior, CloudWatch usa como nombre del servicio el nombre del rol de IAM que envía las métricas. Esto, por ejemplo, puede proporcionar un nombre de servicio para la telemetría de Amazon ECS.
# Servicios de AWS que admiten la telemetría relacionada
En la siguiente tabla, se enumeran los servicios de AWS que admiten la información de entidades relacionadas en la telemetría de CloudWatch. Los servicios o recursos que no figuran en la tabla no tienen información de entidades relacionadas expuesta en CloudWatch.
**nota**
En el caso de los servicios que utilizan el [agente de CloudWatch](Install-CloudWatch-Agent.md), es posible que tenga que actualizar el agente a la versión más reciente para obtener la telemetría relacionada. Para obtener información sobre el envío de información de entidades relacionadas con sus propias métricas personalizadas, consulte [Cómo agregar información relacionada a la telemetría personalizada que se envía a CloudWatch](adding-your-own-related-telemetry.md).
| Servicio de AWS | Recurso | Métricas | Registros |
| --- | --- | --- | --- |
| Amazon API Gateway | `AWS::ApiGateway::Method` | Sí | No |
| Amazon API Gateway | `AWS::ApiGateway::Resource` | Sí | No |
| Amazon API Gateway | `AWS::ApiGateway::RestApi` | Sí | No |
| Amazon API Gateway | `AWS::ApiGateway::Stage` | Sí | Sí |
| Amazon API Gateway | `AWS::ApiGateway::VpcLink` | Sí | No |
| Amazon API Gateway V2 | `AWS::ApiGatewayV2::Integration` | Sí | No |
| Amazon API Gateway V2 | `AWS::ApiGatewayV2::Route` | Sí | No |
| Amazon API Gateway V2 | `AWS::ApiGatewayV2::Stage` | No | Sí |
| Amazon API Gateway V2 | `AWS::ApiGatewayV2::Api` | Sí | No |
| AWS App Runner | `AWS::AppRunner::Service` | No | Sí |
| AWS Application Migration Service | `AWS::MGN::SourceServer` | Sí | No |
| Amazon WorkSpaces Applications | `AWS::AppStream::Fleet` | Sí | Sí |
| AWS AppSync | `AWS::AppSync::GraphQLApi` | Sí | Sí |
| Intercambio de datos B2B de AWS | `AWS::B2BI::Transformer` | No | Sí |
| AWS Backup gateway | `AWS::BackupGateway::Hypervisor` | No | Sí |
| Amazon Bedrock | `AWS::Bedrock::KnowledgeBase` | No | Sí |
| Amazon Bedrock | `AWS::Bedrock::ModelId` | Sí | No |
| Amazon Chime | `AWS::Chime::SipMediaApplication` | No | Sí |
| Amazon Chime | `AWS::Chime::VoiceConnector` | No | Sí |
| AWS Clean Rooms | `AWS::CleanRooms::Membership` | No | Sí |
| AWS CloudFormation | | No | Sí |
| Enlaces de AWS CloudFormation | | No | Sí |
| Amazon CloudFront | `AWS::CloudFront::Distribution` | Sí | Sí |
| AWS CloudTrail | `AWS::CloudTrail::EventDataStore` | No | Sí |
| AWS CloudTrail | `AWS::CloudTrail::Trail` | No | Sí |
| Amazon CloudWatch | `AWS::CloudWatch::MetricStream` | Sí | No |
| Registros de Amazon CloudWatch | `AWS::Logs::LogGroup` | Sí | No |
| Amazon CloudWatch RUM | `AWS::RUM::AppMonitor` | No | Sí |
| Amazon CloudWatch Synthetics | `AWS::Synthetics::Canary` | Sí | No |
| AWS CodeBuild | `AWS::CodeBuild::Project` | Sí | No |
| Amazon CodeWhisperer | `AWS::CodeWhisperer::Customization` | No | Sí |
| Amazon Cognito user pools | `AWS::Cognito::UserPool` | Sí | Sí |
| AWS Config | `AWS::Config::ConfigRule` | No | Sí |
| Amazon Connect | `AWS::Connect::Instance` | No | Sí |
| AWS Database Migration Service | `AWS::DMS::ReplicationInstance` | Sí | No |
| AWS Database Migration Service | `AWS::DMS::ReplicationTask` | Sí | No |
| AWS DataSync | `AWS::Datasync::Agent` | Sí | No |
| AWS DataSync | `AWS::DataSync::Task` | Sí | Sí |
| AWS Directory Service | `AWS::DirectoryService::MicrosoftAD` | No | Sí |
| Amazon DynamoDB | `AWS::DynamoDB::Table` | Sí | No |
| Acelerador DynamoDB | `AWS::DAX::Cluster` | Sí | No |
| Amazon EC2 | `AWS::EC2::CapacityReservation` | Sí | No |
| Amazon EC2 | `AWS::EC2::Instance` | Sí | No |
| Amazon EC2 | `AWS::EC2::FlowLog` | Sí | No |
| Amazon EC2 | `AWS::EC2::NATGateway` | Sí | No |
| Amazon EC2 | `AWS::EC2::NetworkInterface` | Sí | Sí |
| Amazon EC2 | `AWS::EC2::Subnet` | Sí | Sí |
| Amazon EC2 | `AWS::EC2::TransitGateway` | Sí | No |
| Amazon EC2 | `AWS::EC2::TransitGatewayAttachment` | Sí | Sí |
| Amazon EC2 | `AWS::EC2::VerifiedAccessInstance` | No | Sí |
| Amazon EC2 | `AWS::EC2::Volume` | Sí | No |
| Amazon EC2 | `AWS::EC2::VPC` | No | Sí |
| Amazon EC2 | `AWS::EC2::VPNConnection` | Sí | Sí |
| Amazon EC2 Auto Scaling | `AWS::AutoScaling::AutoScalingGroup` | Sí | No |
| AWS Elastic Beanstalk | `AWS::ElasticBeanstalk::Environment` | Sí | No |
| Amazon Elastic Container Service | `AWS::ECS::Cluster` | Sí | Sí |
| Amazon Elastic Container Service | `AWS::ECS::Service` | Sí | Sí |
| Amazon Elastic File System | `AWS::EFS::AccessPoint` | Sí | No |
| Amazon Elastic File System | `AWS::EFS::FileSystem` | Sí | No |
| Amazon Elastic File System | `AWS::EFS::MountTarget` | Sí | No |
| Amazon Elastic Kubernetes Service | `AWS::EKS::Cluster` | Sí | Sí |
| Amazon Elastic Kubernetes Service en AWS Fargate | | No | Sí |
| Elastic Load Balancing | `AWS::ElasticLoadBalancing::LoadBalancer` | Sí | No |
| Elastic Load Balancing V2 | `AWS::ElasticLoadBalancingV2::LoadBalancer` | Sí | No |
| Elastic Load Balancing V2 | `AWS::ElasticLoadBalancingV2::TargetGroup` | Sí | No |
| Amazon ElastiCache | `AWS::ElastiCache::CacheCluster` | Sí | Sí |
| AWS Elemental MediaConvert | `AWS::MediaConvert::Queue` | Sí | No |
| AWS Elemental MediaLive | | No | Sí |
| AWS Elemental MediaLive | `AWS::MediaLive::Channel` | Sí | No |
| AWS Elemental MediaPackage | `AWS::MediaPackage::Channel` | Sí | No |
| AWS Elemental MediaStore | `AWS::MediaStore::Container` | Sí | Sí |
| AWS Elemental MediaTailor | | No | Sí |
| Amazon EMR | `AWS::EMR::Cluster` | Sí | Sí |
| Amazon EventBridge | `AWS::Events::Rule` | Sí | Sí |
| Canalizaciones de Amazon EventBridge | `AWS::Pipes::Pipe` | Sí | Sí |
| AWS Fault Injection Service | `AWS::FIS::ExperimentTemplate` | No | Sí |
| Amazon FinSpace | `AWS::FinSpace::Environment` | No | Sí |
| Amazon FSx | `AWS::FSx::FileSystem` | Sí | No |
| Servidores de Amazon GameLift (Amazon GameLift Servers) | `AWS::GameLift::Fleet` | Sí | No |
| AWS Glue | `AWS::Glue::Job` | No | Sí |
| AWS Identity Sync | `AWS::IdentitySync::Profile` | No | Sí |
| Amazon Interactive Video Service | `AWS::IVSChat::LoggingConfiguration` | Sí | Sí |
| AWS IoT | `AWS::IoT::TopicRule` | Sí | Sí |
| AWS IoT 1-Click | `AWS::IoT1Click::Device` | Sí | No |
| AWS IoT Events | | No | Sí |
| AWS IoT FleetWise | `AWS::IoTFleetWise::Vehicle` | No | Sí |
| AWS IoT SiteWise | | No | Sí |
| AWS Key Management Service | `AWS::KMS::Key` | Sí | No |
| Amazon Managed Service para Apache Flink | `AWS::KinesisAnalytics::Application` | Sí | Sí |
| Amazon Data Firehose | `AWS::KinesisFirehose::DeliveryStream` | Sí | Sí |
| Amazon Kinesis Data Streams | `AWS::Kinesis::Stream` | Sí | No |
| Amazon Kinesis Video Streams | `AWS::KinesisVideo::Stream` | Sí | No |
| AWS Lambda | `AWS::Lambda::Function` | Sí | No |
| Amazon Lex | | No | Sí |
| AWS Mainframe Modernization | `AWS::M2::Application` | No | Sí |
| Transmisión administrada de Amazon para Apache Kafka | `AWS::Kafka::Cluster` | Sí | No |
| Transmisión administrada de Amazon para Apache Kafka | `AWS::KafkaConnect::Connector` | No | Sí |
| Transmisión administrada de Amazon para Apache Kafka | `AWS::MSK::Cluster` | Sí | Sí |
| Amazon MemoryDB | `AWS::Mmemorydb::Cluster` | Sí | No |
| Amazon MQ | `AWS::AmazonMQ::Broker` | Sí | Sí |
| AWS Network Firewall | `AWS::NetworkFirewall::Firewall` | Sí | Sí |
| Amazon OpenSearch Service | `AWS::OpenSearchService::Domain` | Sí | No |
| Amazon OpenSearch Service | | No | Sí |
| Ingesta de Amazon OpenSearch Service | `AWS::OSIS::Pipeline` | No | Sí |
| AWS Organizations | `AWS::Organizations::Organization` | No | Sí |
| AWS Outposts | `AWS::Outposts::Outpost` | Sí | No |
| Amazon Managed Service para Prometheus | `AWS::Prometheus::Resource` | Sí | No |
| Amazon Q Business | | No | Sí |
| Amazon QLDB | `AWS::QLDB::Ledger` | Sí | No |
| Amazon Quick | `AWS::Quicksight::Dashboard` | Sí | No |
| Amazon Quick | `AWS::Quicksight::DataSet` | Sí | No |
| Amazon Redshift | `AWS::Redshift::Cluster` | Sí | Sí |
| Amazon Redshift sin servidor | `AWS::RedshiftServerless::Workgroup` | Sí | No |
| Amazon Relational Database Service | `AWS::RDS::DBCluster` | Sí | Sí |
| Amazon Relational Database Service | `AWS::RDS::DBInstance` | Sí | Sí |
| Amazon Route 53 | `AWS::Route53::HealthCheck` | Sí | Sí |
| Amazon Route 53 | `AWS::Route53::HostedZone` | Sí | No |
| Amazon Route 53 Resolver | `AWS::Route53Resolver::ResolverEndpoint` | Sí | No |
| Amazon S3 | `AWS::S3::Bucket` | Sí | No |
| Amazon SageMaker AI | `AWS::SageMaker::Endpoint` | Sí | No |
| Amazon SageMaker AI | `AWS::SageMaker::Workteam` | No | Sí |
| AWS Service Catalog | `AWS::ServiceCatalog::CloudFormationProduct` | Sí | No |
| Amazon Simple Email Service | `AWS::SES::ConfigurationSet` | Sí | No |
| Amazon Simple Notification Service | `AWS::SNS::Topic` | Sí | Sí |
| Amazon Simple Notification Service | | No | Sí |
| Amazon Simple Queue Service | `AWS::SQS::Queue` | Sí | No |
| AWS Step Functions | `AWS::StepFunctions::Activity` | Sí | No |
| AWS Step Functions | `AWS::StepFunctions::StateMachine` | Sí | Sí |
| AWS Storage Gateway | `AWS::StorageGateway::Gateway` | Sí | No |
| AWS Storage Gateway | `AWS::StorageGateway::Share` | No | Sí |
| AWS Transfer Family | `AWS::Transfer::Server` | Sí | Sí |
| Amazon VPC Lattice | `AWS::VpcLattice::Service` | No | Sí |
| AWS WAFV2 | `AWS::WAFv2::WebAcl` | No | Sí |
| Amazon WorkMail | `AWS::WorkMail::Organization` | Sí | No |
| Amazon WorkSpaces | `AWS::WorkSpaces::Workspace` | Sí | Sí |
# Cómo agregar información relacionada a la telemetría personalizada que se envía a CloudWatch
Cuando publica sus propias métricas y registros en CloudWatch, la información de la entidad necesaria para la telemetría relacionada no aparece de forma predeterminada. Al enviar métricas a CloudWatch o registros a Registros de CloudWatch (con las operaciones [PutMetricData](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_PutMetricData.html) o [PutLogEvents](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutLogEvents.html)), puede agregar información de la entidad a esos registros o métricas. La información de la entidad se asocia a la telemetría y se utiliza en la característica **Explorar lo relacionado** para buscar la telemetría relacionada asociada a la misma entidad.
La entidad que se envía con la telemetría representa un recurso o servicio al que está asociada la telemetría. Por ejemplo, una métrica sobre un servicio o que proviene de un recurso de AWS. Para identificar en el código la entidad asociada, puede crear un conjunto de `KeyAttributes` y `Attributes` opcional de la entidad.
**nota**
CloudWatch solo puede buscar recursos relacionados de entidades para las que se haya enviado telemetría en las últimas tres horas. Si su recurso solo emite telemetría dispersa (menos de una vez cada 3 horas), puede que quiera enviar telemetría de *latidos* adicional para mantener la entidad activa en CloudWatch.
Para obtener información sobre cómo agregar información de la entidad, consulte [Información de la entidad en formato EMF](CloudWatch_Embedded_Metric_Format_Specification.md#entity-information-emf-format).
En las siguientes secciones se describe cómo crear las propiedades `KeyAttributes` y `Attributes` para que CloudWatch pueda identificar los recursos y servicios asociados a la telemetría.
## Identificación de la entidad con el objeto KeyAttributes
La propiedad `KeyAttributes` de los objetos Entity ([en CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_Entity.html) o [en Registros de CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_Entity.html)) identifica de forma exclusiva la entidad en CloudWatch. Se trata de una lista de pares clave-valor. Las entidades con la misma propiedad `KeyAttributes` se consideran la misma entidad. La telemetría asociada a la misma entidad se considera relacionada y se puede buscar fácilmente en el panel **Explorar lo relacionado**.
**nota**
En la API de CloudWatch, la propiedad se denomina `KeyAttributes`. En la API de Registros de CloudWatch, la propiedad se denomina `keyAttributes`. Aquí se tratan como la misma propiedad.
Hay cinco tipos posibles de objetos que una propiedad `Entity` puede representar.
+ **AWS::Resource**: la entidad representa un recurso de AWS, como una tabla de DynamoDB o una instancia de Amazon EC2.
+ **AWS::Service**: la entidad representa un servicio de AWS, como Amazon S3. Esto podría usarse, por ejemplo, al llamar a la operación `ListBuckets`, que no está asociada a un recurso específico de Amazon S3.
+ **Service**: la entidad representa una carga de trabajo que se ejecuta en la cuenta. Por ejemplo, una aplicación o un servicio que usted administra.
+ **Resource**: la entidad representa un recurso que AWS no administra; por ejemplo, recursos del sistema operativo, como los procesos o los volúmenes de archivos.
+ **RemoteService**: la entidad representa un servicio externo en una llamada remota. Por ejemplo, una llamada remota a una base de datos, una caché externa o un punto de conexión externo.
Según cuál de los tipos anteriores intente representar, debe proporcionar los pares clave-valor correctos para la propiedad `KeyAttributes`. A continuación se describe cada tipo.
------
#### [ AWS::Resource ]
Para especificar un recurso de AWS, tiene que incluir los tres pares de clave-valor siguientes:
+ `"Type": "AWS::Resource"`: este par clave-valor identifica la entidad como recurso de AWS.
+ `"ResourceType": ""`: el valor de cadena de `ResourceType` es la cadena del [tipo de recurso](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-template-resource-type-ref.html) de CloudFormation. Por ejemplo, `AWS::DynamoDB::Table`.
+ `"Identifier": ""`: el identificador principal del recurso. Para obtener más información, consulte [primaryIdentifier](https://docs.aws.amazon.com/cloudformation-cli/latest/userguide/resource-type-schema.html#schema-properties-primaryidentifier) en *Extension Development for CloudFormation User Guide*.
------
#### [ AWS::Service ]
Para especificar un servicio de AWS, tiene que incluir los dos pares clave-valor siguientes:
+ `"Type": "AWS::Service"`: este par clave-valor identifica la entidad como servicio de AWS.
+ `"Name": ""`: el valor de `Name` es la cadena del [nombre de servicio](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-template-resource-type-ref.html) de CloudFormation. Por ejemplo, `AWS::DynamoDB`.
------
#### [ Service ]
Para especificar un servicio que no esté a cargo de AWS, tiene que incluir los tres pares clave-valor siguientes:
+ `"Type": "Service"`: este par clave-valor identifica la entidad como servicio.
+ `"Name": ""`: representa el nombre del servicio que envía las métricas. Por ejemplo, `my-service-frontend` o `api.myservice.com`.
+ `"Environment": ""`: este atributo especifica dónde se aloja el servicio, o el entorno al que pertenece. Por ejemplo, `us-west-2` o `myservice.production`.
------
#### [ Resource ]
Para especificar un recurso que no proporcione AWS, tiene que incluir los tres pares clave-valor siguientes:
+ `"Type": "Resource"`: este par clave-valor identifica la entidad como recurso.
+ `"ResourceType": ""`: una cadena que especifica el tipo de recurso. Por ejemplo, `K8s::Pod` para un pod de Kubernetes.
+ `"Identifier": ""`: un identificador de cadena del recurso. Puede contener varios nombres, separados por barras verticales. Por ejemplo, un pod de Kubernetes podría representarse por el nombre del clúster, el espacio de nombres y el nombre del pod, como `MyCluster|MyNamespace|MyPod`.
------
#### [ RemoteService ]
Para especificar un servicio remoto, tiene que incluir los dos pares clave-valor siguientes:
+ `"Type": "RemoteService"`: este par clave-valor identifica la entidad como servicio remoto.
+ `"Name": ""`: especifica de qué manera la aplicación hace referencia al servicio externo en una llamada remota. Por ejemplo, `api.test.myservice.com`.
------
## Cómo proporcionar detalles adicionales sobre la entidad con el objeto Attributes
Puede proporcionar detalles adicionales sobre el objeto `Entity` que proporciona con la telemetría. Esto puede incluir detalles sobre la plataforma, el recurso, la aplicación o el proveedor de telemetría. En las siguientes tablas se describen las palabras clave que puede utilizar para cada uno de estos tipos de datos.
**nota**
En la API de CloudWatch, la propiedad se denomina `Attributes`. En la API de Registros de CloudWatch, la propiedad se denomina `attributes`. Aquí se tratan como la misma propiedad.
**Detalles de la plataforma**
| Palabra clave | Uso | Dominio de valores | Ejemplos |
| --- | --- | --- | --- |
| `PlatformType` | Define la plataforma alojada. | AWS::EKS, AWS::ECS, AWS::EC2, AWS::Lambda, K8s, Generic | `AWS::EC2` |
| `EKS.Cluster` | Nombre del clúster de Amazon EKS. | Cadena alfanumérica con delimitadores básicos. | `FlyingSquad` |
| `K8s.Cluster` | Nombre del clúster de Kubernetes autoalojado. | Cadena alfanumérica con delimitadores básicos. | `minicube` |
| `K8s.Namespace` | Nombre del espacio de nombres de Kubernetes en los clústeres de Amazon EKS o K8s. | Cadena alfanumérica con delimitadores básicos. | `default`, `pet-clinic` |
| `K8s.Workload` | Nombre de la carga de trabajo de Kubernetes en los clústeres de Amazon EKS y K8s. | Cadena alfanumérica con delimitadores básicos. | `frontend` |
| `K8s.Node` | Identidad del nodo de Kubernetes en los clústeres de Amazon EKS y K8s. | Nombre del nodo de K8s (por ejemplo, nombre de DNS de la instancia de Amazon EC2). | `ip-11-22-33-44.ec2.internal` |
| `K8s.Pod` | Identidad del pod de Kubernetes en los clústeres de Amazon EKS y K8s. | Identificador del pod de K8s. | `frontend-1234abcd56-ef7890` |
| `EC2.AutoScalingGroup` | Nombre del grupo de Amazon EC2 Auto Scaling. | Cadena alfanumérica con delimitadores básicos. | `my-asg-name-1` |
| `EC2.InstanceId` | Identidad de la instancia de Amazon EC2. | Identificador de la instancia de Amazon EC2. | `i-1234abcd5678ef90` |
| `ECS.Cluster` | Identidad del clúster de Amazon ECS. | Nombre del clúster de Amazon ECS. | `MyCluster` |
| `ECS.Service` | Identidad del servicio de Amazon ECS. | Nombre del servicio de Amazon ECS. | `MyService` |
| `ECS.Task` | Identidad de la tarea de Amazon ECS. | Identificador de la tarea de Amazon ECS. | `task-123abc` |
| `Lambda.Function` | Identidad de la función de Lambda. | Nombre de la función de Lambda. | `MyFunction` |
| `Host` | Nombre del host para todos los tipos de plataforma. | Formato del subdominio. | `ip-111-22-33-44.example.com` |
**Detalles del recurso**
| Palabra clave | Uso | Dominio de valores | Ejemplos |
| --- | --- | --- | --- |
| `AWS.Resource.ARN` | ARN del recurso de AWS. | Cadena alfanumérica con delimitadores básicos. | `arn:aws:dynamodb:us-east-1:123456789012:table/myDynamoDBTable` |
**Detalles de la aplicación**
| Palabra clave | Uso | Dominio de valores | Ejemplos |
| --- | --- | --- | --- |
| `AWS.Application` | Nombre de la aplicación en AppRegistry. | Cadena alfanumérica con delimitadores básicos. | `PetClinicApp` |
| `AWS.Application.ARN` | ARN de la aplicación en AppRegistry. | Cadena alfanumérica con delimitadores básicos. | `arn:aws:servicecatalog:us-east-1:1234567890:/applications/...` |
**Detalles del proveedor de telemetría**
| Palabra clave | Uso | Dominio de valores | Ejemplos |
| --- | --- | --- | --- |
| `Telemetry.SDK` | La huella digital de la versión del SDK de OTEL para servicios instrumentados. | Cadena alfanumérica con delimitadores básicos. | `opentelemetry,1.32.0-aws-SNAPSHOT,java,Auto` |
| `Telemetry.Agent` | La huella digital del agente utilizado para recopilar y enviar datos de telemetría. | Cadena alfanumérica con delimitadores básicos. | `CWAgent/1.300026.3, ADOTCollector/1.x` |
| `Telemetry.Source` | Especifica el punto de aplicación en el que se recopiló la telemetría o qué se utilizó como origen de los datos de telemetría. | ServerSpan, ClientSpan, ProducerSpan, ConsumerSpan, LocalRoot Span, JMX, OS. | `ClientSpan, JMX` |