Gráfico de nodos

Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la versión 10.x de Grafana.

Para los espacios de trabajo de Grafana que admiten la versión 9.x de Grafana, consulte Uso de la versión 9 de Grafana.

Para los espacios de trabajo de Grafana que admiten la versión 8.x de Grafana, consulte Uso de la versión 8 de Grafana.

Los gráficos de nodos pueden visualizar gráficos o redes dirigidos. Utilizan un diseño de fuerza dirigida para posicionar los nodos de manera efectiva, de modo que puedan ayudar a mostrar mapas de infraestructura complejos, jerarquías o diagramas de ejecución.

Requisitos de datos

Un gráfico de nodos requiere una forma específica de los datos para poder mostrar sus nodos y bordes. No todos los orígenes de datos o consultas se pueden visualizar con este gráfico. Si quiere usarlo como desarrollador de orígenes de datos, consulte la sección sobre la API de datos.

Un gráfico de nodos consta de nodos y bordes.

• Un nodo se muestra como un círculo. Un nodo puede representar una aplicación, un servicio o cualquier otra cosa que sea pertinente desde la perspectiva de la aplicación.

• Un borde se muestra como una línea que conecta dos nodos. La conexión puede ser una solicitud, una operación o alguna otra relación entre los dos nodos.

Tanto los nodos como los bordes pueden tener metadatos o estadísticas asociados. El origen de datos define qué información y valores se muestran, por lo que diferentes orígenes de datos pueden mostrar diferentes tipos de valores o no mostrar algunos valores.

Nodos

Por lo general, los nodos muestran dos valores estadísticos dentro del nodo y dos identificadores justo debajo del nodo, normalmente el nombre y el tipo. Los nodos también pueden mostrar otro conjunto de valores como un círculo de color alrededor del nodo, con secciones de diferentes colores que representan valores diferentes que deben sumar 1. Por ejemplo, puede hacer que el porcentaje de errores se represente mediante una parte roja del círculo.

Se pueden mostrar detalles adicionales en un menú contextual, que se muestra al seleccionar el nodo. También puede haber enlaces adicionales en el menú contextual que pueden dirigirse a otras partes del espacio de trabajo de Grafana o a cualquier enlace externo.

nota

El gráfico de nodos solo puede mostrar 1500 nodos. Si se supera este límite, aparecerá una advertencia en la esquina superior derecha y algunos nodos se ocultarán. Para expandir las partes ocultas del gráfico, haga clic en los marcadores de Nodos ocultos del gráfico.

Periferias

Los bordes también pueden mostrar estadísticas al pasar el ratón por encima del borde. Al igual que en los nodos, puede abrir un menú contextual con detalles y enlaces adicionales si selecciona el borde.

El primer origen de datos que admite esta visualización es el origen de datos de AWS X-Ray para su característica de mapa de servicio. Para obtener más información, consulte Conectarse a una fuente AWS X-Ray de datos.

Navegación por el gráfico de nodos

Desplazamiento

Para desplazarse por el gráfico de nodos, seleccione la parte exterior de cualquier nodo o borde y arrastre el puntero.

Ampliación o reducción

Para hacer zoom, utilice los botones de la esquina superior izquierda del gráfico de nodos o la rueda del ratón u otra opción de desplazamiento con la tecla Ctrl (o Cmd).

Exploración de los nodos ocultos

El número de nodos que se muestran en un momento dado está limitado para mantener un rendimiento razonable. Los nodos que están fuera de este límite se ocultan detrás de marcadores seleccionables que muestran un número aproximado de nodos ocultos que están conectados a ese borde. Puede elegir el marcador para expandir el gráfico alrededor de ese nodo.

Vista de cuadrícula

Puede cambiar a la vista de cuadrícula para tener una mejor visión general de los nodos más interesantes del gráfico. La vista de cuadrícula muestra los nodos de una cuadrícula sin bordes y se puede ordenar por las estadísticas que se muestran dentro del nodo o por las estadísticas representadas por un borde coloreado de los nodos.

