Para comprender las relaciones entre las aplicaciones, los servicios y las cargas de trabajo, consulta el gráfico de topología. Este gráfico dinámico te ayuda a comprender el flujo de tráfico y a identificar incidentes. En el caso de las aplicaciones registradas en App Hub, puedes ver la topología a nivel de la aplicación. También puedes ver un gráfico de topología en el nivel del límite de administración de aplicaciones, que te permite comprender cómo interactúa una aplicación con los servicios y las cargas de trabajo externos.
Para explorar más tus aplicaciones, puedes usar Topología de la app en Cloud Hub. Puedes crear consultas personalizadas y correlacionar los datos de alertas y tráfico con otros datos.
Comprende el gráfico 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:
En el caso de dos aplicaciones, el círculo azul muestra un botón Contraer unfold_less. En 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 Expand. El valor del botón es la cantidad de servicios y cargas de trabajo registrados.
Para obtener información sobre los atributos y los incidentes 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 los incidentes, 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 deriva de los datos de la última hora. No puedes cambiar el período que usa el Monitoreo de aplicaciones.
- En los menús desplegables, solo se muestran los incidentes 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 solo muestra los incidentes de las políticas de alertas con etiquetas de aplicación. Para los servicios y las cargas de trabajo detectados, la Supervisión de aplicaciones usa etiquetas de recursos para identificar incidentes.
- 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 hasta 100 servicios y 100 cargas de trabajo descubiertos.
- 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.
En el caso de los siguientes recursos, el gráfico de topología solo muestra las conexiones cuando el servicio o la carga de trabajo correspondientes tienen 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 tienen el estado de registro
discoveredcuando forman parte del límite de administración de la aplicación, pero no están registrados en ninguna aplicación.
Antes de comenzar
Para generar un gráfico de topología de una aplicación, los 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 Application Monitoring incluye la configuración del 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.
Roles necesarios para habilitar las APIs
Para habilitar las APIs, necesitas el rol de IAM de administrador de Service Usage (
roles/serviceusage.serviceUsageAdmin), que contiene el permisoserviceusage.services.enable. Obtén más información para otorgar roles. -
Para obtener los permisos que necesitas para ver la topología de la 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 la topología de la 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 la aplicación:
-
Para generar la topología, haz lo siguiente:
apptopology.applicationTopologies.generate
También puedes obtener estos permisos con roles personalizados o con otros roles predefinidos.
-
Para generar la topología, haz lo siguiente:
- Instrumenta tu aplicación para usar OpenTelemetry y para enviar tus datos de seguimiento al extremo de OTLP.
Visualiza la topología de tu límite de administración de aplicaciones
-
En la consola de Google Cloud , ve a la página Supervisión de aplicaciones:
Ir a Monitoring 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 de administración de App Hub.
Haz clic en la pestaña Topology. Aparecerá el grafo de topología 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.
Selecciona una aplicación o un nodo para obtener información sobre los atributos y los incidentes asociados.
En el caso de los servicios y las cargas de trabajo detectados, es posible que la ventana emergente muestre un nombre de Cloud Asset Inventory. Google Cloud Observability usa el nombre del recurso para determinar qué datos muestra un panel.
Selecciona la conexión para obtener información sobre el tráfico entre los nodos. En una ventana emergente, se muestran los nombres de los nodos y las métricas clave, como la tasa de errores y el percentil 95 de latencia.
Cómo ver 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 Monitoring 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 de administración de App Hub.
Selecciona una aplicación de la lista.
Haz clic en la pestaña Topology. Aparecerá el grafo 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 el zoom, o bien reposicionando los nodos.
Selecciona un nodo para obtener información sobre los atributos y los incidentes.
Selecciona la conexión para obtener información sobre el tráfico entre los nodos. En una ventana emergente, se muestran 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 puede 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.