Ver la topología de la aplicación

En este documento se describe cómo ver el mapa de topología que crea Application Monitoring para tus aplicaciones, servicios y cargas de trabajo de App Hub. El mapa de topología de la aplicación ofrece una vista dinámica de las relaciones de tu aplicación para ayudarte a monitorizar las alertas y el tráfico, así como a solucionar problemas.

Información sobre el mapa de topología

El mapa de topología de la aplicación ofrece una vista dinámica y útil del rendimiento de tu aplicación, lo que simplifica la monitorización y la solución de problemas. El mapa de topología representa tu aplicación mediante nodos y aristas, de la siguiente manera:

  • Los nodos representan los servicios y las cargas de trabajo de tu aplicación:

    Topología de una aplicación de ejemplo.

  • Los bordes representan el tráfico de tu aplicación entre tus servicios y tus cargas de trabajo:

    Los bordes muestran la latencia y la tasa de errores.

El mapa de topología es totalmente interactivo. Puedes acercar y alejar la imagen, y mover los nodos para visualizar la relación entre tus servicios y cargas de trabajo. Para abrir un panel con más detalles sobre el estado de un nodo o un borde concretos, haz clic en el nodo o el borde.

Antes de empezar

Para generar el mapa de topología de la aplicación, los datos de la traza deben contener etiquetas específicas de la aplicación. Estas etiquetas solo están disponibles cuando instrumentas tu aplicación con OpenTelemetry, envías tus datos de traza a la API Telemetry y registras tu aplicación en App Hub.

Para empezar, haz lo siguiente:

  1. Configura la monitorización de aplicaciones tal como se describe en Configurar la monitorización de aplicaciones. La configuración de la monitorización de aplicaciones incluye la configuración del ámbito de seguimiento predeterminado para listar todos los proyectos que almacenan tus datos de seguimiento.
  2. Si usas una carpeta habilitada para aplicaciones, tu proyecto tendrá una política de restricción de uso de servicios predeterminada que te impedirá usar la API App Topology. Para solucionar este problema, alguien con el rol Administrador de políticas de la organización debe añadir apptopology.googleapis.com a la lista de permitidos de la política del proyecto de gestión de carpetas habilitado para la aplicación. Ten en cuenta que también puede haber una política a nivel de organización. Para obtener más información, consulta Restringir el uso de recursos.

  3. Enable the Observability, App Topology, and Telemetry APIs.

    Roles required to enable APIs

    To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

    Enable the APIs

    Si has añadido otros proyectos a tu ámbito de seguimiento, te recomendamos que también habilites la API Observability en esos proyectos. El mapa de topología de la aplicación solo muestra los bordes de las trazas de los proyectos del ámbito de las trazas que están en la misma organización que tu proyecto de App Hub.

  4. Para obtener los permisos que necesitas para ver la topología de la aplicación, pide a tu administrador que te conceda el rol de gestión de identidades y accesos Lector de topología de aplicaciones (roles/apptopology.viewer) en tu proyecto. Para obtener más información sobre cómo conceder roles, consulta el artículo Gestionar 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 se necesitan, despliega la sección Permisos necesarios:

    Permisos obligatorios

    Para ver la topología de la aplicación, se necesitan los siguientes permisos:

    • Para generar la topología, sigue estos pasos: apptopology.applicationTopologies.generate

    También puedes obtener estos permisos con roles personalizados u otros roles predefinidos.

  5. Instrumenta tu aplicación para que use OpenTelemetry y para enviar tus datos de trazas al endpoint de OTLP.

Ver el mapa de topología

  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 el selector de proyectos de la Google Cloud consola, selecciona el proyecto host de App Hub o el proyecto de gestión.

  3. Selecciona una aplicación de la lista.

  4. Haz clic en la pestaña Topología. Aparecerá el mapa de topología de tu aplicación.

El mapa de topología es totalmente interactivo. Puedes acercar y alejar la imagen, y mover los nodos para visualizar la relación entre tus servicios y cargas de trabajo. También puedes ver los detalles de un nodo o un borde:

  • Para ver las alertas o los atributos abiertos de un servicio o una carga de trabajo, selecciona el nodo.
  • Para ver la latencia y la tasa de errores entre dos nodos, selecciona el borde.

Solucionar problemas

Para obtener información que pueda ayudarte a entender por qué el mapa de topología de la aplicación no muestra datos, consulta Solucionar problemas de monitorización de aplicaciones.