Para ordenar los nodos, elija las estadísticas dentro de la leyenda. El marcador situado junto al nombre de la estadística (˄ o ˅) muestra qué estadística se utiliza actualmente para ordenar la dirección.

Elija un nodo y, a continuación, seleccione la opción Mostrar en el diseño del gráfico para volver al diseño del gráfico con el foco en el nodo seleccionado y mostrarlo en el contexto del gráfico completo.

Data API (API de datos)

Esta visualización necesita que el origen de datos devuelva una forma específica de los datos para poder mostrarlos correctamente.

El gráfico de nodos requiere como mínimo un marco de datos que describa los bordes del gráfico. De forma predeterminada, el gráfico de nodos calculará los nodos y cualquier estadística en función de este marco de datos. Opcionalmente, se puede enviar un segundo marco de datos que describa los nodos en caso de que sea necesario mostrar más metadatos específicos de los nodos. Debe configurar frame.meta.preferredVisualisationType = 'nodeGraph' en ambos marcos de datos o denominarlos como nodes y edges, respectivamente, para que se represente el gráfico de nodos.

Datos de bordes de la estructura

Campos obligatorios:

Nombre del campo	Tipo	Descripción
id	cadena	Identificador único del borde.
source	cadena	ID del nodo de origen.
destino	cadena	ID del destino.

Campos opcionales:

Nombre del campo	Tipo	Descripción
mainstat	cadena/número	La primera estadística que se muestra en la superposición al pasar el ratón por encima del borde. Puede ser una cadena que muestre el valor tal cual o puede ser un número. Si es un número, también se muestra cualquier unidad asociada a ese campo.
secondarystat	cadena/número	Igual que mainStat, pero se muestra justo debajo.
detail__*	cadena/número	Cualquier campo con el prefijo detail__ se mostrará en el encabezado del menú contextual al hacer clic en la periferia. Use config.displayName para una etiqueta más legible.

Datos de nodos de la estructura

Campos obligatorios:

Nombre del campo	Tipo	Descripción
id	cadena	Identificador único del nodo. El borde hace referencia a este ID en sus campos de origen y destino.

Campos opcionales:

Nombre del campo	Tipo	Descripción
title	cadena	Nombre del nodo visible justo debajo del nodo.
subtitle	cadena	Adicional, nombre, tipo u otro identificador que se muestra debajo del título.
mainstat	cadena/número	Primera estadística que se muestra dentro del propio nodo. Puede ser una cadena que muestre el valor tal cual o un número. Si es un número, también se muestra cualquier unidad asociada a ese campo.
secondarystat	cadena/número	Igual que mainStat, pero se muestra debajo de él, dentro del nodo.
arc__*	number	Se usará cualquier campo con el prefijo arc__ para crear el círculo de color alrededor del nodo. Todos los valores de estos campos deben sumar 1. Puede especificar el color mediante config.color.fixedColor.
detail__*	cadena/número	Cualquier campo con el prefijo detail__ se mostrará en el encabezado del menú contextual al hacer clic en el nodo. Use config.displayName para una etiqueta más legible.
color	cadena/número	Se puede usar para especificar un solo color en lugar de usar los campos arc__ para especificar secciones de color. Puede ser una cadena (debe ser una cadena de colores HTML aceptable) o puede ser un número, en cuyo caso el comportamiento depende de la configuración field.config.color.mode. Esto se puede usar, por ejemplo, para crear colores degradados controlados por un valor de campo.
icon	cadena	Nombre del icono que se mostrará dentro del nodo en lugar de las estadísticas predeterminadas. Solo se permiten los iconos integrados en Grafana (consulte los iconos disponibles aquí).
nodeRadius	number	Valor del radio en píxeles. Se utiliza para administrar el tamaño de los nodos.
highlighted	Booleano	Establece si el nodo debe resaltarse. Se usa, por ejemplo, para representar una ruta específica en el gráfico resaltando varios nodos y bordes. El valor predeterminado es false.