# Monitoreo del estado operativo de sus aplicaciones con Application Signals
Utilice Application Signals en la [consola de CloudWatch](https://console.aws.amazon.com/cloudwatch/) para monitorear y solucionar problemas del estado operativo de sus aplicaciones:
+ **Monitoree los servicios de sus aplicaciones**: como parte del monitoreo operativo diario, utilice la página [Servicios](Services-page.md) para ver un resumen de todos los servicios. Consulte los servicios con la mayor tasa de errores o latencia y compruebe qué servicios tienen [indicadores de servicio (SLI)](CloudWatch-ServiceLevelObjectives.md) que no funcionan de forma correcta. Seleccione un servicio para abrir la página [Detalles del servicio](ServiceDetail.md) y ver las métricas detalladas, las operaciones del servicio, los valores controlados de Synthetics y las solicitudes de los clientes. Esto le permite solucionar problemas e identificar la causa raíz de los problemas operativos.
+ **Inspeccione la topología de su aplicación**: utilice [Mapa de aplicaciones](ServiceMap.md) para comprender y supervisar la topología de su aplicación a lo largo del tiempo, lo que incluye las relaciones entre los clientes, los canarios de Synthetics, los servicios y las dependencias. Vea al instante el estado del indicador de servicio (SLI) y consulte las métricas clave, como el volumen de llamadas, la tasa de errores y la latencia. Para obtener información más detallada, desplácese a la página [Detalles del servicio](ServiceDetail.md).
Explore un [ejemplo de escenario](Services-example-scenario.md) que demuestra cómo se pueden utilizar estas páginas para solucionar con rapidez un problema de estado del servicio operativo, desde la detección inicial hasta la identificación de la causa raíz.
**Cómo Application Signals permite el monitoreo del estado operativo**
Después de [activar su aplicación](CloudWatch-Application-Signals-Enable.md) para Application Signals, los servicios de la aplicación, las API y sus dependencias se detectan de manera automática y se muestran en las páginas **Servicios**, **Detalles del servicio** y **Mapa de aplicaciones**. Application Signals recopila información de varios orígenes para poder activar la detección de servicios y la supervisión del estado operativo:
+ [AWS Distro para OpenTelemetry (ADOT)](CloudWatch-Application-Signals-supportmatrix.md): como parte de la habilitación de Application Signals, se configuran bibliotecas de autoinstrumentación OpenTelemetry Java y Python para emitir métricas y seguimientos recopilados por el agente de CloudWatch. Las métricas y los seguimientos se utilizan para activar la detección de servicios, operaciones, dependencias y otra información de servicio.
+ [Objetivos de nivel de servicio (SLO)](CloudWatch-ServiceLevelObjectives.md): después de crear objetivos de nivel de servicio para sus servicios, las páginas Servicios, Detalles del servicio y Mapa de aplicaciones muestran el estado del indicador de nivel de servicio (SLI). Los SLI pueden monitorear la latencia, la disponibilidad y otras métricas operativas.
+ [Valores controlados de CloudWatch](CloudWatch_Synthetics_Canaries.md): cuando configura el rastreo de rayos X en los valores controlados, las llamadas a sus servicios desde los scripts de los valores controlados se asocian a su servicio y se muestran en la página de detalles del servicio.
+ [Monitoreo de usuarios reales (RUM) de CloudWatch](CloudWatch-RUM.md): cuando el rastreo de rayos X está activado en el cliente web RUM de CloudWatch RUM, las solicitudes a los servicios se asocian de manera automática y se muestran en la página de detalles del servicio.
+ [AWS Service Catalog AppRegistry](https://docs.aws.amazon.com/servicecatalog/latest/arguide/intro-app-registry.html): Application Signals descubre automáticamente los recursos de AWS de su cuenta y le permite agruparlos en aplicaciones lógicas creadas en AppRegistry. El nombre de la aplicación que aparece en la página de servicios se basa en el recurso informático subyacente en el que se ejecutan los servicios.
**nota**
Application Signals muestra los servicios y operaciones en función de las métricas y los seguimientos emitidos en el filtro de tiempo actual que haya elegido. (De forma predeterminada, son las últimas tres horas). Si no hay actividad en el filtro de tiempo actual para un servicio, operación, dependencia, valor controlado de Synthetics o página de cliente, no se mostrará.
Se pueden mostrar hasta 1000 servicios. La detección de los servicios y su topología puede demorar hasta 10 minutos. La evaluación del estado del indicador de servicio (SLI) puede demorar hasta 15 minutos.
**nota**
La consola de Application Signals actualmente solo admite la elección de un máximo de un día dentro del rango de 30 días.
# Visualización de la actividad general del servicio y el estado operativo en la página del Servicio
Utilice la página Servicios para ver una lista de los servicios que están [habilitados para Application Signals](CloudWatch-Application-Signals-Enable.md). También puede consultar las métricas operativas y ver rápidamente qué servicios tienen indicadores de nivel de servicio (SLI) incorrectos. Desplácese hacia abajo para detectar anomalías de rendimiento a medida que identifica la causa raíz de los problemas operativos. Para ver esta página, abra la [consola de CloudWatch](https://console.aws.amazon.com/cloudwatch/) y elija **Servicios** en la sección **Application Signals** del panel de navegación izquierdo.
En el caso de los servicios no instrumentados, la página Información general del servicio muestra información limitada con llamadas a la acción destacadas para activar la instrumentación de Application Signals.
## Exploración de las métricas de estado operativo de sus servicios
La parte superior de la página Servicios incluye un gráfico general del estado operativo del servicio y varias tablas que muestran los principales servicios y dependencias de los servicios por tasa de fallos y lista de servicios. El gráfico de servicios de la izquierda muestra un desglose del número de servicios que tienen indicadores de nivel de servicio (SLI) correctos e incorrectos durante el filtro de tiempo actual a nivel de página. Los SLI pueden monitorear la latencia, la disponibilidad y otras métricas operativas. Consulte los principales servicios por tasa de fallos en las dos tablas situadas junto al gráfico. Seleccione un nombre de servicio en cualquiera de las tablas para abrir su [página de detalles del servicio](ServiceDetail.md), que muestra información de la operación del servicio. Seleccione una ruta de dependencia para ver los detalles de la dependencia del servicio en su página de detalles.
Ambas tablas muestran información de las últimas tres horas, incluso si se selecciona un filtro de períodos de tiempo más largos en la parte superior derecha de la página.
Al utilizar la agrupación dinámica de servicios, las métricas de estado operativo agregan automáticamente los datos de todos los servicios de cada grupo. Esto proporciona lo siguiente:
+ Tasas de fallos consolidados para grupos de servicios
+ Estado del SLI por grupo
+ Métricas de rendimiento agregadas que ayudan a identificar los clústeres de servicios problemáticos
+ Identificación rápida de los grupos que requieren atención inmediata durante los incidentes
![\[Gráficos principales de CloudWatch Services\]](http://docs.aws.amazon.com/es_es/AmazonCloudWatch/latest/monitoring/images/services-top-graphs.png)
## Supervisión del estado operativo con la tabla Servicios
La tabla Servicios muestra una lista de los servicios que se han activado para Application Signals. Elija **Habilitar Application Signals** para abrir una página de configuración y empezar a configurar los servicios. Para obtener más información, consulte [Habilitar Application Signals](CloudWatch-Application-Signals-Enable.md).
Para que le resulte más fácil encontrar lo que busca, filtre la tabla Servicios al seleccionar una o más propiedades del cuadro de texto del filtro. Al elegir cada propiedad, se lo guiará por los criterios del filtro. Verá el filtro completo debajo del cuadro de texto del filtro. Elija **Borrar filtros** en cualquier momento para eliminar el filtro de la tabla.
Las opciones de filtrado avanzadas le permiten hacer lo siguiente:
+ Filtrar por grupos de servicios (agrupaciones predeterminadas y personalizadas)
+ Filtrar por actividad de implementación reciente
+ Filtrar por plataforma
+ Filtrar por estado del SLI
+ Filtrar por ID de cuenta (en configuraciones de observabilidad entre cuentas)
+ Filtrar por estado de instrumentación (instrumentado o no instrumentado)
+ Filtrar por entorno
+ Filtrar por estado del servicio
![\[Tabla de CloudWatch Services\]](http://docs.aws.amazon.com/es_es/AmazonCloudWatch/latest/monitoring/images/services-table-healthy-updated.png)
En el caso de los servicios no instrumentados, la página Información general del servicio muestra información limitada con llamadas a la acción destacadas para activar la instrumentación de Application Signals. Los servicios no instrumentados aparecen en la tabla Servicios incluso cuando no se han configurado con Application Signals, lo que le permite identificar las deficiencias en la cobertura de observabilidad y priorizar los siguientes servicios que se deben instrumentar en función de su posición en la arquitectura.
Elija el nombre de cualquier servicio de la tabla para ver una [página de detalles del servicio](ServiceDetail.md) que contiene métricas de nivel de servicio, operaciones y detalles adicionales. Si ha asociado el recurso informático subyacente del servicio a una aplicación de AppRegistry o a la tarjeta Aplicaciones de la página de inicio de la Consola de administración de AWS, elija el nombre de la aplicación para mostrar los detalles de la aplicación en la página de la consola de [myApplications.](https://docs.aws.amazon.com/awsconsolehelpdocs/latest/gsg/aws-myApplications.html) En el caso de los servicios alojados en Amazon EKS, elija cualquier enlace de la columna **Alojado en** para ver el clúster, el espacio de nombres o la carga de trabajo en Información de contenedores de CloudWatch. Para los servicios que se ejecutan en Amazon ECS o Amazon EC2, se muestra el valor Entorno.
Se muestra el estado del [Indicador de nivel de servicio (SLI)](CloudWatch-ServiceLevelObjectives.md#CloudWatch-ServiceLevelObjectives-concepts) para cada servicio de la tabla. Elija el estado del SLI de un servicio para que aparezca una ventana emergente con un enlace a los SLI incorrectos y un enlace para ver todos los SLO del servicio.
![\[Servicios con SLI incorrectos\]](http://docs.aws.amazon.com/es_es/AmazonCloudWatch/latest/monitoring/images/services-unhealthy-sli.png)
Si no se ha creado ningún SLO para un servicio, elija el botón **Crear SLO** en la columna **Estado del SLI**. Para crear SLO adicionales para cualquier servicio, seleccione el botón de opción situado junto al nombre del servicio y, a continuación, elija **Crear SLO** en la parte superior derecha de la tabla. Al crear los SLO, puede ver de inmediato cuáles de sus servicios y operaciones funcionan de forma correcta y cuáles no. Para obtener más información, consulte [Objetivos de nivel de servicio (SLO)](CloudWatch-ServiceLevelObjectives.md).
## Información general del servicio
Tras seleccionar un servicio en la tabla Servicios, se abre la página Información general del servicio. Esta página proporciona una vista completa de las métricas de estado y rendimiento del servicio. En la información general, se muestran las siguientes métricas resumidas:
+ Total de operaciones
+ Dependencias de servicios
+ Estado de seguimiento del canario
+ Datos del cliente de RUM
Estas métricas le proporcionan información inmediata del estado actual del servicio.
Puede ver los indicadores clave del rendimiento operativo a lo largo del tiempo mediante una serie de gráficos. Para analizar las tendencias e identificar los posibles problemas que afecten al estado del servicio, ajuste el filtro de tiempo. Todos los gráficos se actualizan automáticamente para reflejar los datos del periodo de tiempo seleccionado.
La sección Resultados de la auditoría detecta y muestra automáticamente los problemas críticos en el comportamiento del servicio, por lo que no es necesario que los investigue manualmente. Application Signals analiza las aplicaciones para informar sobre observaciones importantes y los posibles problemas, lo que simplifica el análisis de las causas raíz. Estos resultados automatizados consolidan los rastros pertinentes, lo que elimina la necesidad de navegar con varios clics. El sistema de auditoría ayuda a los equipos a identificar rápidamente los problemas y sus causas subyacentes, lo que permite una resolución más rápida de los problemas.
Puede utilizar la sección Eventos de cambios para identificar cómo afectan las implementaciones o los cambios de configuración recientes al comportamiento del servicio. Application Signals procesa automáticamente los eventos de CloudTrail para hacer un seguimiento de los cambios en toda la aplicación. Supervise los eventos de configuración e implementación de los servicios y las dependencias, lo que proporciona un contexto inmediato para el análisis operativo y la solución de problemas. Application Signals correlaciona automáticamente los tiempos de implementación con los cambios en el rendimiento, lo que le permite identificar rápidamente si las implementaciones recientes contribuyeron a los problemas del servicio.
![\[Información general del servicio\]](http://docs.aws.amazon.com/es_es/AmazonCloudWatch/latest/monitoring/images/Service_detail.png)
# Visualización de la actividad detallada del servicio y el estado operativo en la página de detalles del servicio
Al instrumentar la aplicación, [Amazon CloudWatch Application Signals](CloudWatch-Application-Monitoring-Sections.md) asigna todos los servicios que descubre la aplicación. Utilice la página de detalles del servicio para ver una descripción general de sus servicios, las operaciones, dependencias, canarios y solicitudes de los clientes para un solo servicio. Para ver la página de detalles del servicio, haga lo siguiente:
+ [Abra la consola de CloudWatch](https://console.aws.amazon.com/cloudwatch/).
+ Elija **Servicios** en la sección **Application Signals** del panel de navegación izquierdo.
+ Elija el nombre de cualquier servicio desde **Servicios**, **Servicios principales** o de las tablas de dependencias.
Bajo **schedule-visits**, verá la etiqueta de cuenta y el ID bajo el nombre del servicio.
La página de detalles del servicio se organiza en las siguientes pestañas:
+ [Descripción general](#ServiceDetail-overview): utilice esta pestaña para ver una descripción general de un solo servicio, incluida la cantidad de operaciones, las dependencias, los datos sintéticos y las páginas de clientes. La pestaña muestra las métricas clave de todo el servicio, las principales operaciones y las dependencias. Estas métricas incluyen datos de series temporales sobre la latencia, las fallas y los errores en todas las operaciones de servicio para ese servicio.
+ [Operaciones de servicio](#ServiceDetail-operations): use esta pestaña para ver una lista de las operaciones a las que llama su servicio y gráficos interactivos con las métricas clave que miden el estado de cada operación. Puede seleccionar un punto de datos en un gráfico para obtener información sobre los seguimientos, los registros o las métricas asociadas a ese punto de datos.
+ [Dependencias](#ServiceDetail-dependencies): use esta pestaña para ver una lista de las dependencias a las que llama su servicio y una lista de métricas de esas dependencias.
+ [Canarios de Synthetics](#ServiceDetail-canaries): use esta pestaña para ver una lista de canarios de Synthetics que simulan las llamadas de los usuarios a su servicio y las métricas de rendimiento clave para ver cómo funcionan esos canarios.
+ [Páginas de clientes](#ServiceDetail-clientpages): use esta pestaña para ver una lista de las páginas de clientes que llaman a su servicio y las métricas que miden la calidad de las interacciones de los clientes con su aplicación.
+ [Métricas relacionadas](#ServiceDetail-relatedmetrics): utilice esta pestaña para correlacionar las métricas relacionadas, como las métricas estándar, las métricas de tiempo de ejecución y las métricas personalizadas de un servicio, sus operaciones o sus dependencias.
## Visualización de la descripción general de su servicio
Utilice la página de descripción general del servicio para ver un resumen detallado de las métricas de todas las operaciones de servicio en una única ubicación. Compruebe el rendimiento de todas las operaciones, dependencias, páginas de clientes y canarios de Synthetics que interactúan con su aplicación. Utilice esta información como ayuda para determinar dónde concentrar los esfuerzos para identificar problemas, solucionar errores y encontrar oportunidades de optimización.
Elija cualquier enlace en **Detalles del servicio** para ver la información relacionada con un servicio específico. Por ejemplo, en el caso de los servicios alojados en Amazon EKS, la página de detalles del servicio muestra información sobre el **clúster**, el **espacio de nombres** y la **carga de trabajo**. Para los servicios alojados en Amazon ECS o Amazon EC2, la página de detalles del servicio muestra el valor del **entorno**.
En **Servicios**, la pestaña **Descripción general** muestra un resumen de lo siguiente:
+ Operaciones: utilice esta pestaña para ver el estado de las operaciones de servicio. El estado está determinado por los indicadores de nivel de servicio (SLI), que se definen como parte de un [objetivo de nivel de servicio](CloudWatch-ServiceLevelObjectives.md) (SLO).
+ Dependencias: utilice esta pestaña para ver las principales dependencias de los servicios a los que llama su aplicación, ordenadas por tasa de fallos, y para ver el estado de las dependencias de sus servicios. El estado está determinado por los indicadores de nivel de servicio (SLI), que se definen como parte de un objetivo de nivel de servicio (SLO).
+ Canarios de Synthetics: utilice esta pestaña para ver el resultado de las llamadas simuladas a puntos de conexión o API asociadas a su servicio y el número de canarios fallidos.
+ Páginas de clientes: utilice esta pestaña para ver las páginas principales a las que llaman los clientes que tienen errores asíncronos de JavaScript y XML (AJAX).
La siguiente ilustración muestra una descripción general de los servicios:
![\[Widgets de descripción general del servicio\]](http://docs.aws.amazon.com/es_es/AmazonCloudWatch/latest/monitoring/images/service-detail-widgets.png)
La pestaña **Descripción general** también muestra un gráfico de las dependencias con la latencia más alta en todos los servicios. Utilice las métricas de latencia **p99**, **p90** y **p50** para evaluar rápidamente qué dependencias contribuyen a la latencia total del servicio, de la siguiente manera:
![\[Gráfico de latencia de las operaciones de servicio\]](http://docs.aws.amazon.com/es_es/AmazonCloudWatch/latest/monitoring/images/service-detail-latency.png)
Por ejemplo, el gráfico anterior muestra que el 99 % de las solicitudes realizadas a la dependencia **customer-service** se completaron en aproximadamente 4950 milisegundos. Las demás dependencias tardaron menos tiempo.
Los gráficos que muestran las cuatro operaciones de servicio principales por latencia muestran el volumen de solicitudes, la disponibilidad, la tasa de fallos y la tasa de errores de esos servicios, como se muestra en la siguiente imagen:
![\[Gráficos de volumen de operaciones de servicio, disponibilidad, tasa de fallas y tasa de errores\]](http://docs.aws.amazon.com/es_es/AmazonCloudWatch/latest/monitoring/images/service-detail-operations-graphs.png)
La sección **Detalles del servicio** muestra los detalles del servicio, como el **ID de la cuenta** y la **Etiqueta de la cuenta**.
## Visualización de las operaciones de servicio
Al instrumentar la aplicación, [Application Signals](CloudWatch-Application-Monitoring-Sections.md) descubre todas las operaciones de servicio a las que llama la aplicación. Utilice la pestaña **Operaciones del servicio** para ver una tabla que contiene las operaciones del servicio y un conjunto de métricas que miden el rendimiento de una operación seleccionada. Estas métricas incluyen el estado del indicador de nivel de servicio (SLI), el número de dependencias, la latencia, el volumen, los fallos, los errores y la disponibilidad, como se muestra en la siguiente imagen:
![\[Tabla de operaciones de servicio\]](http://docs.aws.amazon.com/es_es/AmazonCloudWatch/latest/monitoring/images/service-operations-table.png)
Filtre la tabla para que le resulte más fácil encontrar una operación de servicio al seleccionar una o más propiedades del cuadro de texto del filtro. Al elegir cada propiedad, se lo guiará por los criterios de filtro y verá el filtro completo debajo del cuadro de texto del filtro. Elija **Borrar filtros** en cualquier momento para eliminar el filtro de la tabla.
Elija el estado del SLI para una operación para mostrar una ventana emergente que contiene un vínculo a cualquier SLI en mal estado y un vínculo para ver todos los SLO de la operación, como se muestra en la siguiente tabla:
![\[Estado del SLI de la operación de servicio\]](http://docs.aws.amazon.com/es_es/AmazonCloudWatch/latest/monitoring/images/service-operation-unhealthy-slo.png)
La tabla de operaciones del servicio muestra el estado del SLI, el número de SLI en buen estado o en mal estado y el número total de SLO para cada operación.
Utilice los SLI para supervisar la latencia, la disponibilidad y otras métricas operativas que miden el estado operativo de un servicio. Utilice un SLO para comprobar el rendimiento y el estado de sus servicios y operaciones.
Para crear un SLO, realice el siguiente procedimiento:
+ Si una operación no tiene ningún SLO, elija el botón **Crear SLO** en la columna **Estado del SLI**.
+ Si una operación ya tiene un SLO, haga lo siguiente:
+ Seleccione el botón de opción situado junto al nombre de la operación.
+ Seleccione **Crear SLO** en la flecha desplegable **Acciones** situada en la parte superior derecha de la tabla.
Para obtener más información, consulte [Objetivos de nivel de servicio (SLO)](CloudWatch-ServiceLevelObjectives.md).
La columna **Dependencias** muestra el número de dependencias a las que llama esta operación. Elija este número para abrir la pestaña **Dependencias** filtrada según la operación seleccionada.
### Visualización de métricas de operaciones de servicio, seguimientos correlacionados y registros de aplicaciones
Application Signals correlaciona las métricas de operación de servicio con los seguimientos de AWS X-Ray, CloudWatch [Container Insights](ContainerInsights.md) y los registros de las aplicaciones. Utilice estas métricas para solucionar problemas de estado operativo. Para ver las métricas como información gráfica, haga lo siguiente:
1. Elija una opción de servicio en la tabla **Operaciones de servicio** para ver un conjunto de gráficos para la operación seleccionada encima de la tabla con métricas de **volumen y disponibilidad**, **latencia** y **fallas y errores**.
1. Coloque el cursor sobre un punto en un gráfico para ver más información.
1. Seleccione un punto para abrir un panel de diagnóstico que muestra seguimientos, métricas y registros de aplicaciones correlacionados para el punto seleccionado en el gráfico.
La siguiente imagen muestra la información sobre herramientas que aparece después de pasar el ratón sobre un punto del gráfico y el panel de diagnóstico que aparece al hacer clic en un punto. La información sobre herramientas contiene información sobre el punto de datos asociado en el gráfico de **fallas y errores**. El panel contiene los **seguimientos correlacionados**, los **colaboradores principales** y los **registros de aplicaciones** asociados al punto seleccionado.
![\[Seguimientos correlacionados de fallos y errores\]](http://docs.aws.amazon.com/es_es/AmazonCloudWatch/latest/monitoring/images/service-detail-correlated-traces.png)
#### Seguimientos correlacionados
Observe los seguimientos relacionados para comprender un problema subyacente con un seguimiento. Puede comprobar si los seguimientos correlacionados o cualquier nodo de servicio asociado a ellos se comportan de forma similar. Para examinar los seguimientos correlacionados, elija un **ID de seguimiento** de la tabla **Seguimientos correlacionados** para abrir la página [Detalles del seguimiento de X-Ray](https://docs.aws.amazon.com/xray/latest/devguide/xray-console-traces.html) para el seguimiento elegido. La página de detalles del seguimiento contiene un mapa de nodos de servicio asociados con el seguimiento seleccionado y una línea de tiempo de los segmentos del seguimiento.
#### Colaboradores principales
Consulte los principales colaboradores para encontrar las principales fuentes de entrada a una métrica. Agrupe a los colaboradores por diferentes componentes para buscar similitudes dentro del grupo y comprender en qué se diferencia el comportamiento de seguimiento entre ellos.
En la pestaña **Colaboradores principales** se muestran las métricas de **Volumen de llamadas**, **Disponibilidad**, **Latencia promedio**, **Errores** y **Fallas** de cada grupo. La siguiente imagen de ejemplo muestra los principales colaboradores a un conjunto de métricas para una aplicación implementada en una plataforma Amazon EKS:
![\[Colaboradores principales de la operación de servicio\]](http://docs.aws.amazon.com/es_es/AmazonCloudWatch/latest/monitoring/images/service-operations-top-contributors.png)
Los principales colaboradores contienen las siguientes métricas:
+ **Volumen de llamadas**: utilice el volumen de llamadas para conocer el número de solicitudes por intervalo de tiempo de un grupo.
+ **Disponibilidad**: utilice la disponibilidad para ver el porcentaje de tiempo que no se detectó ningún error en un grupo.
+ **Latencia media**: utilice la latencia para comprobar el tiempo medio durante el que se enviaron las solicitudes de un grupo durante un intervalo de tiempo que depende de cuánto tiempo hace que se hicieron las solicitudes que está investigando. Las solicitudes que se realizaron menos de 15 días antes se evalúan en intervalos de 1 minuto. Las solicitudes que se realizaron entre 15 y 30 días antes, inclusive, se evalúan en intervalos de 5 minutos. Por ejemplo, si está investigando las solicitudes que provocaron un error hace 15 días, la métrica del volumen de llamadas es igual al número de solicitudes por intervalo de 5 minutos.
+ **Errores**: el número de errores por grupo medidos durante un intervalo de tiempo.
+ **Fallos**: el número de fallos por grupo durante un intervalo de tiempo.
**Colaboradores principales que utilizan Amazon EKS o Kubernetes**
Utilice información acerca de los colaboradores principales para aplicaciones implementadas en Amazon EKS o Kubernetes para ver las métricas de estado operativo agrupadas por **Nodo**, **Pod** y **PodTemplateHash**. Se aplican las siguientes definiciones:
+ Un **pod** es un grupo de uno o más contenedores de Docker que comparten almacenamiento y recursos. Un pod es la unidad más pequeña que se puede implementar en una plataforma de Kubernetes. Agrupe por pods para comprobar si los errores están relacionados con limitaciones específicas del pod.
+ Un **nodo** es un servidor que ejecuta pods. Agrupe por nodos para comprobar si los errores están relacionados con limitaciones específicas del nodo.
+ El **hash de una plantilla de pod** se utiliza para buscar una versión concreta de una implementación. Agrupe por hash de plantilla de pod para comprobar si los errores están relacionados con una implementación en particular.
**Principales colaboradores que utilizan Amazon EC2**
Utilice la información sobre los principales colaboradores para aplicaciones implementadas en Amazon EKS para ver las métricas de estado operativo agrupadas por ID de instancia y grupo de escalado automático. Se aplican las siguientes definiciones:
+ Un **ID de instancia** es un identificador único de la instancia de Amazon EC2 que ejecuta su servicio. Agrupe por ID de instancia para comprobar si los errores están relacionados con una instancia de Amazon EC2 específica.
+ Un [grupo de escalado automático](https://docs.aws.amazon.com/autoscaling/ec2/userguide/auto-scaling-groups.html) es un conjunto de instancias de Amazon EC2 que le permiten escalar o reducir verticalmente los recursos que necesita para atender las solicitudes de sus aplicaciones. Agrupe por grupo de escalado automático si quiere comprobar si el alcance de los errores se limita a las instancias del grupo.
**Principales colaboradores que utilizan una plataforma personalizada**
Utilice la información sobre los principales colaboradores para aplicaciones implementadas con instrumentación personalizada para ver las métricas del estado operativo agrupadas por **nombre de host**. Se aplican las siguientes definiciones:
+ Un nombre de host identifica un dispositivo, como un punto de conexión o una instancia de Amazon EC2, que está conectado a una red. Agrupe por nombre de host para comprobar si los errores están relacionados con un dispositivo físico o virtual específico.
**Visualización de los principales colaboradores en Log Insights y Container Insights**
Vea y modifique la consulta automática que generó las métricas para sus principales colaboradores en [Información de registros](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AnalyzingLogData.html). Vea las métricas de rendimiento de la infraestructura por grupos específicos, como pods o nodos, en [Información de contenedores](ContainerInsights.md). Puede ordenar los clústeres, los nodos o las cargas de trabajo por consumo de recursos e identificar rápidamente las anomalías o mitigar los riesgos de forma proactiva antes de que la experiencia del usuario final se vea afectada. A continuación, se muestra una imagen que muestra cómo seleccionar estas opciones:
![\[Tabla de los colaboradores principales\]](http://docs.aws.amazon.com/es_es/AmazonCloudWatch/latest/monitoring/images/service-operations-top-contributors-insights.png)
En **Información de contenedores**, puede ver las métricas de su contenedor de Amazon EKS o Amazon ECS que son específicas de la agrupación de sus principales colaboradores. Por ejemplo, si ha agrupado un contenedor de EKS por grupo para generar los principales colaboradores, la información sobre el contenedor mostrará las métricas y estadísticas filtradas para su pod.
En **Información de registros**, puede modificar la consulta que generó las métricas en **Colaboradores principales** siguiendo estos pasos:
1. Seleccione **Ver en Información de registros**. La página **Información de registros** que se abre contiene una consulta que se genera automáticamente y contiene la siguiente información:
+ El nombre del grupo de clústeres de registros.
+ La operación que estaba investigando con CloudWatch.
+ El agregado de la métrica de estado operativo con la que interactuó en el gráfico.
Los resultados del registro se filtran automáticamente para mostrar los datos de los últimos cinco minutos antes de seleccionar el punto de datos en el gráfico de servicio.
1. Para editar la consulta, sustituya el texto generado por sus cambios. También puede usar el **Generador de consultas** como ayuda para generar una consulta nueva o actualizar la consulta existente.
#### Registros de aplicaciones
Utilice la consulta de la pestaña **Registros de aplicaciones** para generar información registrada para su grupo de registros y servicio actuales e inserte una marca de tiempo. Un grupo de registro es un grupo de flujos de registro que puede definir al configurar la aplicación.
Utilice un grupo de registros para organizar los registros con características similares, incluidas las siguientes:
+ Capture los registros de una organización, fuente o función específicas.
+ Capture los registros a los que accede un usuario en particular.
+ Capture registros para un periodo de tiempo específico.
Utilice estos flujos de registro para realizar un seguimiento de grupos o períodos de tiempo específicos. También puede configurar reglas de supervisión, alarmas y notificaciones para estos grupos de registros. Para obtener información general acerca de los grupos de registros, consulte [Working with log groups and log streams](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/Working-with-log-groups-and-streams.html).
La consulta de registros de la aplicación devuelve los registros, los patrones de texto recurrentes y las visualizaciones gráficas de sus grupos de registros.
Para ejecutar la consulta, seleccione **Ejecutar consulta en Información de registros** para ejecutar la consulta generada automáticamente o modificarla. Para editar la consulta, sustituya el texto generado automáticamente por sus cambios. También puede usar el **Generador de consultas** como ayuda para generar una consulta nueva o actualizar la consulta existente.
La siguiente imagen muestra la consulta de ejemplo que se genera automáticamente en función del punto seleccionado en el gráfico de operaciones del servicio:
![\[Tabla de registros de aplicaciones\]](http://docs.aws.amazon.com/es_es/AmazonCloudWatch/latest/monitoring/images/service-operations-application-logs.png)
En la imagen anterior, CloudWatch detectó automáticamente el grupo de registro asociado al punto seleccionado y lo incluyó en una consulta generada.
## Visualización de las dependencias de servicio
Elija la pestaña **Dependencias** para ver la tabla de **Dependencias** y un conjunto de métricas para las dependencias de todas las operaciones del servicio o de una sola operación. La tabla contiene una lista de las dependencias detectadas por Application Signals, incluidas las métricas del estado del SLI, latencia, volumen de llamadas, tasa de fallos, tasa de errores y disponibilidad.
En la parte superior de la página, elija una operación de la lista desplegable para ver sus dependencias o elija **Todo** para ver las dependencias de todas las operaciones.
Filtre la tabla para que le resulte más fácil encontrar lo que busca, al seleccionar una o más propiedades del cuadro de texto del filtro. Al elegir cada propiedad, se lo guiará por los criterios de filtro y verá el filtro completo debajo del cuadro de texto del filtro. Elija **Borrar filtros** en cualquier momento para eliminar el filtro de la tabla. Seleccione **Agrupar por dependencia** en la parte superior derecha de la tabla para agrupar las dependencias por nombre de servicio y operación. Cuando la agrupación esté activada, expanda o contraiga un grupo de dependencias con el icono **\$1** situado junto al nombre de la dependencia.
![\[Tabla de dependencias\]](http://docs.aws.amazon.com/es_es/AmazonCloudWatch/latest/monitoring/images/service-dependencies-table.png)
La columna **Dependencia** muestra el nombre del servicio de dependencia, mientras que la columna **Operación remota** muestra el nombre de la operación del servicio. En la columna **Estado del SLI** se muestra el número de SLI en buen estado o en mal estado junto con el número total de SLI para cada dependencia. Al llamar a los servicios de AWS, la columna **Destino** muestra el recurso de AWS, como una tabla de DynamoDB o una cola de Amazon SNS.
Para seleccionar una dependencia, seleccione la opción situada junto a una dependencia en la tabla de **Dependencias.** Esto muestra un conjunto de gráficos que muestran métricas detalladas de volumen de llamadas, disponibilidad, fallas y errores. Coloque el cursor sobre un punto en un gráfico para ver una ventana emergente con más información. Seleccione un punto de un gráfico para abrir un panel de diagnóstico que muestre los seguimientos correlacionados del punto seleccionado en el gráfico. Elija un ID de seguimiento de la tabla **Seguimientos correlacionados** para abrir la página [Detalles del seguimiento de X-Ray](https://docs.aws.amazon.com/xray/latest/devguide/xray-console-traces.html) para el seguimiento elegido.
![\[Gráficos de dependencia y seguimientos correlacionados\]](http://docs.aws.amazon.com/es_es/AmazonCloudWatch/latest/monitoring/images/service-dependency-graph-traces.jpg)
## Visualización de los valores controlados de Synthetics
Seleccione la pestaña **Valores controlados de Synthetics** para ver la tabla **Valores controlados de Synthetics** y un conjunto de métricas para cada valor controlado de la tabla. La tabla incluye métricas del porcentaje de éxito, la duración promedio, las ejecuciones y la tasa de fallos. Solo se muestran los valores controlados que están [habilitados para el seguimiento de AWS X-Ray](CloudWatch_Synthetics_Canaries_tracing.md).
Utilice el cuadro de texto del filtro de la tabla de canarios de Synthetics para encontrar el canario que le interese. Cada filtro que crea aparece debajo del cuadro de texto del filtro. Elija **Borrar filtros** en cualquier momento para eliminar el filtro de la tabla.
![\[Tabla de valores controlados de Synthetics\]](http://docs.aws.amazon.com/es_es/AmazonCloudWatch/latest/monitoring/images/service-canaries-table.png)
Seleccione el botón de radio situado junto al nombre del canario para ver un conjunto de pestañas que contienen métricas detalladas con gráficos, como el porcentaje de éxito, los errores y la duración. Coloque el cursor sobre un punto en un gráfico para ver una ventana emergente con más información. Seleccione un punto de un gráfico para abrir un panel de diagnóstico que muestre las ejecuciones de canario que se correlacionan con el punto seleccionado. Seleccione una ejecución de canario y elija el **tiempo de ejecución** para ver los artefactos de la ejecución de canario que seleccionó, incluidos los registros, los archivos HTTP (HAR), las capturas de pantalla y los pasos sugeridos para ayudarlo a solucionar problemas. Seleccione **Más información** para abrir la página [Canarios de CloudWatch Synthetics](CloudWatch_Synthetics_Canaries.md) junto a **Ejecuciones de canarios**.
![\[Ejecuciones y gráficos del valor controlado de Synthetics\]](http://docs.aws.amazon.com/es_es/AmazonCloudWatch/latest/monitoring/images/service-canary-graphs-runs.jpg)
## Visualización de las páginas de sus clientes
Seleccione la pestaña **Páginas de clientes** para ver una lista de las páginas web de clientes que llaman a su servicio. Utilice el conjunto de métricas de la página de cliente seleccionada para medir la calidad de la experiencia de su cliente al interactuar con un servicio o una aplicación. Estas métricas incluyen las cargas de página, las métricas esenciales de la web y los errores.
Para mostrar las páginas de sus clientes en la tabla, debe [configurar su cliente web de CloudWatch RUM para el seguimiento de X-Ray](CloudWatch-RUM-get-started-create-app-monitor.md) y activar las métricas de Application Signals para las páginas de los clientes. Elija **Administrar páginas** para seleccionar qué páginas están habilitadas para las métricas de Application Signals.
Utilice el cuadro de texto del filtro para buscar la página del cliente o el monitor de aplicaciones que le interese debajo del cuadro de texto del filtro. Elija **Borrar filtros** para eliminar el filtro de la tabla. Seleccione **Agrupar por cliente** para agrupar las páginas de los clientes por cliente. Cuando estén agrupadas, seleccione el icono **\$1** situado junto al nombre del cliente para expandir la fila y ver todas las páginas de ese cliente.
![\[Tabla de páginas de clientes\]](http://docs.aws.amazon.com/es_es/AmazonCloudWatch/latest/monitoring/images/service-client-pages-table.png)
Para seleccionar una página de cliente, seleccione la opción situada junto a una página del cliente en la tabla **Páginas de clientes**. Verá un conjunto de gráficos que muestran métricas detalladas. Coloque el cursor sobre un punto en un gráfico para ver una ventana emergente con más información. Seleccione un punto de un gráfico para abrir un panel de diagnóstico que muestre los eventos de navegación de rendimiento correlacionados del punto seleccionado en el gráfico. Elija un ID de evento de la lista de eventos de navegación para abrir la [vista de la página de CloudWatch RUM](CloudWatch-RUM-view-data.md) para el evento elegido.
![\[Solicitudes de las páginas de clientes de CloudWatch RUM\]](http://docs.aws.amazon.com/es_es/AmazonCloudWatch/latest/monitoring/images/service-client-page-graphs-events.jpg)
**nota**
Para ver los errores AJAX en las páginas de sus clientes, utilice la versión 1.15 de [cliente web de CloudWatch RUM](CloudWatch-RUM-configure-client.md) o posterior.
Se pueden mostrar hasta 100 operaciones, canarios y páginas de clientes, y hasta 250 dependencias por servicio.
## Visualización de métricas relacionadas
Use la pestaña Métricas relacionadas para ver varias métricas, identificar los patrones de correlación y determinar las causas raíz de los problemas.
La tabla de métricas muestra tres tipos de métricas:
+ Métricas estándar: Application Signals recopila métricas de aplicaciones estándar a partir de los servicios que detecta. Para obtener más información, consulte [Recopilación de métricas de aplicaciones estándar](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/AppSignals-MetricsCollected.html#AppSignals-StandardMetrics).
+ Métricas de tiempo de ejecución: Application Signals utiliza el SDK de AWS Distro para OpenTelemetry para recopilar automáticamente métricas compatibles con OpenTelemetry de las aplicaciones en Java y Python. Para obtener más información, consulte [Métricas de tiempo de ejecución](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/AppSignals-MetricsCollected.html#AppSignals-RuntimeMetrics).
+ Métricas personalizadas: Application Signals le permite generar métricas personalizadas a partir de su aplicación. Para obtener más información, consulte [Métricas personalizadas con Application Signals](AppSignals-CustomMetrics.md)
Puede acceder a la pestaña Métricas relacionadas desde las pestañas Descripción general del servicio, Operaciones de servicio, Dependencias, Canarios de Synthetics o RUM.
![\[Visualización de métricas relacionadas\]](http://docs.aws.amazon.com/es_es/AmazonCloudWatch/latest/monitoring/images/Custom_metrics.png)
+ El panel de navegación izquierdo comienza con todas las operaciones y dependencias sin seleccionar.
+ El gráfico muestra inicialmente la métrica de errores de la operación con la tasa de errores más alta.
Antes de comenzar el análisis de correlación, asegúrese de que los puntos de datos se puedan ver en Operaciones de servicio o Dependencias. Para analizar las correlaciones, haga lo siguiente:
1. Abra la página Operaciones de servicio o Dependencias.
1. Seleccione un punto de datos en cualquier gráfico.
1. En el panel derecho, elija **Correlacionar con otras métricas**.
1. En la pestaña **Métricas relacionadas** que se abre, verá lo siguiente:
+ La operación o dependencia seleccionada en el menú de navegación de la izquierda
+ La métrica seleccionada que se muestra en un gráfico en la tabla *Examinar las métricas*
+ Intervalos correlacionados al seleccionar un punto de datos
Para incluir varias métricas en un gráfico, seleccione una o más métricas en la vista **Explorar** de la pestaña **Métricas relacionadas**. Elija **Métricas diagramadas** para ver todas las métricas incluidas en gráficos.
Para filtrar las métricas, utilice los filtros del panel izquierdo para centrarse en operaciones o dependencias específicas y utilice la barra de filtros del encabezado de la tabla para buscar por nombre, tipo u otros atributos. Estas opciones de filtrado le ayudan a detectar patrones y solucionar problemas de forma más eficaz.
Para analizar las métricas relacionadas en detalle, seleccione un punto de datos en la pestaña **Métricas relacionadas**. A continuación, puede ver lo siguiente:
+ Colaboradores principales: analiza métricas mediante la ejecución de consultas de Información de registros de CloudWatch. Estas consultas procesan los registros del formato de métricas mejorado (EMF) que contienen atributos clave para un análisis detallado de los siguientes aspectos:
+ Mediciones de latencia
+ Incidencias de errores
+ Métricas de disponibilidad de servicio
Las métricas siguientes no admiten colaboradores principales:
+ Métricas de OTEL
+ Métricas de intervalos en el servidor
Puede ver los colaboradores principales de Métricas de RED y Métricas de intervalos en el cliente.
+ Intervalos correlacionados: la sección Intervalos correlacionados funciona de forma coherente con la pestaña Operaciones de servicio. Para ayudarle a identificar los seguimientos y métricas relacionadas, el mecanismo de correlación funciona de la siguiente manera:
+ Compara los nombres de las métricas con los atributos de intervalo.
+ Identifica los patrones coincidentes durante el periodo de tiempo seleccionado.
+ Muestra información de seguimiento relevante.
Para analizar de forma eficaz las métricas y los intervalos a la vez, debe comprender cómo se correlacionan los distintos tipos de métricas. Estas son las limitaciones clave:
+ Las métricas de OTEL no se correlacionan con los intervalos porque utilizan sistemas de nomenclatura independientes.
+ Para correlacionar las métricas de intervalo en el servidor o en el cliente con los intervalos:
+ Incluya un campo de dimensión del servicio en su configuración.
+ Sin esta dimensión de servicio, no puede correlacionar estas métricas con los intervalos.
+ Registrar aplicaciones: para obtener información sobre cómo registrar una aplicación, consulte [Registros de aplicaciones](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/ServiceDetail.html#ServiceDetail-operations).
# Visualización de la topología de la aplicación y supervisión del estado operativo con la asignación de aplicaciones de CloudWatch
**nota**
La asignación de aplicaciones de CloudWatch sustituye la asignación de servicios. Para ver un mapa de su aplicación basado en seguimientos de AWS X-Ray, abra el [Mapa de seguimiento de X-Ray](https://docs.aws.amazon.com/xray/latest/devguide/xray-console-servicemap.html). Seleccione **Mapa de servicio** en la sección **X-Ray** en el panel de navegación izquierdo de la consola de CloudWatch.
Después de activar la aplicación para Application Signals, la asignación de aplicaciones muestra nodos que representan los grupos. A continuación, puede desglosar estos grupos para ver los servicios y sus dependencias. Utilice la asignación de aplicaciones para ver la topología de los clientes de la aplicación, los canarios sintéticos, los servicios y las dependencias y para supervisar el estado operativo. Para ver la asignación de aplicaciones, abra la [Consola de CloudWatch](https://console.aws.amazon.com/cloudwatch/) y elija **Mapa de aplicaciones** en la sección **Application Signals** del panel de navegación izquierdo.
Después de [activar la aplicación para Application Signals](CloudWatch-Application-Signals-Enable.md), utilice la asignación de aplicaciones para facilitar la supervisión del estado operativo de la aplicación:
+ Observe las conexiones entre los nodos de clientes, valor controlado, servicio y dependencia para comprender la topología de la aplicación y el flujo de ejecución. Esto es útil sobre todo si los operadores de servicio no son su equipo de desarrollo.
+ Observe qué servicios cumplen o no sus [objetivos de nivel de servicio (SLO)](CloudWatch-ServiceLevelObjectives.md). Cuando un servicio no cumple con los SLO, puede identificar de inmediato si un servicio o una dependencia descendente podría estar contribuyendo al problema o afectando a varios servicios ascendentes.
+ Seleccione un nodo individual de cliente, canario sintético, servicio o dependencia para visualizar las métricas asociadas. La página [Detalles del servicio](ServiceDetail.md) muestra información más detallada sobre las operaciones, las dependencias, los canarios sintéticos y las páginas de clientes.
+ Filtre y amplíe la asignación de aplicaciones para centrarse con más facilidad en una parte de la topología de la aplicación o para ver la asignación completa. Cree un filtro al elegir una o más propiedades del cuadro de texto del filtro. Al elegir cada propiedad, se lo guiará por los criterios de los filtros. Verá el filtro completo debajo del cuadro de texto del filtro. Elija **Borrar filtros** en cualquier momento para eliminar el filtro.
+ Supervise los servicios de varias cuentas de AWS en un única asignación de aplicaciones unificada. Los servicios de las diferentes cuentas se identifican claramente con la información de la cuenta, lo que permite una observabilidad unificada de las aplicaciones distribuidas.
+ Identifique los servicios que aún no instrumenten en la aplicación. Application Signals detecta y muestra automáticamente los servicios que aún no se han instrumentado, lo que le permite lograr una cobertura de observabilidad completa. Los servicios no instrumentados se distinguen visualmente en la asignación para priorizar los esfuerzos de instrumentación.
+ Agrupe y filtre los servicios para crear vistas personalizadas que coincidan con sus flujos de trabajo. Esta organización le permite encontrar rápidamente los servicios que utiliza con más frecuencia y acceder a ellos.
+ Guarde las vistas filtradas y agrupadas para volver rápidamente a las configuraciones de uso frecuente.
## Exploración de la asignación de aplicaciones
Cuando visite la asignación de aplicaciones, de forma predeterminada, se muestran los servicios agrupados por **Servicios relacionados**. Los servicios relacionados agrupan los servicios en función de sus dependencias. Por ejemplo, si el Servicio A llama al Servicio B, que llama al Servicio C, se agrupan en el Servicio A. Puede ver el estado, las métricas y el recuento de servicios del SLI para todos los servicios de cada grupo.
![\[Asignación de aplicaciones predeterminada de CloudWatch agrupada por servicios relacionados.\]](http://docs.aws.amazon.com/es_es/AmazonCloudWatch/latest/monitoring/images/explore-application-map-overview.png)
Elija la siguiente pestaña para obtener información sobre cómo explorar cada tipo de nodo y las periferias (conexiones) entre ellos.
### Agrupación y filtrado dinámicos
Puede hacer clic en el menú desplegable **Agrupar por** para usar diferentes opciones de agrupación. De forma predeterminada, la asignación de aplicaciones proporciona 2 agrupaciones:
+ **Servicios relacionados**: agrupa los servicios en función de sus dependencias.
+ **Entorno**: agrupa los servicios por su entorno.
Si desea definir su propia agrupación personalizada, haga clic en **Administrar grupos** para definir grupos personalizados y, a continuación, etiquete los servicios o agregue los atributos de los recursos de OTEL con la clave de grupo.
**nota**
Para permitir la agrupación mediante los atributos de recursos de OTEL, la versión del agente de CloudWatch debe ser la versión 1.300056.0 o posterior.
![\[Creación de un panel de agrupación personalizado\]](http://docs.aws.amazon.com/es_es/AmazonCloudWatch/latest/monitoring/images/explore-application-map-create-custom-grouping.png)
La agrupación predeterminada en Application Signals organiza automáticamente los servicios en función de las dependencias descendentes. El sistema analiza el gráfico de dependencias del servicio y crea grupos en los que el nodo raíz (un servicio sin dependencias ascendentes) se convierte en el nombre del grupo. Todos los servicios que dependen de este servicio raíz, directa o indirectamente, se incluyen automáticamente en el grupo. Por ejemplo, si el Servicio A llama al Servicio B, que a su vez llama al Servicio C, los tres servicios se agruparán con el Servicio A como nombre del grupo, ya que es la raíz de la cadena de dependencias. Este mecanismo de agrupación automática proporciona una forma natural de visualizar y administrar los servicios relacionados en función de las interacciones y dependencias reales en tiempo de ejecución.
### Información y acciones de grupos
Para cada grupo, puede llevar a cabo las siguientes acciones:
+ Haga clic en **Ver más** para ver los gráficos de métricas, los dos últimos eventos de cambios y la fecha de la última implementación del grupo.
![\[Vista de más cajones del grupo en la asignación de aplicaciones\]](http://docs.aws.amazon.com/es_es/AmazonCloudWatch/latest/monitoring/images/explore-application-map-view-more.png)
+ Haga clic en **Ver panel** para ver el panel de métricas, la tabla de eventos de cambios y la lista de servicios del grupo.
![\[Vista del panel de aplicaciones del grupo\]](http://docs.aws.amazon.com/es_es/AmazonCloudWatch/latest/monitoring/images/explore-application-map-team-overview.png)
![\[Vista del panel de aplicaciones del grupo con gráficos de métricas\]](http://docs.aws.amazon.com/es_es/AmazonCloudWatch/latest/monitoring/images/explore-application-map-team-overview-2.png)
Puede usar **Agrupar y filtrar** en la barra izquierda para filtrar los grupos que tienen servicios según el tiempo de implementación, el estado del SLI o el tipo de plataforma de computación.
![\[Agrupación y filtrado de servicios en el panel de control de la aplicación\]](http://docs.aws.amazon.com/es_es/AmazonCloudWatch/latest/monitoring/images/explore-application-map-grouping-filter.png)
También puede filtrar por cuenta para ver los servicios de cuentas de AWS específicas en la configuración de observabilidad multicuenta.
![\[Filtrado de servicios por cuenta en el panel de control de la aplicación\]](http://docs.aws.amazon.com/es_es/AmazonCloudWatch/latest/monitoring/images/explore-application-map-account-filter.png)
Utilice la barra de **Buscar y filtrar** para buscar grupos por nombre o grupos que contengan un entorno de servicio o una dependencia específicos. Filtre por ID de cuenta para centrarse en los servicios de cuentas específicas.
![\[Búsqueda y filtrado de servicios en la asignación de aplicaciones\]](http://docs.aws.amazon.com/es_es/AmazonCloudWatch/latest/monitoring/images/explore-application-map-search-and-filter.png)
### Configuración de grupos personalizados
La agrupación personalizada le permite organizar los servicios de forma lógica en función de los requisitos empresariales y las prioridades operativas. Esta característica le permite ver y guardar vistas definidas priorizadas según sus necesidades específicas, crear grupos en función de la propiedad del equipo y reunir los grupos de servicios necesarios para las transacciones comerciales críticas.
Cree nombres de grupos personalizados (los nombres de los grupos que verá en la interfaz de usuario) y nombres de las claves de grupos correspondientes. Complete este paso desde la interfaz de usuario de Application Signals o mediante la API [PutGroupingConfiguration](https://docs.aws.amazon.com/applicationsignals/latest/APIReference/API_PutGroupingConfiguration.html).
Los nombres de las claves de grupos pueden ser una clave de etiqueta de AWS o un atributo de recurso de OTEL para el servicio. Al decidir entre las etiquetas y los atributos de recurso de OTEL, tenga en cuenta la plataforma de computación:
+ Para plataformas de un solo servicio (por ejemplo, Lambda o un grupo de escalado automático): utilice etiquetas de AWS.
+ Para plataformas multiservicio (por ejemplo, un clúster de Amazon EKS): utilice los atributos de recursos de OTEL para una agrupación más detallada.
**Adición de etiquetas de AWS**
Agregue una etiqueta de AWS con la clave de grupo personalizada como clave y un valor a un clúster de Amazon EKS. Cuando hay varios servicios en ejecución en un clúster de Amazon EKS, todos ellos se etiquetan con la misma clave de grupo personalizada. Por ejemplo, cuando el Clúster A de Amazon EKS tiene los servicios 1, 2 y 3 en ejecución, al agregar una etiqueta de AWS con la clave *Equipo X* al clúster, se agregarán los tres servicios al *Equipo X*. Para agregar únicamente servicios específicos al *Equipo X*, agregue los atributos de recursos de OTEL para los servicios, tal y como se muestra a continuación.
**Adición de atributos de recursos de OTEL**
Para agregar un atributo de recurso de OTEL, consulte la siguiente configuración:
**Configuración general**
Configure la variable de entorno `OTEL_RESOURCE_ATTRIBUTES` de la aplicación mediante los pares de clave-valor del grupo personalizado. Las claves se enumeran en `aws.application_signals.metric_resource_keys` separadas por `&`.
Por ejemplo, para crear grupos personalizados mediante `Application=PetClinic` y `Owner=Test`, utilice lo siguiente:
```
OTEL_RESOURCE_ATTRIBUTES=Application=PetClinic,Owner=Test,aws.application_signals.metric_resource_keys=Application&Owner
```
**Configuración específica de la plataforma**
A continuación se muestran las especificaciones de implementación.
**Amazon EKS y kubernetes nativos**
```
apiVersion: apps/v1
kind: Deployment
metadata:
...
spec:
replicas: 1
...
template:
spec:
containers:
- name: your-app
image: your-app-image
env:
...
- name: OTEL_RESOURCE_ATTRIBUTES
value: Application=PetClinic,Owner=Test,aws.application_signals.metric_resource_keys=Application&Owner
```
**Amazon EC2**
Agregue `OTEL_RESOURCE_ATTRIBUTES` al script de inicio de la aplicación. Para ver el ejemplo completo, consulte [Adición de `OTEL_RESOURCE_ATTRIBUTES`](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Application-Signals-Enable-EC2Main.html#CloudWatch-Application-Signals-Monitor-EC2).
```
...
OTEL_RESOURCE_ATTRIBUTES="service.name=$YOUR_SVC_NAME,Application=PetClinic,Owner=Test,aws.application_signals.metric_resource_keys=Application&Owner" \
java -jar $MY_JAVA_APP.jar
```
**Amazon ECS**
Agregue `OTEL_RESOURCE_ATTRIBUTES` a TaskDefinition. Para ver el ejemplo completo, consulte [Habilitación en Amazon ECS](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Application-Signals-Enable-ECSMain.html).
```
{
"name": "my-app",
...
"environment": [
{
"name": "OTEL_RESOURCE_ATTRIBUTES",
"value": "service.name=$YOUR_SVC_NAME,Application=PetClinic,Owner=Test,aws.application_signals.metric_resource_keys=Applicationmanagement portalOwner"
},
...
]
}
```
**Lambda**
Agregue `OTEL_RESOURCE_ATTRIBUTES` a la variable de entorno de Lambda.
```
OTEL_RESOURCE_ATTRIBUTES="Application=PetClinic,Owner=Test,aws.application_signals.metric_resource_keys=Application&Owner"
```
### Visualización de servicios en grupos
Para ver los servicios y sus dependencias en un grupo, haga clic en el nombre del grupo. Se mostrará una asignación de servicios del grupo. Cada nodo de servicio mostrará el estado, las métricas y los detalles de la plataforma del SLI. Los servicios con una infracción del SLI están resaltados para que se puedan reconocer más fácilmente.
![\[Servicios de asignación de aplicaciones de CloudWatch del grupo.\]](http://docs.aws.amazon.com/es_es/AmazonCloudWatch/latest/monitoring/images/View-services-groups.png)
Los servicios no instrumentados se muestran con un indicador visual distintivo (como un borde discontinuo o un color diferente) para diferenciarlos de los servicios instrumentados. Pase el curso del ratón por encima de un nodo de servicio no instrumentado para ver la guía de instrumentación y los enlaces a la documentación de configuración.
![\[Filtrado por servicios no instrumentados en la asignación de aplicaciones\]](http://docs.aws.amazon.com/es_es/AmazonCloudWatch/latest/monitoring/images/explore-application-map-uninstrumented-filter.png)
Todos los nodos de servicios de AWS, clientes de RUM y canarios estarán contraídos de forma predeterminada. Si los servicios de este grupo llaman a servicios que no forman parte de este grupo, también se contraerán de forma predeterminada.
![\[Los nodos canarios se contraen en un grupo en la asignación de aplicaciones.\]](http://docs.aws.amazon.com/es_es/AmazonCloudWatch/latest/monitoring/images/explore-application-map-canary-collapse.png)
Si la asignación sigue siendo demasiado grande para investigarla con eficacia, puede aplicar una agrupación anidada para reducir la investigación. Por ejemplo, después de agrupar los servicios por **unidad de negocio**, si todavía tiene demasiados servicios en un grupo, utilice el menú desplegable Agrupar por para seleccionar **Equipo** y crear una estructura de agrupamiento anidada.
![\[Agrupación anidada en la asignación de aplicaciones\]](http://docs.aws.amazon.com/es_es/AmazonCloudWatch/latest/monitoring/images/explore-application-map-nested-grouping.png)
### Información y detalles del servicio
En esta página, también puede hacer clic en **Guardar vista** junto a la barra de búsqueda para guardar la vista, de modo que la próxima vez no tendrá que volver a aplicar la misma agrupación y el mismo filtrado.
![\[Guardado de la configuración de agrupación\]](http://docs.aws.amazon.com/es_es/AmazonCloudWatch/latest/monitoring/images/explore-application-map-save-view.png)
Haga clic en **Ver más** en el nodo de servicio para ver los gráficos de auditoría del servicio, eventos de cambios, estado del SLI y métricas.
![\[Información del servicio de asignación de aplicaciones de CloudWatch.\]](http://docs.aws.amazon.com/es_es/AmazonCloudWatch/latest/monitoring/images/explore-application-map-service-view-more.png)
Si desea ver el funcionamiento del servicio y otros detalles del servicio, haga clic en **Ver panel** para ir a la página de información general del servicio.
![\[Información general del servicio de asignación de aplicaciones de CloudWatch.\]](http://docs.aws.amazon.com/es_es/AmazonCloudWatch/latest/monitoring/images/explore-application-map-service-overview.png)
También puede hacer clic en Periferia para ver las métricas de una llamada de dependencia específica de un servicio.
![\[Cajón de periferia de un nodo de la asignación de aplicaciones de CloudWatch\]](http://docs.aws.amazon.com/es_es/AmazonCloudWatch/latest/monitoring/images/explore-application-map-edge.png)
### Eventos de cambios
Haga un seguimiento de los eventos de cambios en toda la aplicación con el procesamiento automático de Application Signals de eventos de CloudTrail. Supervise los eventos de configuración e implementación de los servicios y las dependencias, lo que proporciona un contexto inmediato para el análisis operativo y la solución de problemas. La detección de eventos de cambio está activada junto con la activación de la detección de servicios a través de la consola de CloudWatch o la API StartDiscovery. En el caso de los servicios de EKS, la detección de implementación requiere que los servicios de EKS se instrumenten con el SDK de instrumentación de Application Signals. Application Signals correlaciona automáticamente los tiempos de implementación con los cambios en el rendimiento, lo que le permite identificar rápidamente si las implementaciones recientes contribuyeron a los problemas del servicio. Consulte el historial de eventos de cambios y su impacto en todos sus servicios sin necesidad de configuración ni requisitos de configuración adicionales.
### Resultados de auditoría
Descubra información crítica mediante los resultados de la auditoría de Application Signals. El servicio analiza las aplicaciones para informar sobre observaciones importantes y los posibles problemas, lo que simplifica el análisis de las causas raíz. Estos resultados automatizados consolidan los rastros pertinentes, lo que elimina la necesidad de navegar con varios clics. El sistema de auditoría ayuda a los equipos a identificar rápidamente los problemas y sus causas subyacentes, lo que permite una resolución más rápida de los problemas.
En el caso de los servicios que funcionan en Amazon Bedrock, Application Signals supervisa automáticamente los patrones de uso de los tokens de GenAI. El sistema de auditoría detecta anomalías en el consumo de los tokens de entrada y salida y compara el uso actual con los valores de referencia históricos. Cuando el uso de los tokens supera los patrones normales, los resultados de la auditoría proporcionan un análisis detallado que incluye las tendencias de consumo de los tokens, las implicaciones económicas y las recomendaciones de optimización. Esto ayuda a los equipos a identificar solicitudes ineficientes, picos inesperados de uso de tokens y oportunidades para reducir los costos operativos de GenAI.
### Observabilidad entre cuentas en la asignación de aplicaciones
Application Signals admite la observabilidad entre cuentas, lo que le permite supervisar y visualizar los servicios distribuidos en varias cuentas de AWS en una sola asignación de aplicaciones unificada. Esta capacidad es esencial para organizaciones con arquitecturas multicuenta que siguen las prácticas recomendadas de AWS.
**Capacidades clave:**
+ *Vista unificada*: visualice los servicios de varias cuentas de AWS en una sola asignación de aplicaciones, lo que proporciona una imagen completa de la arquitectura de aplicaciones distribuidas.
+ *Identificación de la cuenta*: cada nodo de servicio muestra claramente el ID de cuenta y la región, lo que facilita la identificación de la propiedad y la ubicación del servicio.
+ *Supervisión centralizada*: supervise el estado, el rendimiento y el estado del SLO de los servicios en todas las cuentas conectadas desde una sola cuenta de supervisión.
+ *Filtrado entre cuentas*: filtre y agrupe los servicios por ID de cuenta para centrarse en cuentas específicas o ver las interacciones entre cuentas.
**cómo funciona:**
Application Signals utiliza AWS Organizations y el uso compartido entre cuentas para permitir la observabilidad en varias cuentas. Para configurar la observabilidad entre cuentas, consulte [Observabilidad entre cuentas de CloudWatch](CloudWatch-Unified-Cross-Account.md).
------
#### [ View your application services ]
**Servicio (instrumentado)**
Puede ver los servicios de las aplicaciones y el estado de sus SLO e indicadores de nivel de servicio (SLI) en la **asignación de aplicaciones**. Si no se ha creado ningún SLO para un servicio, elija el botón **Crear SLO** situado debajo del nodo de servicio.
La **asignación de aplicaciones** muestra todos sus servicios. También muestra los clientes y canarios que consumen el servicio y las dependencias a las que llaman sus servicios, como se muestra en la siguiente imagen:
![\[Asignación de aplicaciones de CloudWatch que muestra un servicio en buen o mal estado\]](http://docs.aws.amazon.com/es_es/AmazonCloudWatch/latest/monitoring/images/service-map-service-healthy-unhealthy.png)
Al seleccionar un nodo de servicio, se abre un panel con la siguiente información detallada del servicio:
+ Tasa total de errores y fallos.
+ El número de SLI y SLO que están en `healthy` o `unhealthy`.
+ La opción para ver más información acerca de un SLO.
+ `Cluster`, `Namespace` y `Workload` de los servicios alojados en Amazon EKS o entorno de los servicios alojados en Amazon ECS o Amazon EC2. Para los servicios alojados en Amazon EKS, elija cualquier enlace para abrir la Información de contenedores de CloudWatch.
+ AccountId y región
+ Sección **Cambios** que muestra los cambios recientes y la fecha de la última implementación.
+ Pestaña **Auditoría operativa** que proporciona recomendaciones y resultados de auditoría automatizados.
+ Gráfico de métricas de servicios sobre disponibilidad, latencia, fallos y errores.
Seleccione una periferia o conexión entre un nodo de servicio y un nodo de servicio o dependencia posterior. Esto abre un panel que contiene las rutas principales por tasa de fallos, latencia y tasa de errores, como se muestra en la siguiente imagen de ejemplo. Elija cualquier enlace del panel para abrir la página [Detalles del servicio](ServiceDetail.md) y ver la información detallada del servicio o dependencia elegida.
![\[Periferia de servicios de la asignación de aplicaciones de CloudWatch\]](http://docs.aws.amazon.com/es_es/AmazonCloudWatch/latest/monitoring/images/App-signals-service-edge.png)
Al seleccionar un nodo de periferia, se abre un panel con la siguiente información detallada del servicio:
+ Recuento total de solicitudes, latencia, tasa de errores y tasa de fallos
+ Ruta principal por tasa de fallos
+ Ruta principal por latencia
+ Ruta principal por tasa de errores
**Servicio (no instrumentado)**
Los servicios no instrumentados aparecen en la asignación de aplicaciones incluso cuando no se han configurado con Application Signals. Estos servicios se detectan automáticamente al utilizar Resource Explorer mediante los nombres y las etiquetas de las aplicaciones. El sistema puede detectar automáticamente hasta 3000 recursos de una cuenta de AWS.
Al seleccionar un nodo de servicio no instrumentado, se abre un panel con la siguiente información:
+ Nombre del servicio e información de identificación
+ AccountId y región donde se detecta el servicio
+ Estado y orientación de la instrumentación
+ Botón de llamada a la acción “Activar Application Signals” que proporciona instrucciones de configuración
+ Tipo de plataforma de computación (si se puede detectar)
Los servicios no instrumentados le permiten hacer lo siguiente:
+ Identificar deficiencias en la cobertura de observabilidad
+ Priorizar qué servicios se instrumentan a continuación en función de su posición en la arquitectura
+ Comprender la topología completa de la aplicación incluso antes de completar la instrumentación
+ Planificar la implementación de instrumentación en toda la organización
**nota**
Los servicios no instrumentados muestran datos de telemetría limitados, ya que no envían métricas ni rastros de forma activa.
![\[Filtro de instrumentación de la asignación de aplicaciones de CloudWatch\]](http://docs.aws.amazon.com/es_es/AmazonCloudWatch/latest/monitoring/images/explore-application-map-instrumentation-filter.png)
------
#### [ View dependencies ]
Las dependencias de las aplicaciones se muestran en la asignación de aplicaciones, conectadas a los servicios que las llaman.
Elija un nodo de dependencia para abrir el panel que contiene la tasa de errores y de fallos, así como el gráfico de métricas de solicitud, disponibilidad, latencia, tasa de fallos y tasa de errores.
Si el nodo de dependencia es un servicio o un recurso, el panel mostrará los eventos de cambios para el intervalo de tiempo solicitado.
![\[Una asignación de aplicaciones de CloudWatch que muestra un nodo de dependencia del servicio expandible de AWS.\]](http://docs.aws.amazon.com/es_es/AmazonCloudWatch/latest/monitoring/images/service-map-dependency.png)
------
#### [ View clients ]
Después de [activar el seguimiento de X-Ray](CloudWatch-RUM-get-started-create-app-monitor.md) para los clientes web de CloudWatch RUM, estos se muestran en la asignación de aplicaciones conectada a los servicios a los que llaman.
Elija un nodo de cliente para abrir el panel que muestre la siguiente información detallada del cliente:
+ Métricas de las cargas de página, tiempo promedio de carga, errores y elementos vitales web promedio
+ Un gráfico que muestra el desglose de los errores
+ Un enlace para mostrar los detalles del cliente en CloudWatch RUM
![\[Una asignación de aplicaciones de CloudWatch que muestra un nodo de cliente expandible.\]](http://docs.aws.amazon.com/es_es/AmazonCloudWatch/latest/monitoring/images/service-map-client.png)
Elija **Ver panel** para abrir los detalles de los canarios.
------
#### [ View synthetics canaries ]
Para ver los canarios en la asignación de aplicaciones, [active el seguimiento de X-Ray](CloudWatch-RUM-get-started-create-app-monitor.md) para los canarios de CloudWatch Synthetics. Una vez activado, los canarios aparecerán conectados a los servicios a los que hayan llamado en la asignación de aplicaciones.
El sistema agrupa los canarios de forma predeterminada en un único icono expandible. El panel de información detallada de los canarios muestra métricas, rastros e información del estado.
Seleccione un nodo de canario para abrir el panel que muestra la siguiente información detallada del canario, tal como se muestra en la siguiente imagen:
![\[Una asignación de aplicaciones de CloudWatch que muestra un nodo de canario sintético expandible.\]](http://docs.aws.amazon.com/es_es/AmazonCloudWatch/latest/monitoring/images/service-map-canary.png)
Elija **Ver panel** para abrir los detalles de los canarios.
------
# Observabilidad de aplicaciones para la acción de AWS
La observabilidad de aplicaciones para la GitHub Action de AWS proporciona un flujo de trabajo integral de investigación de la observabilidad de aplicaciones que conecta el código fuente y los datos de telemetría de producción en vivo con el agente de IA. Aprovecha los MCP de CloudWatch y genera peticiones personalizadas para proporcionar el contexto que los agentes de IA necesitan para solucionar problemas y aplicar correcciones de código.
La acción configura el [servidor MCP de CloudWatch Application Signals](https://awslabs.github.io/mcp/servers/cloudwatch-applicationsignals-mcp-server) y el [servidor MCP de CloudWatch](https://awslabs.github.io/mcp/servers/cloudwatch-applicationsignals-mcp-server), lo que les permite acceder a los datos de telemetría en vivo como contexto de solución de problemas. Para investigar el rendimiento de las aplicaciones, puede utilizar el modelo de IA que prefiera, ya sea mediante su propia clave de API, un modelo de terceros o Amazon Bedrock.
Para comenzar, mencione `@awsapm` en los problemas de GitHub para activar el agente de IA. El agente solucionará los problemas de producción, implementará correcciones y mejorará la cobertura de observabilidad en función de los datos de la aplicación en vivo.
Esta acción en sí no supone ningún costo directo. Sin embargo, el uso de esta acción puede generar cargos por los servicios de AWS y el uso del modelo de IA. Consulte la [documentación sobre consideraciones de costos](https://github.com/marketplace/actions/application-observability-for-aws#-cost-considerations) para obtener información detallada sobre los posibles costos.
## Introducción
Esta acción configura los agentes de IA dentro del flujo de trabajo de GitHub mediante la generación de configuraciones de MCP específicas de AWS y peticiones de observabilidad personalizadas. Solo necesita proporcionar el rol de IAM que se asumirá y un [ID de modelo de Bedrock](https://docs.aws.amazon.com/bedrock/latest/userguide/models-supported.html) que desee usar o un token de API de la suscripción del LLM actual. En el siguiente ejemplo, se muestra una plantilla de flujo de trabajo que integra esta acción con la acción basada en [claude-code-base-action de Anthropic](https://github.com/anthropics/claude-code-base-action) para llevar a cabo investigaciones automatizadas.
### Requisitos previos
Antes de comenzar, asegúrese de que dispone de lo siguiente:
+ **Permisos del repositorio de GitHub**: acceso de escritura o superior al repositorio (necesario para activar la acción)
+ **Rol de AWS IAM**: rol de IAM configurado con OpenID Connect (OIDC) para GitHub Actions con permisos para lo siguiente:
+ Acceso a CloudWatch Application Signals y CloudWatch
+ Acceso al modelo de Amazon Bedrock (si se utilizan modelos de Bedrock)
+ **Token de GitHub**: el flujo de trabajo usa automáticamente GITHUB\$1TOKEN con los permisos necesarios
### Pasos de configuración
#### Paso 1: configuración de las credenciales de AWS
Esta acción se basa en la acción [aws-actions/configure-aws-credentials](https://github.com/aws-actions/configure-aws-credentials) para configurar la autenticación de AWS en el entorno de GitHub Actions. Recomendamos usar OpenID Connect (OIDC) para autenticarse con AWS. OIDC permite que los flujos de trabajo de GitHub Actions accedan a los recursos de AWS mediante credenciales de AWS de corta duración, por lo que no tiene que almacenar credenciales a largo plazo en el repositorio.
1. **Creación de un proveedor de identidades de IAM**
Primero, cree un proveedor de identidades de IAM que confíe en el punto de conexión de OIDC de GitHub en la Consola de administración de AWS:
1. Apertura de la consola de IAM
1. Elija **Proveedores de identidades** en **Administración de acceso**.
1. Haga clic en **Agregar proveedor** para agregar el proveedor de identidades de GitHub si aún no se ha creado.
1. Seleccione el tipo de proveedor de identidades de **OpenID Connect**.
1. Ingrese `https://token.actions.githubusercontent.com` en el cuadro de entrada **URL de proveedor**.
1. Ingrese `sts.amazonaws.com` en el cuadro de entrada **Audiencia**.
1. Haga clic en **Agregar proveedor**.
1. **Crear una política de IAM**
Cree una política de IAM con los permisos necesarios para esta acción. Consulte la sección [Permisos necesarios](#Service-Application-Observability-for-AWS-GitHub-Action-required-permissions) a continuación para obtener más información.
1. **Creación de un rol de IAM**
Cree un rol de IAM (por ejemplo, `AWS_IAM_ROLE_ARN`) en la Consola de administración de AWS con la siguiente plantilla de política de confianza. Esto permite que los repositorios de GitHub autorizados asuman el rol:
```
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Principal": {
"Federated": "arn:aws:iam:::oidc-provider/token.actions.githubusercontent.com"
},
"Action": "sts:AssumeRoleWithWebIdentity",
"Condition": {
"StringEquals": {
"token.actions.githubusercontent.com:aud": "sts.amazonaws.com"
},
"StringLike": {
"token.actions.githubusercontent.com:sub": "repo:/:ref:refs/heads/"
}
}
}
]
}
```
Reemplace los marcadores de posición siguientes en la plantilla:
+ ``: ID de cuenta de AWS
+ ``: nombre de la organización de GitHub
+ ``: nombre del repositorio
+ ``: nombre de la ramificación (por ejemplo, principal)
1. **Adjunción de la política de IAM**
En la pestaña Permisos del rol, adjunte la política de IAM que creó en el paso 2.
Para obtener más información sobre cómo configurar OIDC con AWS, consulte la [Guía de inicio rápido de OIDC de configure-aws-credentials](https://github.com/aws-actions/configure-aws-credentials/tree/main?tab=readme-ov-file#quick-start-oidc-recommended).
#### Paso 2: configuración de secretos y adición del flujo de trabajo
1. **Configuración de secretos del repositorio**
Vaya al repositorio → Configuración → Secretos y variables → Acciones.
+ Cree un nuevo secreto de repositorio denominado `AWS_IAM_ROLE_ARN` y establezca su valor en el ARN del rol de IAM que creó en el paso 1.
+ (Opcional) Cree una variable de repositorio denominada `AWS_REGION` para especificar la región de AWS (el valor predeterminado es `us-east-1` si no se estableció).
1. **Adición del archivo de flujo de trabajo**
A continuación se muestra un ejemplo de flujo de trabajo que demuestra el uso de esta acción con los modelos de Amazon Bedrock. Cree un flujo de trabajo de investigación de observabilidad de aplicaciones a partir de esta plantilla en el directorio de repositorios de GitHub `.github/workflows`.
```
name: Application observability for AWS
on:
issue_comment:
types: [created, edited]
issues:
types: [opened, assigned, edited]
jobs:
awsapm-investigation:
if: |
(github.event_name == 'issue_comment' && contains(github.event.comment.body, '@awsapm')) ||
(github.event_name == 'issues' && (contains(github.event.issue.body, '@awsapm') || contains(github.event.issue.title, '@awsapm')))
runs-on: ubuntu-latest
permissions:
contents: write # To create branches for PRs
pull-requests: write # To post comments on PRs
issues: write # To post comments on issues
id-token: write # Required for AWS OIDC authentication
steps:
- name: Checkout repository
uses: actions/checkout@v4
- name: Configure AWS credentials
uses: aws-actions/configure-aws-credentials@v4
with:
role-to-assume: ${{ secrets.AWS_IAM_ROLE_ARN }}
aws-region: ${{ vars.AWS_REGION || 'us-east-1' }}
# Step 1: Prepare AWS MCP configuration and investigation prompt
- name: Prepare Investigation Context
id: prepare
uses: aws-actions/application-observability-for-aws@v1
with:
bot_name: "@awsapm"
cli_tool: "claude_code"
# Step 2: Execute investigation with Claude Code
- name: Run Claude Investigation
id: claude
uses: anthropics/claude-code-base-action@beta
with:
use_bedrock: "true"
# Set to any Bedrock Model ID
model: "us.anthropic.claude-sonnet-4-5-20250929-v1:0"
prompt_file: ${{ steps.prepare.outputs.prompt_file }}
mcp_config: ${{ steps.prepare.outputs.mcp_config_file }}
allowed_tools: ${{ steps.prepare.outputs.allowed_tools }}
# Step 3: Post results back to GitHub issue/PR (reuse the same action)
- name: Post Investigation Results
if: always()
uses: aws-actions/application-observability-for-aws@v1
with:
cli_tool: "claude_code"
comment_id: ${{ steps.prepare.outputs.awsapm_comment_id }}
output_file: ${{ steps.claude.outputs.execution_file }}
output_status: ${{ steps.claude.outputs.conclusion }}
```
**Nota sobre la configuración:**
+ Este flujo de trabajo se activa automáticamente cuando `@awsapm` se menciona en un problema o comentario.
+ El flujo de trabajo utiliza el secreto `AWS_IAM_ROLE_ARN` configurado en el paso anterior.
+ Actualice el parámetro del modelo en el paso 2 para especificar el ID de modelo preferido de Amazon Bedrock.
+ Puede personalizar el nombre del bot (por ejemplo, `@awsapm-prod`, `@awsapm-staging`) en el parámetro bot\$1name para que sea compatible con diferentes entornos.
#### Paso 3: inicio del uso de la acción
Una vez que el flujo de trabajo esté configurado, mencione `@awsapm` en cualquier problema de GitHub para activar una investigación basada en IA. La acción analizará la solicitud, accederá a los datos de telemetría en vivo y proporcionará recomendaciones o implementará correcciones automáticamente.
**Ejemplos de casos de uso:**
1. Investigue los problemas de rendimiento, publique y corrija:
`@awsapm, can you help me investigate availability issues in my appointment service?`
![\[alt text not found\]](http://docs.aws.amazon.com/es_es/AmazonCloudWatch/latest/monitoring/images/github-availability-issue-investigate.png)
`@awsapm, can you post a fix?`
![\[alt text not found\]](http://docs.aws.amazon.com/es_es/AmazonCloudWatch/latest/monitoring/images/github-availability-issue-pr-fix.png)
1. Active la instrumentación:
`@awsapm, please enable Application Signals for lambda-audit-service and create a PR with the required changes.`
1. Consulte datos de telemetría:
`@awsapm, how many GenAI tokens have been consumed by my services in the past 24 hours?`
**Qué ocurre a continuación:**
1. El flujo de trabajo detecta la mención `@awsapm` y activa la investigación.
1. El agente de IA accede a los datos de telemetría de AWS en vivo a través de los servidores MCP configurados.
1. El agente analiza el problema y puede:
+ Publicar los resultados y las recomendaciones directamente en el problema.
+ Crear una solicitud de extracción con cambios en el código (para la instrumentación o correcciones).
1. Para revisar los resultados y continuar la conversación, vuelva a mencionar @awsapm con preguntas de seguimiento.
## Seguridad
Esta acción prioriza la seguridad con controles de acceso estrictos, una autenticación de AWS basada en OIDC y protecciones integradas contra ataques de inyección de peticiones. Solo los usuarios con acceso de escritura o superior pueden activar la acción, y todas las operaciones se limitan al repositorio específico.
Para obtener información de seguridad detallada, que incluye:
+ Requisitos de control de acceso y permisos
+ Permisos de AWS IAM y configuración de OIDC
+ Riesgos y mitigaciones de la inyección de peticiones
+ Prácticas recomendadas de seguridad
Consulte la [documentación sobre seguridad](https://github.com/aws-actions/application-observability-for-aws/blob/main/docs/security.md).
## Configuración
### Permisos necesarios
El rol de IAM que asume GitHub Actions debe tener los siguientes permisos.
**Nota**: `bedrock:InvokeModel` y `bedrock:InvokeModelWithResponseStream` solo son obligatorios si utiliza modelos Amazon Bedrock.
```
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"application-signals:ListServices",
"application-signals:GetService",
"application-signals:ListServiceOperations",
"application-signals:ListServiceLevelObjectives",
"application-signals:GetServiceLevelObjective",
"application-signals:ListAuditFindings",
"cloudwatch:DescribeAlarms",
"cloudwatch:DescribeAlarmHistory",
"cloudwatch:ListMetrics",
"cloudwatch:GetMetricData",
"cloudwatch:GetMetricStatistics",
"logs:DescribeLogGroups",
"logs:DescribeQueryDefinitions",
"logs:ListLogAnomalyDetectors",
"logs:ListAnomalies",
"logs:StartQuery",
"logs:StopQuery",
"logs:GetQueryResults",
"logs:FilterLogEvents",
"xray:GetTraceSummaries",
"xray:GetTraceSegmentDestination",
"xray:BatchGetTraces",
"xray:ListRetrievedTraces",
"xray:StartTraceRetrieval",
"servicequotas:GetServiceQuota",
"synthetics:GetCanary",
"synthetics:GetCanaryRuns",
"s3:GetObject",
"s3:ListBucket",
"iam:GetRole",
"iam:ListAttachedRolePolicies",
"iam:GetPolicy",
"iam:GetPolicyVersion",
"bedrock:InvokeModel",
"bedrock:InvokeModelWithResponseStream"
],
"Resource": "*"
}
]
}
```
## Documentación
Para obtener más información, consulte:
+ [Documentación de CloudWatch Application Signals](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Application-Monitoring-Intro.html): más información sobre las características y capacidades de CloudWatch Application Signals
+ [Documentación de Observabilidad de aplicaciones para la acción de AWS](https://github.com/marketplace/actions/application-observability-for-aws): guías y tutoriales detallados
# Ejemplo: utilice Application Signals para resolver un problema de estado operativo
El siguiente escenario brinda un ejemplo de cómo se puede utilizar Application Signals para monitorear sus servicios e identificar problemas de calidad del servicio. Desplácese para identificar las posibles causas subyacentes y tome medidas para resolver el problema. Este ejemplo se centra en una aplicación de clínica de mascotas compuesta por varios microservicios que llaman a Servicios de AWS, como DynamoDB.
Jane forma parte de un equipo de DevOps que supervisa el estado operativo de una aplicación de clínica de mascotas. El equipo de Jane se encarga de asegurar que la aplicación tenga una alta disponibilidad y capacidad de respuesta. Utilizan [objetivos de nivel de servicio (SLO)](CloudWatch-ServiceLevelObjectives.md) para medir el rendimiento de las aplicaciones en relación con estos compromisos empresariales. Jane recibe una alerta sobre varios indicadores de nivel de servicio (SLI) incorrectos. Abre la consola de CloudWatch y se dirige a la página Servicios, donde observa varios servicios que no funcionan de forma correcta.
![\[Servicios con SLI incorrectos\]](http://docs.aws.amazon.com/es_es/AmazonCloudWatch/latest/monitoring/images/example-scenario-services-page.jpg)
En la parte superior de la página, Jane ve que el `visits-service` es el servicio principal por tasa de fallos. Selecciona el enlace en el gráfico, que abre la página Detalles del servicio para ese servicio. Observa que hay una operación incorrecta en la tabla Operaciones del servicio. Selecciona esta operación y observa en el gráfico de Volumen y disponibilidad que hay picos periódicos en el volumen de llamadas que parecen relacionarse con caídas en la disponibilidad.
![\[Volumen y disponibilidad de las operaciones del servicio\]](http://docs.aws.amazon.com/es_es/AmazonCloudWatch/latest/monitoring/images/example-scenario-unhealthy-operation.png)
Para analizar más de cerca las caídas en la disponibilidad del servicio, Jane selecciona uno de los puntos de datos de disponibilidad del gráfico. Se abre un panel que muestra los seguimientos de X-Ray que se correlacionan con el punto de datos seleccionado. Observa que hay varios seguimientos que contienen errores.
![\[Disponibilidad del servicio y seguimientos correlacionados\]](http://docs.aws.amazon.com/es_es/AmazonCloudWatch/latest/monitoring/images/example-scenario-correlated-traces.jpg)
Jane selecciona uno de los seguimientos correlacionados con un estado de error, lo que abre la página de detalles de Seguimiento de X-Ray del seguimiento seleccionado. Jane se desplaza hacia la sección Escala de tiempo de los segmentos y sigue la ruta de llamada hasta que observa que las llamadas a una tabla de DynamoDB presentan errores. Selecciona el segmento de DynamoDB y navega hasta la pestaña Excepciones del panel de la derecha.
![\[Seguimiento de segmentos con errores de DynamoDB\]](http://docs.aws.amazon.com/es_es/AmazonCloudWatch/latest/monitoring/images/example-scenario-DDB-segment.jpg)
Jane observa que un recurso de DynamoDB está mal configurado, lo que provoca errores durante los picos de solicitudes de los clientes. El nivel de rendimiento aprovisionado de la tabla de DynamoDB se supera de forma periódica, lo que provoca problemas de disponibilidad del servicio y SLI incorrectos. Según esta información, su equipo puede configurar un nivel superior de rendimiento aprovisionado y asegurar una alta disponibilidad de la aplicación.
# Ejemplo: utilice Application Signals para solucionar los problemas de las aplicaciones de IA generativa que interactúan con los modelos Amazon Bedrock
Puede utilizar Application Signals para solucionar los problemas de las aplicaciones de IA generativa que interactúan con modelos Amazon Bedrock. Application Signals agiliza este proceso al proporcionar datos de telemetría listos para usar, con lo que brinda información más detallada sobre las interacciones de la aplicación con los modelos de lenguaje de gran tamaño. Ayuda a abordar casos de uso clave como:
+ Problemas con la configuración del modelo
+ Costos de utilización del modelo
+ Latencia del modelo
+ Motivos por los que se detuvo la generación de respuestas del modelo
[Habilitar Application Signals](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Application-Signals-Enable.html) con observabilidad de modelos de lenguaje de gran tamaño/IA generativa permite visualizar en tiempo real las interacciones de la aplicación con los servicios de Amazon Bedrock. Application Signals genera y correlaciona automáticamente métricas de rendimiento y seguimientos para llamadas a la API de Amazon Bedrock.
Application Signals actualmente es compatible con los siguientes modelos de lenguaje de gran tamaño de Amazon Bedrock.
+ AI21 Jamba
+ Amazon Titan
+ Anthropic Claude
+ Cohere Command
+ Meta Llama
+ Mistral AI
+ Nova
## Métricas y seguimientos detallados
Para cada llamada a la API de Amazon Bedrock, Application Signals genera métricas de rendimiento detalladas a nivel de recursos, que incluyen:
+ ID del modelo
+ ID de barreras de protección
+ ID de base de conocimientos
+ ID de agente de Bedrock
Además, los segmentos de seguimiento correlacionados al mismo nivel ayudan a proporcionar una visión integral de la ejecución de solicitudes y sus dependencias.
![\[Métricas de rendimiento mediante Application Signals.\]](http://docs.aws.amazon.com/es_es/AmazonCloudWatch/latest/monitoring/images/AppSignalsAIExample.png)
## Compatibilidad con atributos de OpenTelemetry para IA generativa
Application Signals genera los siguientes atributos de IA generativa para llamadas a la API de Amazon Bedrock con la convención semántica de OpenTelemetry. Estos atributos ayudan a analizar el uso del modelo, el costo y la calidad de la respuesta, y se pueden aprovechar a través de la [Búsqueda de transacciones](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Transaction-Search.html) para obtener información más detallada.
+ gen\$1ai.system
+ gen\$1ai.request.model
+ gen\$1ai.request.max\$1tokens
+ gen\$1ai.request.temperature
+ gen\$1ai.request.top\$1p
+ gen\$1ai.usage.input\$1tokens
+ gen\$1ai.usage.output\$1tokens
+ gen\$1ai.response.finish\$1reasons
![\[Atributos de IA generativa con Application Signals.\]](http://docs.aws.amazon.com/es_es/AmazonCloudWatch/latest/monitoring/images/AppSignalsAIExample_1.png)
Por ejemplo, puede aprovechar la capacidad analítica de Búsqueda de transacciones para comparar el uso de tokens y el costo entre diferentes modelos de lenguaje de gran tamaño para la misma petición, lo que permite una selección de modelos más eficiente en costos.
![\[Atributos de IA generativa con Application Signals.\]](http://docs.aws.amazon.com/es_es/AmazonCloudWatch/latest/monitoring/images/AppSignalsAIExample_2.png)
Para obtener más información, consulte [Mejorar la observabilidad de Amazon Bedrock con CloudWatch Application Signals](https://aws.amazon.com/blogs/mt/improve-amazon-bedrock-observability-with-amazon-cloudwatch-appsignals/).