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á.
Este tópico de documentação foi desenvolvido para espaços de trabalho do Grafana compatíveis com o Grafana versão 10.x.
Para espaços de trabalho do Grafana compatíveis com o Grafana versão 9.x, consulte Trabalhar no Grafana versão 9.
Para espaços de trabalho do Grafana compatíveis com o Grafana versão 8.x, consulte Trabalhar no Grafana versão 8.
Os grafos 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 grafo de nós requer uma forma específica dos dados para poder exibir os nós e as bordas. Nem toda fonte de dados ou consulta pode ser visualizada com esse grafo. Se você quiser usar isso como desenvolvedor de fonte de dados, consulte a seção sobre API de dados.
Um 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.
Nós
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 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 que suporta essa visualização é a fonte de AWS X-Ray dados de seu recurso de mapa de serviços. Para obter mais informações, consulte Conecte-se a uma fonte AWS X-Ray de dados.
Navegar pelo grafo de nós
Panorâmico
Você pode fazer uma panorâmica no grafo de nós 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 grafo de nós ou pode usar a roda do mouse ou outra entrada de rolagem com a tecla Ctrl (ou Cmd).
Explorar 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 selecioná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 (˄ ou ˅) mostra qual estatística é usada atualmente para a classificação e a direção de classificação.
Escolha um nó e, em seguida, selecione a opção Mostrar no layout do grafo para 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 |
|---|---|---|
título |
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 |
color |
string e número |
Pode ser usado para especificar uma única cor em vez de usar os campos |
icon |
string |
Nome do ícone a ser exibido dentro do nó em vez das estatísticas padrão. Somente ícones integrados do Grafana são permitidos (verifique os ícones disponíveis aqui |
Raio do nó |
número |
Valor do raio em pixels. Usado para gerenciar o tamanho do nó. |
destacado |
Booliano |
Define se o nó deve ser destacado. Use, por exemplo, para representar um caminho específico no grafo destacando vários nós e bordas. O padrão é |
