Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés. # 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](using-grafana-v9.md). 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](using-grafana-v8.md). 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. 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](x-ray-data-source.md). ## 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 | Description (Descripción) | | --- | --- | --- | | id | cadena | Identificador único del borde. | | origen | cadena | ID del nodo de origen. | | destino | cadena | ID del destino. | Campos opcionales: | Nombre del campo | Tipo | Description (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\$1\$1\$1 | 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 | Description (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 | Description (Descripción) | | --- | --- | --- | | título | 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\$1\$1\$1 | número | 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\$1\$1\$1 | 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. | | icono | 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í](https://developers.grafana.com/ui/latest/index.html?path=/story/docs-overview-icon--icons-overview)). | | nodeRadius | número | 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`. |