Gráfico de nós

Este tópico de documentação foi desenvolvido para espaços de trabalho do Grafana que oferecem suporte à versão 10.x do Grafana.

Para espaços de trabalho do Grafana que suportam a versão 9.x do Grafana, consulte. Trabalhando na versão 9 do Grafana

Para espaços de trabalho do Grafana que suportam a versão 8.x do Grafana, consulte. Trabalhando na versão 8 da Grafana

Os gráficos de nós podem visualizar redes ou grafos direcionados. Eles usam um layout de força direcionada para posicionar os nós de forma eficaz, para que possam ajudar na exibição de mapas complexos de infraestrutura, hierarquias ou diagramas de execução.

Requisitos de dados

Um gráfico de nós requer uma forma específica dos dados para poder exibir seus nós e bordas. Nem toda fonte de dados ou consulta pode ser visualizada com esse gráfico. Se você quiser usar isso como desenvolvedor de fonte de dados, consulte a seção sobre API de dados.

Um gráfico de nós consiste em nós e bordas.

• Um nó é exibido como um círculo. Um nó pode representar um aplicativo, um serviço ou qualquer outra coisa que seja relevante do ponto de vista do aplicativo.

• Uma borda é exibida como uma linha que conecta dois nós. A conexão pode ser uma solicitação, uma operação ou algum outro relacionamento entre os dois nós.

Tanto os nós quanto as bordas podem ter metadados ou estatísticas associados. A fonte de dados define quais informações e valores são mostrados, para que fontes de dados diferentes possam mostrar diferentes tipos de valores ou não mostrar alguns valores.

Nodes

Normalmente, os nós mostram dois valores estatísticos dentro do nó e dois identificadores logo abaixo do nó, geralmente nome e tipo. Os nós também podem mostrar outro conjunto de valores como um círculo colorido ao redor do nó, com seções de cores diferentes representando valores diferentes que devem somar 1. Por exemplo, você pode ter a porcentagem de erros representada pela parte vermelha do círculo.

Detalhes adicionais podem ser exibidos em um menu de contexto, que é exibido quando você escolhe o nó. Também pode haver links adicionais no menu de contexto que podem ser direcionados a outras partes do espaço de trabalho da Grafana ou a qualquer link externo.

nota

O gráfico de nós pode mostrar apenas 1.500 nós. Se esse limite for ultrapassado, um aviso será visível no canto superior direito e alguns nós ficarão ocultos. Você pode expandir partes ocultas do gráfico clicando nos marcadores de nós ocultos no gráfico.

Edges (Bordas)

As bordas também podem mostrar estatísticas quando você passa o mouse sobre a borda. Semelhante aos nós, você pode abrir um menu de contexto com detalhes e links adicionais escolhendo a borda.

A primeira fonte de dados que suporta essa visualização é a fonte de AWS X-Ray dados de seu recurso de mapa de serviços. Para ter mais informações, consulte Conecte-se a uma fonte AWS X-Ray de dados.

Navegando pelo gráfico de nós

Panela

Você pode fazer uma panorâmica dentro do gráfico do nó escolhendo fora de qualquer nó ou borda e arrastando o ponteiro.

Aumentar ou diminuir o zoom

Você pode ampliar usando os botões no canto superior esquerdo do gráfico do nó ou usar a roda do mouse ou outra entrada de rolagem com a tecla Ctrl (ouCmd).

Explore nós ocultos

O número de nós mostrados em um determinado momento é limitado para manter um desempenho razoável. Os nós que estão fora desse limite estão ocultos atrás de marcadores selecionáveis que mostram um número aproximado de nós ocultos conectados a essa borda. Você pode escolher o marcador para expandir o gráfico em torno desse nó.

Visualização em grade

Você pode alternar para a visualização em grade para ter uma melhor visão geral dos nós mais interessantes no gráfico. A visualização em grade mostra os nós em uma grade sem bordas e pode ser classificada pelas estatísticas mostradas dentro do nó ou pelas estatísticas representadas pela borda colorida dos nós.

