Cómo ver la topología de la aplicación

Versión preliminar

Este producto o función está sujeto a las "Condiciones de la Oferta de la Fase Previa a la DG" en la sección Condiciones Generales del Servicio de las Condiciones Específicas del Servicio. Los productos y las funciones de la fase previa a la DG están disponibles sin modificaciones y pueden estar sujetos a asistencia limitada. Para obtener más información, consulta las descripciones de la etapa de lanzamiento.

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

Comprende el mapa de topología

El mapa de topología de la aplicación proporciona una vista dinámica y práctica del rendimiento de tu aplicación, lo que simplifica la supervisión y la solución de problemas. El mapa de topología representa tu aplicación con nodos y bordes, de la siguiente manera:

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

  

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

  

El mapa de topología es completamente 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 que proporciona detalles adicionales sobre el estado de un nodo o borde específico, haz clic en el nodo o borde.

Antes de comenzar

Para generar el mapa de topología de la 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:

1. 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.
2. Si usas una carpeta habilitada para apps, tu proyecto tendrá una política predeterminada de Restricción de uso del servicio que te impedirá usar la API de App Topology. Para resolver este problema, alguien con el rol de Administrador de políticas de la organización debe agregar apptopology.googleapis.com a la lista de entidades permitidas de la política para el proyecto de administración de carpetas habilitado para la app. Ten en cuenta que también puede haber una política vigente a nivel de la organización. Para obtener más información, consulta Cómo 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 agregaste otros proyectos a tu alcance de seguimiento, te recomendamos que también habilites la API de Observability para esos proyectos. El mapa de topología de la aplicación solo muestra los bordes de seguimiento de los proyectos de alcance de seguimiento que se encuentran 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, pídele a tu administrador que te otorgue el rol de IAM Visualizador de topología de la app (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.

5. Instrumenta tu aplicación para usar OpenTelemetry y para enviar tus datos de seguimiento al extremo de OTLP.

Cómo ver el mapa de topología

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

3. Selecciona una aplicación de la lista.

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

El mapa de topología es completamente 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 detalles sobre 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 error entre dos nodos, selecciona el borde.

Solucionar problemas

Para obtener información que puede ayudarte a comprender por qué el mapa de topología de la aplicación no muestra datos, consulta Soluciona problemas de Supervisión de aplicaciones.