El gráfico de topología en Supervisión de la aplicación te permite visualizar las relaciones entre tus aplicaciones, servicios y cargas de trabajo. Puedes usar este gráfico dinámico para inspeccionar el flujo de tráfico, la latencia, las tasas de error y las alertas abiertas. En el caso de las aplicaciones registradas en App Hub, puedes ver la topología de una sola aplicación o en el nivel de límite de administración de aplicaciones para ver cómo interactúan tus aplicaciones con los servicios y las cargas de trabajo externos.
Para ejecutar consultas personalizadas y correlacionar los datos de alertas y tráfico con otros datos de telemetría, usa App Topology en Cloud Hub.
Comprende el grafo de topología
El gráfico de topología de la aplicación es completamente interactivo y proporciona una vista dinámica y útil de tus aplicaciones, servicios y cargas de trabajo. Esta vista te ayuda a supervisar y solucionar problemas de rendimiento.
En la siguiente imagen, se muestra un gráfico de topología para un límite de administración de aplicaciones:
Este gráfico tiene los siguientes elementos:
Círculos azules: Cada círculo azul representa una aplicación registrada en App Hub. En el ejemplo, se muestran varias aplicaciones:
Para dos aplicaciones, el círculo azul muestra un botón unfold_less Contraer. Para estas aplicaciones, se muestran los servicios y las cargas de trabajo.
Para una aplicación, se muestra un solo nodo y el círculo azul muestra el botón Expandir . El valor en el botón es la cantidad de servicios y cargas de trabajo registrados.
Para obtener información sobre los atributos y las alertas de la aplicación, selecciona su círculo azul.
Nodos: Cada nodo representa un servicio o una carga de trabajo registrados o descubiertos. El ícono del nodo muestra uno de los siguientes estados:
- Agente ()
- Servidor de MCP (
) - Servicio (
) - Carga de trabajo (
)
Para obtener información sobre los atributos y las alertas, selecciona el nodo.
Conexiones: Representan el tráfico entre dos nodos. Para obtener información sobre las métricas clave, como la tasa de errores y el percentil 95 de latencia, selecciona la conexión:
Limitaciones
- Las conexiones muestran información sobre la latencia y la tasa de errores que la Supervisión de aplicaciones obtiene de la hora de datos más reciente. No puedes cambiar el período que usa la Supervisión de aplicaciones.
- El gráfico de topología y los menús desplegables muestran solo las alertas de las últimas 24 horas.
- En el caso de las aplicaciones, los servicios y las cargas de trabajo registrados, el gráfico de topología muestra alertas de políticas de alertas con etiquetas de recursos, no de políticas de alertas con etiquetas de aplicaciones. Para los servicios y las cargas de trabajo descubiertos, Application Monitoring usa etiquetas de recursos para identificar las alertas.
- El gráfico de topología muestra un máximo de 1,000 nodos o conexiones. Para cada región de App Hub compatible, el gráfico muestra, como máximo, 100 servicios descubiertos y 100 cargas de trabajo descubiertas.
- No puedes registrar un servicio o una carga de trabajo con una aplicación arrastrando el nodo correspondiente al círculo azul de una aplicación. El círculo es una guía visual, no un contenedor.
Para los siguientes recursos, el grafo de topología solo muestra conexiones 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
discoveredcuando forma parte del límite de administración de la aplicación, pero no está registrado en ninguna aplicación.
Antes de comenzar
Para generar un grafo de topología de una aplicación, tus datos de seguimiento deben contener etiquetas específicas de la aplicación. Estas etiquetas solo están disponibles cuando instrumentas tu app con OpenTelemetry, envías tus datos de seguimiento a la API de Telemetry y registras tu aplicación en App Hub.
Para comenzar, haz lo siguiente:
- Configura la supervisión de aplicaciones como se describe en Configura la supervisión de aplicaciones. La configuración de la supervisión de aplicaciones incluye establecer el permiso de seguimiento predeterminado para enumerar todos los proyectos que almacenan tus datos de seguimiento.
-
Habilita las APIs de Observability, App Topology, Cloud Trace y Telemetry, si aún no están habilitadas.
Roles necesarios para habilitar las APIs
Para habilitar las APIs, necesitas el permiso
serviceusage.services.enable. Si creaste el proyecto, es probable que ya tengas este permiso a través del rol de propietario (roles/owner). De lo contrario, puedes obtenerlo a través del rol de administrador de Service Usage (roles/serviceusage.serviceUsageAdmin). Obtén más información para otorgar roles. -
Para obtener los permisos que necesitas para ver una topología de aplicación, pídele a tu administrador que te otorgue el rol de IAM de Visualizador de App Topology (
roles/apptopology.viewer) en tu proyecto. Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.Este rol predefinido contiene los permisos necesarios para ver una topología de aplicación. Para ver los permisos exactos que son necesarios, expande la sección Permisos requeridos:
Permisos necesarios
Se requieren los siguientes permisos para ver la topología de una aplicación:
-
Obtén datos de recursos descubiertos:
apptopology.discoveredResourcesTopologies.generate -
Obtén datos de recursos:
apptopology.sreDomainTopologies.generate
También puedes obtener estos permisos con roles personalizados o con otros roles predefinidos.
-
Obtén datos de recursos descubiertos:
- Instrumenta tu aplicación para usar OpenTelemetry y envía tus datos de seguimiento al extremo de OTLP.
Visualiza la topología del límite de administración de tu aplicación
-
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.
En el selector de proyectos de la consola de Google Cloud , selecciona tu proyecto host o proyecto de administración .
Haz clic en la pestaña Topología. Aparecerá el grafo de topología del límite de administración de tu aplicación.
En el gráfico de topología interactivo, puedes hacer lo siguiente:
Para cambiar la visualización, acerca o aleja la imagen, cambia la posición de los nodos o contrae o expande un círculo azul.
Para obtener información sobre los atributos y las alertas asociadas, selecciona una aplicación o un nodo.
En el caso de los servicios y las cargas de trabajo descubiertos, el menú flotante puede mostrar un nombre de Cloud Asset Inventory. Google Cloud Observability usa el nombre del recurso para determinar qué datos muestra un panel.
Para obtener información sobre el tráfico entre nodos, selecciona la conexión. Un menú flotante muestra los nombres de los nodos y las métricas clave, como la tasa de errores y el percentil 95 de latencia.
Visualiza el gráfico de topología de una aplicación
-
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.
En el selector de proyectos de la consola de Google Cloud , selecciona tu proyecto host o proyecto de administración .
Selecciona una aplicación de la lista.
Haz clic en la pestaña Topología. Aparecerá el gráfico de topología de tu aplicación.
En el gráfico de topología interactivo, puedes hacer lo siguiente:
Cambia la visualización acercando o alejando la imagen, o cambiando la posición de los nodos.
Selecciona un nodo para obtener información sobre los atributos y las alertas.
Para obtener información sobre el tráfico entre nodos, selecciona la conexión. Un menú flotante muestra los nombres de los nodos y las métricas clave, como la tasa de errores y el percentil 95 de latencia.
Solucionar problemas
Para obtener información que pueda ayudarte a comprender por qué el gráfico de topología de la aplicación no muestra datos, consulta Soluciona problemas de Application Monitoring.
¿Qué sigue?
- Explora los gráficos de topología en Cloud Hub.