Soluciona problemas de supervisión de aplicaciones

En este documento, se incluye información que puede ayudarte a comprender qué datos se muestran en la página Application monitoring. También contiene información que puede ayudarte a configurar tu Google Cloud proyecto para que puedas ver los datos de tu aplicación.

Problemas conocidos

En esta sección, se enumeran los problemas conocidos relacionados con Application Monitoring:

• Para los siguientes recursos, el mapa de topología solo muestra bordes cuando el servicio o la carga de trabajo correspondiente tiene un estado de registro de App Hub de discovered:

  • Recursos de Firestore
  • Recursos de Spanner
  • Recursos de Cloud Storage
  • Servidores de MCP de Google Cloud

  Un servicio o una carga de trabajo tiene un estado de registro de discovered cuando forma parte del límite de administración de aplicaciones, pero no está registrado en ninguna aplicación.

Solucionar problemas

En esta sección, se describe cómo resolver problemas relacionados con Application Monitoring.

Se te indica que crees una aplicación

Abres la página Application monitoring en la Google Cloud consola y ves el mensaje "Create an Application to get started". No esperas ver este mensaje porque registraste una aplicación de App Hub.

Para resolver esta falla, asegúrate de que el selector de recursos esté configurado en tu proyecto host de App Hub o en el proyecto de administración de tu carpeta habilitada para apps.

Tu aplicación no muestra datos para algunas señales de oro

Hay varios motivos por los que no verás un valor para un indicador de oro:

• La infraestructura no admite el tipo de métrica. Por ejemplo, los balanceadores de cargas de red no admiten métricas del sistema. Para obtener más información, consulta Servicios y cargas de trabajo compatibles con Application Monitoring.

• Se admite el tipo de métrica, pero no hay datos disponibles. Por ejemplo, si el período se establece para un intervalo en el que no se recopilaron datos de métricas, no hay datos para mostrar para los indicadores de oro.

Para obtener una lista de los recursos que generan etiquetas de App Hub, consulta Servicios y cargas de trabajo compatibles con Application Monitoring.

Faltan datos de métricas de tu aplicación o están incompletos

Ves un gráfico para un servicio o una carga de trabajo, y este gráfico no muestra ningún dato de métricas o faltan algunos datos.

Es posible que no necesites hacer nada. Los gráficos agregados al panel predefinido para un servicio o una carga de trabajo se seleccionan en función de los recursos que usa ese servicio o carga de trabajo. Sin embargo, es posible que algunos recursos no generen datos para un tipo de métrica específico. Para obtener una lista de los recursos que generan etiquetas de App Hub, consulta Servicios y cargas de trabajo compatibles con Application Monitoring.

Si los datos de métricas están incompletos, haz lo siguiente:

1. Asegúrate de que el selector de proyectos esté configurado en tu proyecto host de App Hub o en el proyecto de administración de tu carpeta habilitada para apps.

2. Asegúrate de que el administrador de la organización haya configurado el alcance de las métricas para tu proyecto host de App Hub o el proyecto de administración de tu carpeta habilitada para apps para enumerar los proyectos que almacenan los datos de métricas de tu aplicación. Para obtener más información, consulta Configura Application Monitoring.

Faltan datos de registro de tu aplicación o están incompletos

El panel de registros de un panel no muestra ninguna entrada de registro o no muestra todas las entradas de registro que genera tu aplicación.

Para resolver esta falla, haz lo siguiente:

1. Para obtener los permisos que necesitas para ver los datos de registro, pídele a tu administrador que te otorgue los siguientes roles de IAM:

   • Visor de registros (roles/logging.viewer) en tu proyecto host de App Hub o en el proyecto de administración de tu carpeta habilitada para apps y cualquier otro proyecto que aparezca en su ámbito de registros predeterminado. Este rol otorga acceso a la mayoría de las entradas de registro en el _Default bucket de registros. Para obtener más información, consulta Roles de Logging.
   • Acceso a la vista de registros (roles/logging.viewAccessor) en las vistas de registros que aparecen en el ámbito de registros predeterminado de tu proyecto host de App Hub o en el proyecto de administración de tu carpeta habilitada para apps. Para obtener más información sobre cómo otorgar acceso a una vista de registros, consulta Controla el acceso a una vista de registros.

2. Asegúrate de que el administrador de la organización haya configurado el ámbito de registros predeterminado de tu proyecto host de App Hub o el proyecto de administración de tu carpeta habilitada para apps para enumerar los recursos que almacenan los datos de registro de tu aplicación. Para obtener más información, consulta Configura Application Monitoring.

Faltan tus políticas de alertas

Para los servicios y las cargas de trabajo registrados, los paneles y el mapa de topología muestran incidentes solo cuando la política de alertas correspondiente contiene etiquetas específicas de la aplicación. Estas son las etiquetas que agregas a la política. Para los servicios y las cargas de trabajo detectados, el mapa de topología muestra incidentes mediante el filtrado de etiquetas de recursos.

Para asociar una política de alertas con una carga de trabajo o un servicio mediante la Google Cloud consola, haz lo siguiente:

1. En la Google Cloud consola de, ve a la notifications Alertas página:

   Ir a las Alertas

   Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuyo subtítulo es Monitoring.

