Consulta la telemetría de la aplicación

En este documento, se describe cómo ver los paneles listos para usar (OOTB) de tus aplicaciones, servicios y cargas de trabajo de App Hub. Estos paneles pueden ayudarte a comprender el rendimiento de los recursos de tu aplicación y a diagnosticar problemas.

La telemetría que muestran estos paneles listos para usar incluye datos de registros y métricas, y también información sobre incidentes abiertos. Los paneles de aplicaciones proporcionan información como la ubicación, la criticidad y los propietarios. Los paneles de servicio y carga de trabajo incluyen información sobre App Hub y los tipos de infraestructura.

Etiquetas específicas de la aplicación

Las etiquetas específicas de App Hub permiten que la Observabilidad de Google Cloud construya la jerarquía de los paneles listos para usar y filtre la telemetría que se muestra a la de un servicio o una carga de trabajo. También puedes usar estas etiquetas para filtrar los datos de registro y métricas. Estas etiquetas se adjuntan cuando tu aplicación se ejecuta en Google Cloud recursos que están integrados en App Hub. Es posible que estas etiquetas se adjunten cuando se transfieran las métricas de Google Cloud Managed Service para Prometheus.

Etiquetas de registro

Las entradas de registro contienen un campo apphub que enumera las etiquetas de la aplicación y de un servicio o una carga de trabajo. A continuación, se ilustra el formato de estos datos:

apphub: {
  application: {
    id: "my-app"
    location: "my-app-location"
  }
  workload: {
    criticalityType: "MEDIUM"
    environmentType: "STAGING"
    id: "my-workload-id"
  }
}

Etiquetas de métricas

En esta sección, se describe cómo se adjuntan las etiquetas específicas de la aplicación a los datos de métricas que generan los recursos de Google Cloud y a las métricas de Prometheus transferidas a través de Google Cloud Managed Service para Prometheus. A continuación, interpreta a.b.{x,y} como a.b.x y a.b.y.

Las siguientes etiquetas de App Hub se adjuntan a los datos de métricas de los Google Cloud recursos que usa tu aplicación:

  • metadata.system_labels.apphub_application_{container,id,location}
  • metadata.system_labels.apphub_{workload,service}_{criticality_type,environment_type,id}

Las etiquetas de aplicación de App Hub se adjuntan a las métricas de Google Cloud Managed Service para Prometheus cuando se cumple alguna de las siguientes condiciones:

  • Una carga de trabajo se ejecuta en un clúster de Google Kubernetes Engine con la versión 1.30 o una posterior, y el tipo de controlador de la carga de trabajo es uno de los siguientes:

    • apps.k8s.io/{Deployment,StatefulSet,DaemonSet}
    • batch.k8s.io/CronJob

  • Cuando usas OpenTelemetry en Cloud Run.

  • Cuando usas OpenTelemetry en Google Kubernetes Engine y sigues la guía de transferencia de datos de Kubernetes a OTLP

El servicio administrado para Prometheus usa la API de App Hub para determinar si existe una aplicación de App Hub. Cuando se encuentra una aplicación, se agregan las siguientes etiquetas específicas de la aplicación a tus datos de seguimiento:

  • metric.labels.apphub_application_{container,id,location}
  • metric.labels.apphub_workload_{criticality_type,environment_type,id}

Etiquetas de políticas de alertas

Las etiquetas de servicios y cargas de trabajo no se adjuntan automáticamente a las políticas de alertas. Sin embargo, puedes asociar una política de alertas con una carga de trabajo o un servicio específicos si adjuntas todas las siguientes etiquetas con las siguientes claves a la política de alertas:

  • apphub_application_location
  • apphub_application_id
  • apphub_service_id o apphub_workload_id

Cuando una política de alertas incluye las claves anteriores, los incidentes de la política se muestran en los paneles listos para usar.

Para obtener más información, consulta Cómo asociar una política de alertas con un servicio o una carga de trabajo.

La consola de Google Cloud restablece automáticamente el selector de recursos de una carpeta habilitada para apps al proyecto de administración de la carpeta cuando se abre una página de Observabilidad de Google Cloud.

Cloud Logging admite carpetas como recurso. Por ejemplo, puedes crear sinks de registros y buckets de registros en un recurso de carpeta. Del mismo modo, las carpetas contienen buckets de registros _Default y _Required, y es posible que desees ver su contenido. Para acceder al recurso de la carpeta, usa el selector de recursos y selecciona manualmente la carpeta habilitada para la app.

Antes de comenzar

