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 Supervisión de aplicaciones. También contiene información que puede ayudarte a configurar tu proyecto de Google Cloud para que puedas ver los datos de tu aplicación.

Problemas conocidos

En esta sección, se enumeran los problemas conocidos relacionados con el Monitoreo de aplicaciones:

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 Supervisión de aplicaciones en la consola de Google Cloud y ves el mensaje "Crea una aplicación para comenzar". No esperas ver este mensaje porque registraste una aplicación de App Hub.

Para resolver este error, 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 aplicaciones.

Tu aplicación no muestra datos para algunos indicadores clave de rendimiento

Existen varios motivos por los que no verás un valor para un indicador clave de rendimiento:

  • 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 la Supervisión de aplicaciones.

  • 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 habrá datos para mostrar en los indicadores clave.

Para obtener una lista de los recursos que generan etiquetas de App Hub, consulta Servicios y cargas de trabajo compatibles con la Supervisión de la aplicación.

Los datos de las métricas de tu aplicación están incompletos o no existen

Ves un gráfico de 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 que se agregan 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 la Supervisión de la aplicación.

Si los datos de la métrica 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 permiso de métricas para tu proyecto host de App Hub o el proyecto de administración de tu carpeta habilitada para aplicaciones para enumerar los proyectos que almacenan los datos de métricas de tu aplicación. Para obtener más información, consulta Cómo configurar la supervisión de aplicaciones.

Faltan los 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 este error, 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:

    • Visualizador de registros (roles/logging.viewer) en el proyecto host de App Hub o en el proyecto de administración de tu carpeta habilitada para la app y cualquier otro proyecto que aparezca en su alcance de registros predeterminado Este rol otorga acceso a la mayoría de las entradas de registro en el bucket de registros _Default. Para obtener más información, consulta Roles de Logging.
    • Logs View Accessor (roles/logging.viewAccessor) en las vistas de registros que se enumeran 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 alcance predeterminado del registro de tu proyecto host de App Hub o el proyecto de administración de tu carpeta habilitada para la app para enumerar los recursos que almacenan los datos de registro de tu aplicación. Para obtener más información, consulta Cómo configurar la supervisión de aplicaciones.

Faltan tus políticas de alertas

Para que una política de alertas se muestre en un panel de supervisión de aplicaciones, debes asociarla con un servicio o una carga de trabajo agregando etiquetas específicas a la política.

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

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

    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 consola deGoogle Cloud , 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 Ver más, selecciona Editar y, luego, ve a la sección Notificaciones y nombre.
  4. En la sección Etiquetas de aplicación, selecciona tu aplicación y, luego, tu carga de trabajo o servicio.
  5. Haz clic en Guardar política.

Después de completar estos pasos, se adjuntarán etiquetas con las siguientes claves 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:

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

Para resolver este error, 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 son diferentes

No es necesario que realices ninguna acción.

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 servicios o cargas de trabajo y quieres guardar los cambios. En la barra de herramientas, se muestra un botón Save to dashboard. Sin embargo, cuando seleccionas ese botón, no puedes guardar los cambios en tu panel actual.

El botón Save to dashboard 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, el botón Guardar en el panel está inhabilitado en la barra de herramientas.

Para resolver este error, asegúrate de tener los permisos necesarios.

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 Editor de Monitoring (roles/monitoring.editor) en el proyecto host de App Hub o en el proyecto de administración de tu carpeta habilitada para la app.

Se abren incidentes inesperados

Con el lanzamiento de Application Monitoring, se cambió el nombre de la etiqueta metadata.system_labels.apphub_host_project_id a metadata.system_labels.apphub_application_container. Este cambio podría generar incidentes nuevos y que no se cierren algunos incidentes abiertos. Por ejemplo, en el caso de 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 es necesario que realices ninguna acción. Los incidentes se cierran automáticamente cuando dejan de llegar datos, después de que vence la duración del cierre automático. Para obtener más información, consulta Datos de métricas parciales.

No puedes acceder a los registros en la carpeta habilitada para la app

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

El comportamiento es intencional. 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, querrás seleccionar el proyecto cuando desees ver los datos de telemetría de una aplicación.

Para acceder a los registros en la carpeta habilitada para la app, 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 tus servicios y cargas de trabajo de la aplicación visualizados en el mapa de topología de Application Monitoring, pero no ves ninguna arista 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 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 los datos de Cloud Trace. Para resolver este problema, realiza las siguientes acciones:

  1. Configura tu aplicación para usar Trace:

  2. Verifica que hayas configurado y establecido el alcance de seguimiento predeterminado. Para obtener más información, consulta Configura la supervisión de aplicaciones.

  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 Cómo agregar atributos de la aplicación a los intervalos de seguimiento.