Ver la telemetría de la aplicación

En este documento se describe cómo ver los paneles de control predefinidos de tus aplicaciones, servicios y cargas de trabajo de App Hub. Estos paneles pueden ayudarte a entender el rendimiento de los recursos de tu aplicación y a diagnosticar problemas.

Los paneles de control predefinidos muestran lo siguiente:

Para determinar qué datos se deben mostrar en los paneles de control predefinidos, Application Monitoring usa etiquetas específicas de la aplicación que se adjuntan a la telemetría generada por la infraestructura compatible. Estas etiquetas identifican la aplicación. Puedes usar estas etiquetas para filtrar los datos que se muestran.

Los paneles de control de monitorización de aplicaciones no muestran datos de trazas. Sin embargo, puedes explorar los datos de traza de tu aplicación con Explorador de trazas. Para obtener más información, consulta la sección Explorar datos de traza de este documento.

Etiquetas específicas de aplicaciones

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

En esta sección, interpreta a.b.{x,y} como a.b.x y a.b.y.

Etiquetas de registro

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

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

Etiquetas de métricas

Los datos de métricas de la infraestructura de Google Cloud incluyen las siguientes etiquetas de metadatos:

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

Los datos de métricas de la instrumentación que hayas añadido a tus aplicaciones pueden incluir las siguientes etiquetas de métricas:

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

Atributos de recursos de traza

Los intervalos de Trace generados por la instrumentación que hayas añadido a tus aplicaciones pueden incluir los siguientes atributos de recurso:

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

Etiquetas de políticas de alertas

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

  • apphub_application_location
  • apphub_application_id
  • apphub_service_id o apphub_workload_id

Si una política de alertas incluye las claves anteriores, los incidentes de la política se muestran en los paneles de control preconfigurados.

Para obtener más información, consulta Asociar una política de alertas a un servicio o una carga de trabajo.

App Hub admite dos configuraciones: carpetas habilitadas para aplicaciones y proyectos host de App Hub. Esta sección solo se aplica cuando usas una carpeta habilitada para aplicaciones.

Cuando usas una carpeta habilitada para aplicaciones, la consola Google Cloud restablece automáticamente el selector de recursos de una carpeta habilitada para aplicaciones al proyecto de gestión de la carpeta cuando accedes a una página de Google Cloud Observability. Si te desplazas a otra página de la Google Cloud consola, el selector de recursos se restablecerá a la carpeta habilitada para la aplicación.

Cloud Logging admite carpetas como recursos. Por ejemplo, puedes crear receptores de registro y cubos de registro en un recurso de carpeta. Del mismo modo, las carpetas contienen _Default y _Required, y puede que quieras ver su contenido. Para acceder al recurso de la carpeta, usa el selector de recursos y selecciona manualmente la carpeta habilitada para la aplicación.

Antes de empezar

Antes de usar Monitorización de aplicaciones, asegúrate de configurar el proyecto host de tu App Hub o el proyecto de gestión de la carpeta en la que se ha habilitado tu aplicación. 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 registro y métricas, y para crear políticas de alertas y personalizar paneles de control, pide a tu administrador que te conceda los siguientes roles de gestión de identidades y accesos:

    • Visor de registros (roles/logging.viewer) en el proyecto host de tu centro de aplicaciones o en el proyecto de gestión de tu carpeta habilitada para aplicaciones, así como en cualquier otro proyecto que figure en su ámbito de registro predeterminado. Este rol concede acceso a la mayoría de las entradas de registro del segmento de registro _Default. Para obtener más información, consulta Roles de registro.
    • Accessor de vista de registros (roles/logging.viewAccessor) en las vistas de registros que se muestran en el ámbito de registros predeterminado de tu proyecto host App Hub o en el proyecto de gestión de tu carpeta habilitada para aplicaciones. Para obtener más información sobre cómo conceder acceso a una vista de registro, consulta Controlar el acceso a una vista de registro.
    • Editor de monitorización (roles/monitoring.editor) en el proyecto host de tu App Hub o en el proyecto de gestión de tu carpeta habilitada para aplicaciones. Si las entidades de seguridad no necesitan crear ni modificar políticas de alertas ni paneles, puede asignarles el rol Lector de Monitoring (roles/monitoring.viewer).
    • Usuario de Cloud Trace (roles/cloudtrace.user) en tu proyecto host de App Hub o en el proyecto de gestión de tu carpeta habilitada para aplicaciones, así como en los proyectos del ámbito de seguimiento predeterminado.
    • Visor de App Hub (roles/apphub.viewer) en el proyecto host de App Hub o en el proyecto de gestión de la carpeta habilitada para aplicaciones. Para obtener más información, consulta Roles y permisos de App Hub.

    Para obtener más información sobre cómo conceder roles, consulta el artículo Gestionar el acceso a proyectos, carpetas y organizaciones.

    También puedes conseguir los permisos necesarios a través de roles personalizados u otros roles predefinidos.

  • Comprueba que hayas configurado el ámbito de observabilidad de tu proyecto host de App Hub o del proyecto de gestión de tu carpeta habilitada para aplicaciones. Para obtener más información, consulta Configurar la monitorización de aplicaciones.

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

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