Antes de poder usar la Supervisión de la aplicación, asegúrate de configurar tu proyecto host de App Hub o el proyecto de administración de tu carpeta habilitada para apps. Este es el proyecto que usas para ver los datos de telemetría de tu aplicación:

  • Para obtener los permisos que necesitas para ver los datos de registro y métricas, y crear políticas de alertas y personalizar paneles, pídele a tu administrador que te otorgue los siguientes roles de IAM:

    • Visualizador de registros (roles/logging.viewer) en el proyecto de host de App Hub o en el proyecto de administración de tu carpeta habilitada para apps, y en cualquier otro proyecto que haya indicado su alcance de registro predeterminado Este rol otorga acceso a la mayoría de las entradas de registro en el bucket de registro _Default. Para obtener más información, consulta Roles de registro.
    • Acceso a la vista de registros (roles/logging.viewAccessor) en las vistas de registros que se enumeran en el ámbito de registro predeterminado de tu proyecto host de App Hub o 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.
    • Editor de Monitoring (roles/monitoring.editor) en el proyecto host deApp Hub o en el proyecto de administración de tu carpeta habilitada para apps. En el caso de los directores que no necesitan crear ni modificar políticas de alertas ni paneles, considera otorgarles el rol de Visualizador de Monitoring (roles/monitoring.viewer).
    • Visualizador de App Hub en 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, consulta Roles y permisos de App Hub.

    Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

    También puedes obtener los permisos necesarios mediante roles personalizados o cualquier otro rol predefinido.

  • Asegúrate de haber configurado el alcance de la observabilidad de tu proyecto de host de App Hub o el proyecto de administración de tu carpeta habilitada para apps. Para obtener más información, consulta Cómo configurar la supervisión de aplicaciones.

    El alcance de la observabilidad controla qué datos están disponibles para tu proyecto de host de App Hub o el proyecto de administración de tu carpeta habilitada para apps. Es posible que la configuración predeterminada de estos alcances no te permita ver todos los datos de registro o métricas.

  • Actualiza las políticas de alertas que supervisan los datos de tu aplicación para incluir etiquetas específicas de la aplicación. Para obtener más información, consulta Cómo asociar una política de alertas con un servicio o una carga de trabajo.

Ver el resumen de todas las solicitudes

El panel listo para usar de nivel superior proporciona un resumen conciso del estado de tus aplicaciones registradas. Para cada aplicación, esta página muestra la cantidad de incidentes abiertos y la información sobre la ubicación, la gravedad y el entorno.

Para abrir el panel listo para usar de nivel superior, que muestra información de resumen de tus aplicaciones registradas en App Hub, haz lo siguiente:

  1. En la consola de Google Cloud, ve a la página Supervisión de aplicaciones:

    Ve a Supervisión de aplicaciones.

    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 de Google Cloud, selecciona el proyecto host de App Hub o el proyecto de administración de tu carpeta habilitada para apps.

  3. Opcional: Para abrir una aplicación en App Hub, haz clic en Más y selecciona Administrar en AppHub.

  4. Para abrir el panel listo para usar de una aplicación, selecciónala. En la siguiente sección, se proporciona orientación para explorar o interpretar la telemetría.

Explora la telemetría y los incidentes de la aplicación

Cuando seleccionas una aplicación que aparece en la página Supervisión de aplicaciones, se abre el panel listo para usar de nivel superior de la aplicación. Este panel te ayuda a comprender el estado de tu aplicación, ya que resume la cantidad de incidentes abiertos y muestra los valores de varios indicadores clave. Por ejemplo, si esta página muestra fallas generalizadas, es posible que la fuente de la falla sea la infraestructura y no tu aplicación.

