As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
Painel do grafo de nós
Este tópico de documentação foi desenvolvido para espaços de trabalho do Grafana compatíveis com o Grafana versão 9.x.
Para espaços de trabalho do Grafana compatíveis com o Grafana versão 10.x, consulte Trabalhar no Grafana versão 10.
Para espaços de trabalho do Grafana compatíveis com o Grafana versão 8.x, consulte Trabalhar no Grafana versão 8.
O painel do grafo de nós visualiza redes ou grafos direcionados. Ele usa o layout de força direcionada para posicionar os nós de forma eficaz para que possa ajudar na exibição de mapas complexos de infraestrutura, hierarquias ou diagramas de execução.
Requisitos de dados
O painel do grafo de nós requer uma forma específica dos dados para poder exibir os nós e bordas. Nem toda fonte de dados ou consulta pode ser visualizada nesse painel.
A visualização do grafo de nós consiste em nós e bordas.
-
Um nó é exibido como um círculo. Um nó pode representar uma aplicação, um serviço ou qualquer outra coisa que seja relevante sob a perspectiva da aplicação.
-
Uma borda é exibida como uma linha que conecta dois nós. A conexão pode ser uma solicitação, uma operação ou outra relação entre os dois nós.
Tanto os nós como as bordas podem ter metadados ou estatísticas associados. A fonte de dados define quais informações e valores serão mostrados, pois as diferentes fontes de dados poderão mostrar diversos 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 até um. 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 para outras partes do espaço de trabalho do Grafana ou qualquer link externo.
nota
O grafo de nós pode mostrar apenas 1.500 nós. Se esse limite for ultrapassado, um aviso ficará visível no canto superior direito, e alguns nós ficarão ocultos. Você pode expandir partes ocultas do grafo clicando nos marcadores de nós ocultos no grafo.
Edges (Bordas)
As bordas também podem mostrar estatísticas ao passar 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 compatível com essa visualização é a fonte de dados AWS X-Ray para o seu recurso de mapa de serviços. Para ter mais informações, consulte Conecte-se a uma fonte AWS X-Ray de dados.
Navegar pelo grafo de nós
Você pode fazer uma panorâmica no grafo de nós escolhendo fora de qualquer nó ou borda e arrastando o ponteiro.
Você pode aumentar o zoom usando os botões no canto superior esquerdo do grafo de nós.
Nós ocultos
O número de nós mostrados em um determinado momento é limitado para manter uma performance razoável. Os nós que estão fora desse limite estão ocultos atrás de marcadores clicáveis que mostram um número aproximado de nós ocultos conectados a essa borda. Você pode escolher o marcador para expandir o grafo 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 grafo. 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 mostra qual estatística é usada atualmente para a classificação e a direção de classificação.
Escolha o nó e, em seguida, a opção Mostrar no layout do grafo a fim de voltar ao layout do grafo com foco no nó selecionado, para mostrá-lo no contexto do grafo 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 grafo de nós requer, no mínimo, um quadro de dados descrevendo as bordas do grafo. Por padrão, o grafo 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 frame.meta.preferredVisualisationType = 'nodeGraph' nos dois quadros de dados ou nomeá-los como nodes e edges, respectivamente, para que o grafo de nós seja renderizado.
Dados de bordas 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 |
ID do destino. |
Campos opcionais:
| Nome do campo | Tipo | Descrição |
|---|---|---|
|
estatística principal |
string e 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 |
|
estatística secundária |
string e número |
O mesmo que estatística principal, mas mostrada logo abaixo dela. |
|
detalhe__* |
string e número |
Qualquer campo prefixado com |
Dados de nós da estrutura
Campos obrigatórios:
| Nome do campo | Tipo | Descrição |
|---|---|---|
|
id |
string |
Identificador exclusivo do nó. Esse ID é referenciado pela borda 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. |
|
estatística principal |
string e 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. |
|
estatística secundária |
string e número |
O mesmo que estatística principal, mas mostrada abaixo dela dentro do nó. |
|
arco__* |
número |
Qualquer campo prefixado com |
|
detalhe__* |
string e número |
Qualquer campo prefixado com |