Ver el resumen de todas las solicitudes

El panel de control OOTB de nivel superior ofrece un resumen conciso del estado de las aplicaciones registradas. En cada aplicación, esta página muestra el número de incidentes abiertos e información sobre la ubicación, la criticidad y el entorno.

Para abrir el panel de control OOTB de nivel superior, que muestra información de resumen de las aplicaciones registradas en App Hub, sigue estos pasos:

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

    Ir a Monitorización de aplicaciones

    Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuya sección sea Monitorización.

  2. En la barra de herramientas de la Google Cloud consola, selecciona el proyecto host de App Hub o el proyecto de gestión de la carpeta habilitada para tu aplicación.

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

  4. Para abrir el panel de control preconfigurado de una aplicación, selecciona la aplicación. En la siguiente sección se explica cómo explorar o interpretar la telemetría.

Consultar la telemetría y los incidentes de las aplicaciones

Cuando selecciona una aplicación de la página Monitorización de aplicaciones, se abre el panel de control OOTB de nivel superior de la aplicación. Este panel de control te ayuda a conocer el estado de tu aplicación, ya que resume el número de incidencias abiertas y muestra los valores de varias señales de oro. Por ejemplo, si esta página muestra errores generalizados, puede indicar que la causa del error es la infraestructura y no tu aplicación.

Para abrir el panel de control preconfigurado de una aplicación, sigue estos pasos:

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

    Ir a Monitorización de aplicaciones

    Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuya sección sea Monitorización.

  2. En la barra de herramientas de la Google Cloud consola, selecciona el proyecto host de App Hub o el proyecto de gestión de la carpeta habilitada para tu aplicación.

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

    Se abre el panel de control preconfigurado de la aplicación con la pestaña Resumen seleccionada. En esta pestaña se enumeran todos los servicios y cargas de trabajo, junto con el número de incidencias abiertas y los valores de las señales de oro:

    • Tráfico: tasas de solicitudes entrantes en el servicio o la carga de trabajo durante el periodo seleccionado.
    • Tasa de errores del servidor: porcentaje medio de solicitudes entrantes que generan o se asignan a códigos de respuesta HTTP 5xx durante el periodo seleccionado.
    • Latencia del percentil 95: el percentil 95 de la latencia de una solicitud atendida durante el periodo seleccionado, expresado en milisegundos.
    • Saturación: mide el nivel de ocupación de tu servicio o carga de trabajo. Por ejemplo, en el caso de los grupos de instancias gestionados (MIGs), Cloud Run y los despliegues de Google Kubernetes Engine, este campo muestra la utilización de la CPU.

    En la pestaña Vista general, puede hacer lo siguiente:

    • Restablece el intervalo. Cuando abres el panel de control, el periodo se establece en la última hora.
    • 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 control 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 de control.

    La pestaña Panel de control muestra información sobre registros, métricas e incidencias. La pestaña está configurada para superponer anotaciones de eventos en los gráficos. Las anotaciones pueden ayudarte a correlacionar datos de diferentes fuentes cuando estés solucionando un problema. Para ver qué anotaciones están habilitadas, en la barra de herramientas, haz clic en Anotaciones.

    La pestaña también contiene filtros que puede usar para restringir los datos que muestra. 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:

