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 ver los espacios de trabajo de Grafana que admiten la versión 9.x de Grafana, consulte. Trabajando en Grafana versión 9

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

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 todas las fuentes de datos o consultas se pueden visualizar con este gráfico. Si quieres usarlo como desarrollador de fuentes de datos, consulta la sección sobre la API de datos.

Un gráfico de nodos se compone de nodos y aristas.

• Un nodo se muestra como un círculo. Un nodo puede representar una aplicación, un servicio o cualquier otra cosa que sea relevante 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. La fuente de datos define qué información y valores se muestran, por lo que diferentes fuentes 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. Puede expandir las partes ocultas del gráfico haciendo 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 seleccionando el borde.

La primera fuente de datos que admite esta visualización es la fuente de AWS X-Ray datos de su función de mapa de servicio. Para obtener más información, consulte Conectarse a una fuente AWS X-Ray de datos.

Navegar por el gráfico de nodos

Pan

Puede realizar una panorámica dentro del gráfico de nodos seleccionando la parte exterior de cualquier nodo o borde y arrastrando el puntero.

Acercar o alejar

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

Explora 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, elige las estadísticas dentro de la leyenda. El marcador situado junto al nombre de la estadística (uno ˄ o ˅ varios) muestra qué estadística se utiliza actualmente para ordenar y ordenar su 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 la fuente 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' ambos marcos de datos o asignarles un nombre nodes yedges, respectivamente, para que se represente el gráfico de nodos.

Bordea los datos de la estructura

Campos obligatorios:

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

Campos opcionales:

Nombre del campo	Tipo	Descripción
pilar	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.
estadística secundaria	cadena/número	Igual que MainStat, pero se muestra justo debajo.
detalle__*	cadena/número	Cualquier campo con el prefijo se detail__ mostrará en el encabezado del menú contextual al hacer clic en el borde. Úselo config.displayName para una etiqueta más legible para el ser humano.

Node los datos de la estructura

Campos obligatorios:

Nombre del campo	Tipo	Descripción
id	cadena	Identificador único del nodo. Edge 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	Además, el nombre, el tipo u otro identificador se muestra debajo del título.
pilar	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.
estadística secundaria	cadena/número	Igual que MainStat, pero se muestra debajo de él, dentro del nodo.
arc__*	number	Se usará cualquier campo con arc__ el prefijo para crear el círculo de color alrededor del nodo. Todos los valores de estos campos deben sumar 1. Puede especificar el color medianteconfig.color.fixedColor.
detalle__*	cadena/número	Cualquier campo con el prefijo se detail__ mostrará en el encabezado del menú contextual al hacer clic en el nodo. Úselo config.displayName para una etiqueta más legible para el ser humano.
color	cadena/número	Se puede usar para especificar un solo color en lugar de usar los arc__ campos 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 field.config.color.mode configuración. 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 (consulta los iconos disponibles aquí).
NodeRadius	number	Valor del radio en píxeles. Se utiliza para gestionar el tamaño de los nodos.
resaltado	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.