Para abrir el panel listo para usar de una aplicación, haz lo siguiente:

  1. En la consola de Google Cloud, ve a la página Supervisión de aplicaciones:

    Ve a Supervisión de aplicaciones.

    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 de Google Cloud, selecciona el proyecto host de App Hub o el proyecto de administración de tu carpeta habilitada para apps.

  3. En la página Supervisión de aplicaciones, selecciona el nombre de una aplicación.

    Se abrirá el panel listo para usar de la aplicación con la pestaña Overview seleccionada. En esta pestaña, se enumeran cada servicio y carga de trabajo, junto con la cantidad de incidentes abiertos y los valores de los indicadores de calidad:

    • Tráfico: Porcentaje de solicitudes entrantes en el recurso durante el período seleccionado.
    • Tasa de errores del servidor: Es el porcentaje promedio de solicitudes entrantes que generan o asignan códigos de error HTTP de la serie 5xx durante el período seleccionado.
    • Latencia de P95: Es el percentil 95 de la latencia de una solicitud de servicio agregada durante el período seleccionado, en milisegundos.
    • Saturación: Mide qué tan “completo” está tu servicio o carga de trabajo. Para los servicios y las cargas de trabajo que dependen de recursos basados en el procesamiento, como los grupos de instancias administradas (MIG), Cloud Run y las implementaciones de Google Kubernetes Engine, este campo muestra la utilización de la CPU.

    En la pestaña Resumen, puedes hacer lo siguiente:

    • Restablece el intervalo de tiempo. Cuando abres el panel, el intervalo de tiempo se establece en la hora más reciente.
    • Consulta información sobre la aplicación, como el operador, el desarrollador y los propietarios de la empresa.
    • Abre la aplicación, un servicio o una carga de trabajo en App Hub.
    • Abre el panel de un servicio o una carga de trabajo.

  4. Para ver la telemetría de la aplicación y la información sobre los incidentes abiertos, selecciona la pestaña Panel.

    En la pestaña Panel, se muestra información de registro, métrica e incidente. Esta pestaña también contiene filtros, que puedes usar para restringir los datos que muestra. Para obtener información sobre cómo explorar esta pestaña, consulta las siguientes secciones de este documento:

Cómo filtrar un panel

La pestaña Panel muestra datos de servicios y cargas de trabajo en una aplicación. Sin embargo, puedes filtrar este panel para un servicio específico o para un conjunto de servicios.

Por ejemplo, la barra de herramientas de la pestaña Panel contiene un filtro como apphub_service_id: *. Si deseas ver los datos de servicios específicos, haz clic en Menú y, luego, selecciona esos servicios en la lista.

Explora los datos de registro

Si estás viendo la pestaña Panel de un panel de la aplicación, tus datos de registro se muestran en la sección Registros de la aplicación. De lo contrario, tus datos se muestran en la sección Registros.

Las secciones Registros de la aplicación y Registros de un panel muestran entradas de registro que coinciden con un filtro y que almacenan los recursos que se enumeran en el alcance de registro predeterminado de tu proyecto host de App Hub o el proyecto de administración de tu carpeta habilitada para apps. Para las aplicaciones, el filtro es similar al siguiente:

-- Application logs
(apphub_application_location=global)
(apphub_application_id=my-app)

En el caso de los servicios y las cargas de trabajo, el filtro contiene cláusulas adicionales. Para ver el filtro aplicado a tus datos de registro, haz clic en Mostrar consulta.

Si quieres escribir consultas, puedes abrir un menú flotante o la página Explorador de registros. Ambas opciones te permiten escribir y ejecutar consultas, y cambiar el alcance. Sin embargo, el menú flotante conserva tu contexto actual y te permite guardar los resultados de la exploración en un panel personalizado:

  • Para abrir un menú flotante, haz clic en Explorar datos.

    Cuando se complete la exploración, haz clic en Cancelar para cerrar el menú flotante y descartar los cambios. Si deseas guardar los cambios en un panel personalizado, haz clic en Guardar en el panel y completa el cuadro de diálogo. No puedes guardar los cambios en el panel que estabas viendo cuando abriste el panel flotante.

    En el menú flotante, no se muestran los filtros que muestra el botón Mostrar consulta. Esos filtros se aplican a nivel del panel y no se pueden quitar.

  • Para abrir la página Explorador de registros en una pestaña nueva del navegador, haz clic en Ver en el Explorador de registros.

    La consulta está preconfigurada para mostrar entradas de registro que coincidan con etiquetas de aplicación específicas y que se encuentren en el intervalo de tiempo especificado por el panel. Cuando cierras la pestaña del navegador, se descartan los cambios.

Para obtener más información sobre cómo explorar tus registros, consulta los siguientes documentos:

Explorar datos de métricas

Los gráficos y las tablas de tu panel muestran indicadores positivos y otros datos de métricas relevantes para los recursos que usa tu aplicación, servicio o carga de trabajo. Los datos que se muestran se pueden almacenar en cualquier proyecto que aparezca en la lista según el alcance de las métricas de tu proyecto host de App Hub o el proyecto de administración de tu carpeta habilitada para apps.

En cualquier gráfico o tabla que muestre datos de métricas, puedes ver detalles como el tipo de métrica y las opciones de agregación. Para ver esta información, ve a la barra de herramientas de un gráfico o una tabla y, luego, haz clic en Información.