Filtrar un panel de control

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

Por ejemplo, la barra de herramientas de la pestaña Panel de control contiene un filtro como apphub_service_id: *. Si quieres ver los datos de servicios específicos, haz clic en Menú y, a continuación, selecciona los servicios que quieras de la lista.

Consultar datos de registro

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

En las secciones Registros de aplicaciones y Registros de un panel de control se muestran las entradas de registro que coinciden con un filtro y que almacenan los recursos que se indican en el ámbito de registro predeterminado del proyecto host de tu centro de aplicaciones o del proyecto de gestión de tu carpeta habilitada para aplicaciones. En el caso de 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 los datos de registro, haga clic en Mostrar consulta.

Si quieres escribir consultas, puedes abrir un menú desplegable o la página Explorador de registros. Ambas opciones te permiten escribir y ejecutar consultas, así como cambiar el ámbito. Sin embargo, la ventana emergente conserva el contexto actual y te permite guardar los resultados de la exploración en un panel de control personalizado:

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

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

    En el menú desplegable no se muestran los filtros que aparecen al pulsar el botón Mostrar consulta. Estos filtros se aplican a nivel del panel de control y no se pueden quitar.

  • Para abrir la página Explorador de registros en una nueva pestaña del navegador, haz clic en Ver en 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 en el panel de control. Cuando cierras la pestaña del navegador, los cambios se descartan.

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

Consultar datos de métricas

Los gráficos y las tablas de tu panel de control muestran señales de oro y otros datos de métricas relevantes para los recursos que usan tu aplicación, servicio o carga de trabajo. Los datos mostrados se pueden almacenar en cualquier proyecto que figure en el ámbito de las métricas de tu proyecto host de App Hub o en el proyecto de gestión de tu carpeta habilitada para aplicaciones.

En cualquier gráfico o tabla que muestre datos de métricas, puede 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 haz clic en Información.

Para ver un gráfico o una tabla con más detalle, puedes abrir un menú desplegable o la página Explorador de métricas. Ambas opciones te permiten probar diferentes ajustes de gráficos y guardar los resultados en un panel de control personalizado. Sin embargo, la ventana emergente conserva el contexto actual:

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

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

  • Para ver el gráfico o la tabla en el explorador de métricas, vaya a la barra de herramientas, haga clic en Más y, a continuación, seleccione Ver en 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 el gráfico en un panel de control personalizado, haz clic en Guardar en panel y completa los

Consultar incidentes

En la sección Incidencias de los paneles de control se muestran las incidencias 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 tu centro de aplicaciones o en el proyecto de gestión de la carpeta en la que se ha habilitado la aplicación.

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, añade etiquetas a la política. Para obtener más información, consulta 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 ver los detalles de la política de alertas que ha provocado el incidente, haz clic en el nombre de la política. En el panel de control que se abre, se muestra información detallada sobre la política de alertas, incluido un gráfico con los datos monitorizados y las etiquetas.

  • Para ver todas las políticas de alertas asociadas a la aplicación, ve a la barra de herramientas y haz clic en Explorar datos. Se abre una ventana emergente con todas las políticas. Para volver al panel de control, haz clic en Cancelar.

Consultar datos de trazas

