Visualiza los datos de telemetría de las aplicaciones

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, además de información sobre incidentes abiertos. Los paneles de aplicaciones proporcionan información como la ubicación, la criticidad y los propietarios. Los paneles de servicios y cargas de trabajo incluyen información sobre los tipos de infraestructura y App Hub.

Para ver los datos de seguimiento, usa el Explorador de Trace. Para obtener más información, consulta la sección Explora los datos de seguimiento de este documento.

Etiquetas específicas de la aplicación

En esta sección, se enumeran las etiquetas y los atributos específicos de App Hub que se pueden adjuntar a tus datos de registro, métricas y seguimiento. Estas etiquetas permiten que Google Cloud Observability construya la jerarquía de los paneles listos para usar y filtre la telemetría mostrada para que se corresponda con la de un servicio o una carga de trabajo. También puedes usar estas etiquetas para filtrar tus datos de registro, métricas y seguimiento.

Las etiquetas o los atributos específicos de la aplicación se adjuntan a los datos de registro, métricas y seguimiento cuando la aplicación registrada se ejecuta en la infraestructura compatible con la Supervisión de aplicaciones. Los datos de métricas de Prometheus también incluyen etiquetas de aplicación para algunas configuraciones 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 cuándo se adjuntan etiquetas específicas de la aplicación a los datos de métricas generados por los recursos Google Cloud y a las métricas de Prometheus transferidas a través de Google Cloud Managed Service para Prometheus. En el siguiente ejemplo, interpreta a.b.{x,y} como a.b.x y a.b.y.

Las siguientes etiquetas de la aplicación App Hub se adjuntan a los datos de métricas de los recursos de Google Cloud 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 la 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 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 las instrucciones de OTLP Kubernetes Ingest

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}

Atributos de recursos de Trace

Los siguientes atributos de recursos específicos de la aplicación se pueden adjuntar a los datos de seguimiento:

  • gcp.apphub.application.{container,id,location}
  • gcp.apphub.{workload,service}.{criticality_type,environment_type,id}

Los atributos de recursos específicos de la aplicación se adjuntan a los datos de seguimiento cuando se cumplen las siguientes condiciones:

  • Tus aplicaciones de App Hub usan recursos Google Cloud compatibles.
  • Instrumentas una aplicación con OpenTelemetry y envías los datos de seguimiento recopilados de tu aplicación a tu proyecto con el Google Cloud extremo de OTLP.
  • Los datos que se envían a tu proyecto incluyen atributos de recursos de OpenTelemetry que identifican los recursos Google Cloud compatibles que usa tu aplicación. Los atributos deben incluir lo siguiente:
    • cloud.account.id
    • Uno de cloud.{availability_zone,region}

    • Son atributos específicos del recurso. Por ejemplo, para una carga de trabajo de Kubernetes, los intervalos deben tener establecidos los campos k8s.cluster.name, k8s.namespace y el tipo de implementación de Kubernetes.

      Puedes usar procesadores para que el recopilador de OpenTelemetry adjunte atributos específicos del recurso a tus intervalos. Para obtener más información, consulta resourcedetectionprocessor y k8sattributesprocessor.

    Cuando instrumentas una aplicación, Google Cloud Observability usa los atributos de recursos anteriores y la API de App Hub para identificar tu aplicación de App Hub. Las etiquetas específicas de la aplicación se agregan a los datos de seguimiento cuando se identifica una aplicación.

Para obtener más información sobre estos atributos, consulta Google Cloud Convenciones semánticas de App Hub.

Etiquetas de políticas de alertas

Las etiquetas de servicio y carga de trabajo no se adjuntan automáticamente a las políticas de alertas. Sin embargo, puedes asociar una política de alertas a 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 a un servicio o una carga de trabajo.

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