Para explorar un gráfico o una tabla con más detalle, puedes abrir un menú flotante o la página del Explorador de métricas. Ambas opciones te permiten probar diferentes parámetros de configuración del gráfico y guardar los resultados en un panel personalizado. Sin embargo, el menú flotante conserva tu contexto actual:

  • Para abrir un menú flotante, haz clic en Explorar datos.

    Cuando se complete la exploración, haz clic en Cancelar para cerrar el menú flotante y descartar los cambios. Si deseas guardar los cambios en un panel personalizado, haz clic en Guardar en el panel y completa el cuadro de diálogo. No puedes guardar los cambios en el panel que estabas viendo cuando abriste el panel flotante.

  • Para ver el gráfico o la tabla en el Explorador de métricas, ve a la barra de herramientas, haz clic en Más y, luego, selecciona Ver en el Explorador de métricas.

    Ahora tienes un gráfico temporal que puedes modificar y explorar. Por ejemplo, puedes cambiar las opciones de agregación o el estilo de visualización. Para guardar tu gráfico en un panel personalizado, haz clic en Guardar en el panel y completa el

Explora incidentes

En la sección Alertas de los paneles, se enumeran los incidentes recientes de las políticas de alertas asociadas con un servicio o una carga de trabajo. Estas políticas de alertas deben almacenarse en el proyecto host de App Hub o en el proyecto de administración de tu carpeta habilitada para apps.

Si no ves ninguna entrada en la sección Alertas, significa que no tienes ninguna política de alertas asociada con un servicio o una carga de trabajo. Para crear esta asociación, agrega etiquetas a la política. Para obtener más información, consulta Cómo asociar una política de alertas con un servicio o una carga de trabajo.

Para obtener más información sobre tus incidentes y políticas de alertas, sigue estos pasos:

  • Para obtener detalles sobre la política de alertas que causó el incidente, haz clic en el nombre de la política. En el panel que se abre, se muestra información detallada sobre la política de alertas, incluido un gráfico que muestra los datos supervisados y las etiquetas.

  • Para ver todas las políticas de alertas asociadas con la aplicación, ve a la barra de herramientas y haz clic en Datos de Explorer. Se abrirá un menú flotante con una lista de todas las políticas. Para volver al panel, haz clic en Cancelar.

Explora la telemetría y los incidentes del servicio o de la carga de trabajo

Se proporciona un panel listo para usar para cada servicio y carga de trabajo. Estos paneles muestran información de registros, métricas e incidentes, y pueden ayudarte a comprender el estado de un servicio o una carga de trabajo específicos. Puedes explorar los datos de estos paneles listos para usar de manera similar a como exploras los datos que se muestran en la pestaña Panel de una aplicación.

Para abrir el panel listo para usar de un servicio o una carga de trabajo, haz lo siguiente:

  1. En la consola de Google Cloud, ve a la página Supervisión de aplicaciones:

    Ve a Supervisión de aplicaciones.

    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 de Google Cloud, selecciona tu proyecto host de App Hub o el proyecto de administración de tu carpeta habilitada para apps.

  3. En la página Supervisión de aplicaciones, selecciona el nombre de una aplicación y, luego, un servicio o una carga de trabajo.

    En un panel, se muestra la información de registro, métrica y incidente del servicio o la carga de trabajo que seleccionaste. Para obtener información sobre cómo explorar estos datos, consulta las siguientes secciones de este documento:

Crea un panel personalizado

Google Cloud Observability admite la creación de paneles personalizados, que te permiten tener control total sobre el contenido del panel. Los paneles personalizados se muestran en la página Paneles de la consola de Google Cloud y se pueden copiar, editar y borrar. También pueden ser el destino en el que guardas un widget de panel que configuraste. Por ejemplo, si estás explorando un gráfico en un panel de la aplicación, puedes guardarlo en un panel personalizado. Para ello, ve a la barra de herramientas y selecciona Guardar en el panel.

Si planeas crear un panel personalizado para una aplicación, un servicio o una carga de trabajo, es posible que la siguiente información te resulte útil:

Asocia una política de alertas con una aplicación de App Hub

Para asociar una política de alertas con un servicio o una carga de trabajo, agrega etiquetas específicas de la aplicación a la política de alertas. Cuando agregas estas etiquetas, se incluyen en la política de alertas y también en cualquier incidente. Para obtener más información sobre las etiquetas, consulta Cómo anotar incidentes con etiquetas.

Para asociar una política de alertas con una carga de trabajo o un servicio con la console 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 de Google 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:

Solucionar problemas

Si deseas obtener información que te ayude a comprender qué datos estás viendo o por qué un panel no muestra datos, consulta Cómo solucionar problemas de supervisión de aplicaciones.