Los paneles de control predefinidos no muestran datos de traza. Sin embargo, puedes ver los datos de la traza de una aplicación, un servicio o una carga de trabajo en la página Explorador de trazas. Cuando abres esta página, los datos de traza almacenados en los proyectos que figuran en el ámbito de traza predeterminado se recuperan del almacenamiento. Los datos que se muestran dependen de los roles de gestión de identidades y accesos que tengas en esos proyectos, del intervalo de tiempo y de los filtros que apliques. Para obtener información sobre cuándo contienen atributos de aplicación los datos de seguimiento, consulta Atributos de recursos de seguimiento.

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

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

    Ir a Explorador de trazas

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

  2. En la barra de herramientas de la consola Google Cloud , selecciona tu proyecto host de App Hub o el proyecto de gestión de la carpeta habilitada para la aplicación.

  3. Aplica filtros para restringir los datos de la traza:

    • Para filtrar por aplicación, usa el filtro de intervalo Aplicación del centro de aplicaciones.
    • 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 añadir un filtro personalizado, en la barra de herramientas, seleccione Añadir filtro, seleccione Añadir filtro de atributo y, a continuación, complete el cuadro de diálogo. La sintaxis del campo Key debe coincidir con la sintaxis de la clave de un atributo de un elemento "span". Por ejemplo, para filtrar por el identificador de host, introduce host.id.

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

Explorar la telemetría y los incidentes de un servicio o una carga de trabajo

Se proporciona un panel de control preconfigurado 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 concretos. Puedes consultar los datos de estos paneles de control preconfigurados de forma similar a como lo harías en la pestaña Panel de control de una aplicación.

Para abrir el panel de control preconfigurado de un servicio o una carga de trabajo, haz lo siguiente:

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

    Ir a Monitorización de aplicaciones

    Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuya sección sea Monitorización.

  2. En la barra de herramientas de la consola Google Cloud , selecciona tu proyecto host de App Hub o el proyecto de gestión de la carpeta habilitada para la aplicación.

  3. En la página Monitorización de aplicaciones, seleccione el nombre de una aplicación y, a continuación, un servicio o una carga de trabajo.

    En un panel de control se muestra la información de registro, métricas e incidentes del servicio o la carga de trabajo que haya seleccionado. En el caso de las cargas de trabajo, el panel de control está configurado para superponer anotaciones de eventos en los gráficos. Las anotaciones pueden ayudarte a correlacionar datos de diferentes fuentes cuando estés solucionando un problema. Para ver qué anotaciones están habilitadas, en la barra de herramientas, haz clic en Anotaciones.

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

    Para obtener información sobre cómo explorar los datos de un panel de control de un servicio o una carga de trabajo, consulta las siguientes secciones de este documento:

Crear un panel de control personalizado

Google Cloud Observability permite crear paneles de control personalizados, lo que te da control total sobre el contenido del panel. Los paneles de control personalizados se muestran en la página Paneles de control de la consola Google Cloud . Se pueden copiar, editar y eliminar. También pueden ser el destino donde guardes un widget de panel de control que hayas configurado. Por ejemplo, si estás consultando un gráfico en un panel de control de aplicaciones, puedes guardarlo en un panel de control personalizado. Para ello, ve a la barra de herramientas y selecciona Guardar en panel de control.

Si tienes previsto crear un panel de control personalizado para una aplicación, un servicio o una carga de trabajo, puede que te resulte útil lo siguiente:

Asociar una política de alertas a una aplicación de App Hub

Para asociar una política de alertas a un servicio o una carga de trabajo, añade etiquetas específicas de la aplicación a la política de alertas. Cuando añada estas etiquetas, se mostrarán en la política de alertas y también se incluirán en los incidentes. Para obtener más información sobre las etiquetas, consulta Anotar incidencias con etiquetas.

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

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

    Ve a Alertas.

    Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuya sección sea Monitorización.

  2. En la barra de herramientas de la consola, selecciona el proyecto host de App Hub o el proyecto de gestión de la carpeta habilitada para la aplicación.Google Cloud
  3. Busca la política de alertas, haz clic en Ver más, selecciona Editar y, a continuación, ve a la sección Notificaciones y nombre.
  4. En la sección Etiquetas de aplicación, selecciona tu aplicación y, a continuación, tu carga de trabajo o servicio.
  5. Haz clic en Guardar política.

Una vez que hayas completado 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 añadir etiquetas de usuario a una política de alertas mediante la CLI de Google Cloud, 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 las siguientes secciones:

Solucionar problemas

Para obtener información que te ayude a entender qué datos estás viendo o por qué un panel no muestra datos, consulta Solucionar problemas de monitorización de aplicaciones.