Cloud Logging admite carpetas como recurso. Por ejemplo, puedes crear receptores 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 usar Application Monitoring, 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 datos de registros y métricas, y para 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 host de tu 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 registro.
    • 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.
    • 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 la app Para las entidades principales que no necesitan crear ni modificar políticas de alertas o paneles, considera otorgar el rol de Visualizador de Monitoring (roles/monitoring.viewer).
    • Usuario de Cloud Trace (roles/cloudtrace.user) en tu proyecto host de App Hub o en el proyecto de administración de tu carpeta habilitada para la app, y en los proyectos del alcance de seguimiento predeterminado
    • Visualizador de App Hub (roles/apphub.viewer) en tu proyecto host de App Hub o en el proyecto de administración de tu carpeta habilitada para la app 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.

  • Verifica que hayas configurado el alcance de observabilidad de tu proyecto host de App Hub o del 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 observabilidad controla qué datos están disponibles para el proyecto host de tu App Hub o el proyecto de administración de tu carpeta habilitada para apps. Es posible que la configuración predeterminada de estos permisos no te permita ver todos los datos de registro o de 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 a un servicio o una carga de trabajo.

Ver el resumen de todas las solicitudes

El panel OOTB de nivel superior proporciona un resumen conciso del estado de tus aplicaciones registradas. En el caso de 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 OOTB de nivel superior, que muestra información de resumen de las aplicaciones registradas en App Hub, haz lo siguiente:

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

    Ir 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. Opcional: Para abrir una aplicación en App Hub, haz clic en Más y selecciona Administrar en App Hub.

  4. Para abrir el panel OOTB 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 OOTB de nivel superior para 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 el origen de la falla sea la infraestructura y no tu aplicación.

Para abrir el panel OOTB de una aplicación, haz lo siguiente:

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

    Ir 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.

    Se abrirá el panel OOTB para 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 clave:

    • Tráfico: Porcentajes de solicitudes entrantes en el servicio o la carga de trabajo durante el período seleccionado.
    • Tasa de errores del servidor: Es el porcentaje promedio de solicitudes entrantes que generan o se asignan a códigos de respuesta HTTP 5xx durante el período seleccionado.
    • Latencia del percentil 95: Percentil 95 de la latencia de una solicitud atendida durante el período seleccionado, en milisegundos.
    • Saturación: Mide qué tan completo está tu servicio o carga de trabajo. Por ejemplo, para los grupos de instancias administrados (MIG), Cloud Run y las implementaciones de Google Kubernetes Engine, este campo muestra la utilización de la CPU.

    En la pestaña Descripción general, puedes realizar todas las siguientes acciones:

    • Restablece el intervalo de tiempo. Cuando abres el panel, el intervalo de tiempo se establece en la hora más reciente.
    • Ver información sobre la aplicación, como el operador, el desarrollador y los propietarios de la empresa
    • Abre la aplicación, el servicio o la 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 sobre registros, métricas e incidentes. La pestaña está configurada para superponer anotaciones de eventos en tus gráficos. Las anotaciones pueden ayudarte a correlacionar datos de diferentes fuentes cuando solucionas un problema. Para ver qué anotaciones están habilitadas, haz clic en Anotaciones en la barra de herramientas.

    La pestaña también contiene filtros que puedes usar para restringir los datos que se muestran. Para obtener más información sobre cómo explorar los datos que se muestran en esta pestaña, consulta las siguientes secciones de este documento:

Cómo filtrar un panel

En la pestaña Panel, se muestran los datos de los servicios y las cargas de trabajo en una aplicación. Sin embargo, puedes filtrar este panel para que muestre un servicio específico o 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 de la lista.

Explora los datos de registro

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

En las secciones Registros de la aplicación y Registros de un panel, se muestran las entradas de registro que coinciden con un filtro y que almacenan los recursos que se indican en el alcance de registro predeterminado de tu proyecto host de App Hub o en el proyecto de administración de tu carpeta habilitada para aplicaciones. 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 panel desplegable o la página Explorador de registros. Ambas opciones te permiten escribir y ejecutar búsquedas, y cambiar el alcance. Sin embargo, la ventana emergente conserva tu contexto actual y te permite guardar los resultados de la exploración en un panel personalizado:

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

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

    El menú desplegable no muestra los filtros que se muestran con 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 las entradas de registro que coinciden con etiquetas de aplicación específicas y que se encuentran 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 clave de rendimiento y otros datos de métricas relevantes para los recursos que usan tu aplicación, servicio o carga de trabajo. Los datos que se muestran se pueden almacenar en cualquier proyecto que se incluya en el alcance de las métricas del proyecto host de App Hub o en el proyecto de administración de la 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ú desplegable 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, la ventana emergente conserva tu contexto actual:

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

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

  • 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 Incidentes de los paneles, se enumeran los incidentes recientes de las políticas de alertas asociadas a 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 la carpeta habilitada para apps.