Para classificar os nós, escolha as estatísticas dentro da legenda. O marcador ao lado do nome da estatística (˄ou˅) mostra qual estatística é usada atualmente para classificação e direção de classificação.

Escolha um nó e, em seguida, selecione a opção Mostrar no layout do gráfico para voltar ao layout do gráfico com foco no nó selecionado, para mostrá-lo no contexto do gráfico completo.

Data API (API de dados)

Essa visualização precisa de uma forma específica dos dados a serem retornados da fonte de dados para exibi-los corretamente.

O Node Graph requer, no mínimo, um quadro de dados descrevendo as bordas do gráfico. Por padrão, o gráfico de nós calculará os nós e quaisquer estatísticas com base nesse quadro de dados. Opcionalmente, um segundo quadro de dados descrevendo os nós pode ser enviado caso seja necessário mostrar mais metadados específicos do nó. Você precisa definir os dois quadros frame.meta.preferredVisualisationType = 'nodeGraph' de dados ou nomeá-losnodes, edges respectivamente, para que o gráfico do nó seja renderizado.

Limita os dados da estrutura

Campos obrigatórios:

Nome do campo	Tipo	Descrição
id	string	Identificador exclusivo da borda.
origem	string	ID do nó de origem.
target	string	Identificação do alvo.

Campos opcionais:

Nome do campo	Tipo	Descrição
pilar	sequência/número	Primeira estatística mostrada na sobreposição ao passar o mouse sobre a borda. Pode ser uma string mostrando o valor como está ou pode ser um número. Se for um número, qualquer unidade associada a esse campo também será mostrada.
estado secundário	sequência/número	O mesmo que o MainStat, mas mostrado logo abaixo dele.
detalhe__*	sequência/número	Qualquer campo prefixado com detail__ será mostrado no cabeçalho do menu de contexto quando clicado na borda. Use config.displayName para obter uma etiqueta mais legível por humanos.

Dados de nós da estrutura

Campos obrigatórios:

Nome do campo	Tipo	Descrição
id	string	Identificador exclusivo do nó. Esse ID é referenciado por edge em seus campos de origem e destino.

Campos opcionais:

Nome do campo	Tipo	Descrição
title	string	Nome do nó visível logo abaixo do nó.
subtitle	string	Adicional, nome, tipo ou outro identificador mostrado abaixo do título.
pilar	sequência/número	Primeira estatística mostrada dentro do próprio nó. Pode ser uma string mostrando o valor como está ou um número. Se for um número, qualquer unidade associada a esse campo também será mostrada.
estado secundário	sequência/número	O mesmo que o MainStat, mas mostrado abaixo dele dentro do nó.
arco__*	número	Qualquer campo prefixado com arc__ será usado para criar o círculo de cores ao redor do nó. Todos os valores nesses campos devem somar 1. Você pode especificar a cor usandoconfig.color.fixedColor.
detalhe__*	sequência/número	Qualquer campo prefixado com detail__ será mostrado no cabeçalho do menu de contexto quando clicado no nó. Use config.displayName para obter uma etiqueta mais legível por humanos.
color	sequência/número	Pode ser usado para especificar uma única cor em vez de usar os arc__ campos para especificar seções de cores. Pode ser uma string (deve ser uma string de cores HTML aceitável) ou pode ser um número. Nesse caso, o comportamento depende da field.config.color.mode configuração. Isso pode ser usado, por exemplo, para criar cores de gradiente controladas por um valor de campo.
icon	string	Nome do ícone a ser exibido dentro do nó em vez das estatísticas padrão. Somente ícones integrados da Grafana são permitidos (veja os ícones disponíveis aqui).
Raio do nó	número	Valor do raio em pixels. Usado para gerenciar o tamanho do nó.
destacado	Booleano	Define se o nó deve ser destacado. Use, por exemplo, para representar um caminho específico no gráfico destacando vários nós e bordas. Padronizado como false.