2. En la barra de herramientas de la Google Cloud consola, selecciona tu proyecto host de App Hub o el proyecto de administración de tu carpeta habilitada para apps.
3. Busca la política de alertas, haz clic en more_vert Ver más, selecciona Editar y, luego, ve a la sección Notificaciones y nombre.

4. En la sección Etiquetas de la aplicación , selecciona tu aplicación y, luego, tu servicio o carga de trabajo:

   

5. Haz clic en Guardar política.

Después de completar estos pasos, las etiquetas con las siguientes claves se adjuntan a tu política de alertas. Estas etiquetas identifican tu aplicación y tu servicio o carga de trabajo:

• apphub_application_location
• apphub_application_id
• apphub_service_id o apphub_workload_id

También puedes agregar etiquetas de usuario a una política de alertas con Google Cloud CLI, Terraform o la API de Cloud Monitoring. Sin embargo, debes usar las claves de etiqueta que se muestran en el ejemplo anterior. Para obtener más información, consulta lo siguiente:

• Administra las políticas de alertas según la API.
• Administra las políticas de alertas con Terraform.

Agregaste etiquetas de aplicación a tu política de alertas, pero la política no aparece en la lista

Para resolver esta falla, verifica que la política incluya las siguientes etiquetas:

• apphub_application_location
• apphub_application_id
• apphub_service_id o apphub_workload_id

Los paneles de tus servicios y cargas de trabajo difieren

No hay ninguna acción que realizar.

Los recursos que usa un servicio o una carga de trabajo determinan qué datos se muestran para ese servicio o carga de trabajo.

No puedes guardar los cambios en el panel que estás viendo

Estás explorando los datos que se muestran en un panel de servicio o carga de trabajo y deseas guardar los cambios. La barra de herramientas muestra un botón Guardar en el panel. Sin embargo, cuando seleccionas ese botón, no puedes guardar los cambios en tu panel actual.

El botón Guardar en el panel solo se muestra cuando el panel que estás viendo es de solo lectura. Sin embargo, puedes usar este botón para guardar los cambios en un panel personalizado. Para obtener más información, consulta Descripción general de los paneles.

No puedes guardar tu gráfico

Cuando exploras datos de telemetría, en la barra de herramientas, el botón Guardar en el panel está inhabilitado.

Para resolver esta falla, asegúrate de tener los permisos suficientes.

Para obtener los permisos que necesitas para guardar los cambios en un panel personalizado, pídele a tu administrador que te otorgue el rol de IAM de editor de Monitoring (roles/monitoring.editor) en tu proyecto host de App Hub o en el proyecto de administración de tu carpeta habilitada para apps.

Se abren incidentes inesperados

Con el lanzamiento de Application Monitoring, la etiqueta metadata.system_labels.apphub_host_project_id se cambió a metadata.system_labels.apphub_application_container. Este cambio puede generar algunos incidentes nuevos y que no se cierren algunos incidentes abiertos. Por ejemplo, para las políticas de ausencia de métricas, es posible que recibas una notificación porque el cambio en las etiquetas puede hacer que una serie temporal supervisada deje de informar muestras.

No hay ninguna acción que realizar. Los incidentes se cierran automáticamente cuando los datos dejan de llegar, después de que vence la duración de cierre automático. Para obtener más información, consulta Datos de métricas parciales.

No puedes acceder a los registros en tu carpeta habilitada para apps

Seleccionaste una carpeta habilitada para apps con el selector de recursos en la consola. Google Cloud Luego, abres una página de Google Cloud Observability, como la página Explorador de registros , y el selector de recursos se restablece a un proyecto.

El comportamiento es el esperado. Cuando seleccionas una carpeta habilitada para apps y, luego, accedes a una página de Google Cloud Observability, el recurso seleccionado se restablece al proyecto de administración de la carpeta. Por lo general, deseas que se seleccione el proyecto cuando deseas ver los datos de telemetría de una aplicación.

Para acceder a los registros en la carpeta habilitada para apps, usa el selector de recursos para seleccionar la carpeta de forma manual.

No ves bordes en el mapa de topología de tu aplicación

Puedes ver los servicios y las cargas de trabajo de tu aplicación visualizados en el mapa de topología de Application Monitoring, pero no ves ningún borde que los conecte. También es posible que veas un mensaje similar a "No se detectaron conexiones de seguimiento para el gráfico de topología. Instrumenta para Trace para habilitar la experiencia de topología completa".

Los bordes del mapa de topología representan el tráfico en tu aplicación y se generan a partir de datos de Cloud Trace. Para resolver este problema, realiza las siguientes acciones:

1. Configura tu aplicación para usar Trace:

   • Instrumenta tu aplicación para usar OpenTelemetry. Para obtener más información, consulta Instrumentar para Trace.

   • Envía tus seguimientos con el extremo de OTLP. Para obtener más información, consulta Migra del exportador de Trace al extremo de OTLP.

2. Verifica que hayas configurado y establecido el permiso de seguimiento predeterminado. Para obtener más información, consulta Configura Application Monitoring.

3. Verifica que los intervalos de seguimiento de tu aplicación estén etiquetados con atributos de recursos específicos de la aplicación. Para obtener más información, consulta Agrega atributos de aplicación a los intervalos de seguimiento.