Si no ves ninguna entrada en la sección Incidentes, significa que no tienes ninguna política de alertas asociada a 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 a un servicio o una carga de trabajo.

Para obtener más información sobre tus incidentes y políticas de alertas, haz lo siguiente:

  • Para encontrar 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 del Explorador. Se abrirá un menú desplegable en el que se enumeran todas las políticas. Para volver al panel, haz clic en Cancelar.

Explora los datos de seguimiento

Los paneles listos para usar no muestran datos de seguimiento. Sin embargo, puedes ver los datos de seguimiento de una aplicación, un servicio o una carga de trabajo en la página del Explorador de registros. Cuando abres esta página, los datos de seguimiento almacenados en los proyectos que se indican en el alcance de seguimiento predeterminado se recuperan del almacenamiento. Los datos que se muestran dependen de tus roles de IAM en esos proyectos, la configuración del período y los filtros que apliques. Para obtener información sobre cuándo tus datos de seguimiento contienen atributos de la aplicación, consulta Atributos de recursos de seguimiento.

Para ver los datos de seguimiento de tu aplicación, haz lo siguiente:

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

    Ve al Explorador de seguimiento

    También puedes usar la barra de búsqueda para encontrar esta página.

  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. Aplica filtros para restringir los datos de registro:

    • Para filtrar por aplicación, usa el filtro de intervalo Aplicación de App Hub.
    • Para filtrar por servicio, usa el filtro de intervalo Servicio de App Hub.
    • Para filtrar por carga de trabajo, usa el filtro de intervalo Carga de trabajo de App Hub.
    • Para agregar un filtro personalizado, selecciona Agregar filtro en la barra de herramientas, luego Agregar filtro de atributo y, por último, completa el diálogo. La sintaxis del campo Key debe coincidir con la sintaxis de la clave de un atributo en un tramo. Por ejemplo, para filtrar por el identificador del host, ingresa host.id.

    Para obtener información sobre cómo usar la interfaz de seguimiento, consulta Busca y explora seguimientos.

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

Se proporciona un panel OOTB para cada servicio y carga de trabajo. Estos paneles muestran información sobre 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 en 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 OOTB 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:

    Ir 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 registros, métricas y problemas del servicio o la carga de trabajo que seleccionaste. En el caso de las cargas de trabajo, el panel está configurado para superponer anotaciones de eventos en tus gráficos. Las anotaciones pueden ayudarte a correlacionar datos de diferentes fuentes cuando solucionas un problema. Para ver qué anotaciones están habilitadas, haz clic en Anotaciones en la barra de herramientas.

    La tarjeta de resumen muestra información general y el tipo de infraestructura. Cuando no se puede identificar el tipo de infraestructura, este campo muestra texto genérico, como Servicio de App Hub. Para obtener más información, consulta Infraestructura compatible con Application Monitoring.

    Para obtener información sobre cómo explorar los datos en un panel de servicios o cargas de trabajo, consulta las siguientes secciones de este documento:

Crea un panel personalizado

Google Cloud Observability admite la creación de paneles personalizados, lo que te permite tener control total sobre el contenido del panel. Los paneles personalizados se enumeran en la página Paneles de la consola de Google Cloud y se pueden copiar, editar y borrar. También pueden ser el destino donde guardas un widget del panel que configuraste. Por ejemplo, si exploras un gráfico en un panel de aplicaciones, 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, la siguiente información puede ser útil:

Asocia una política de alertas a 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 en los incidentes. Para obtener más información sobre las etiquetas, consulta Anota incidentes con etiquetas.

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:

Solucionar problemas

Para obtener información que puede ayudarte a comprender los datos que ves o por qué un panel no muestra datos, consulta Soluciona problemas de Application Monitoring.