Gerenciar gráficos em painéis

Compatível com:

Este documento explica como gerenciar as configurações de gráficos em painéis.

Um painel é composto por gráficos preenchidos com dados usando consultas YARA-L. Os gráficos nos painéis simplificam dados complexos, revelando tendências e padrões por meio de recursos visuais. O tipo de gráfico usado depende dos dados e dos insights necessários.

Adicionar um gráfico

Para adicionar um gráfico ao painel, faça o seguinte:

  1. Na página Editar painel, clique em Adicionar gráfico.

  2. No editor de consultas, insira uma consulta YARA-L para analisar e transformar seus dados. Use o prefixo de campo YARA-L correto para a fonte de dados que você quer consultar. Para conferir uma lista de fontes de dados e os prefixos necessários, consulte Fontes de dados do painel e prefixos de campo. Também é possível conferir e usar consultas anteriores em Histórico, sua pesquisa salva ou consultas que foram compartilhadas com você anteriormente.

  3. Selecione um período Absoluto ou Relativo. Consulte Entender a Pesquisa para detalhes do operador Período relativo.

  4. Clique em Executar pesquisa. Os resultados são mostrados em formato tabular, que serve como o tipo de gráfico padrão.

  5. Em Detalhes do gráfico, insira um nome para o gráfico.

  6. Opcional: clique em Tipo de gráfico e selecione um tipo para mudar o formato dos resultados da pesquisa em tabela. Para mais informações sobre os tipos de gráfico disponíveis, consulte Tipos de gráfico.

  7. Mude as configurações do gráfico de acordo com seus requisitos.

  8. Revise os resultados e clique em Adicionar ao painel.

Mostrar valores zero em gráficos de linha do tempo

Para traçar intervalos de tempo vazios como 0 em vez de desenhar linhas contínuas entre pontos de dados diferentes de zero em gráficos de linha do tempo, siga estas diretrizes:

  • Mantenha os carimbos de data/hora como objetos de tempo cronológico, em vez de rótulos de string personalizados. A formatação de carimbos de data/hora como rótulos de string faz com que o painel trate os pontos de dados como categorias discretas.
  • Use constantes de granularidade integradas do YARA-L (por exemplo, HOUR ou DAY) dentro da função timestamp.get_timestamp(). Isso permite que o painel mostre linhas do tempo contínuas e preencha intervalos inativos com zeros.

Para mais informações e exemplos de consulta, consulte Mostrar valores zero em gráficos de linha do tempo.

Adicionar um gráfico da biblioteca de gráficos

A biblioteca de gráficos simplifica a criação de painéis, permitindo que você navegue e adicione gráficos preexistentes. Em vez de criar todos os gráficos do zero, você pode escolher entre uma coleção de gráficos de sistema selecionados ou gráficos personalizados criados pela sua organização.

Ao editar um painel, você pode acessar a biblioteca de gráficos em uma caixa de diálogo. Ele fornece uma lista paginada e pesquisável (pesquisa baseada em texto que não diferencia maiúsculas de minúsculas no nome ou na descrição) de gráficos categorizados em duas guias:

  • Gráficos selecionados: gráficos padrão fornecidos pelo Google SecOps que abrangem operações de segurança comuns e métricas do sistema, por exemplo, capacidade de processamento de ingestão, contagem de erros e distribuições de eventos.
  • Gráficos personalizados: gráficos criados por usuários na sua organização.

Quando você adiciona um gráfico da biblioteca, o Google SecOps duplica a configuração no painel de destino. O gráfico adicionado se torna uma cópia distinta, permitindo que você o modifique sem afetar o gráfico original da biblioteca ou outros painéis que o utilizam.

Para adicionar um gráfico da biblioteca, faça o seguinte:

  1. Na página Editar painel, clique na seta para baixo ao lado de Adicionar gráfico.
  2. Selecione Adicionar da biblioteca de gráficos no menu suspenso.
  3. Na caixa de diálogo Adicionar da biblioteca de gráficos, selecione a guia Selecionados ou Personalizados para filtrar por origem do gráfico.
  4. Opcional: use a barra de pesquisa para filtrar gráficos por nome ou descrição. A pesquisa não diferencia maiúsculas de minúsculas e corresponde a termos nos dois campos.
  5. Selecione uma linha na tabela de dados.
  6. Clique em Adicionar para copiar o gráfico para o painel. A caixa de diálogo é fechada, e o novo gráfico aparece no painel.

Os gráficos são mostrados em uma tabela com as seguintes colunas:

  • Nome: o nome de exibição do gráfico.
  • Descrição: uma breve explicação do que o gráfico mostra.
  • Fonte de dados: as fontes de dados usadas pelo gráfico.
  • Criador: o usuário que criou o gráfico ou o Google SecOps para gráficos selecionados.

Uso da API

A funcionalidade da biblioteca de gráficos é exposta usando o serviço ChartRepository.

  • Listar gráficos: use DashboardChartService.ListDashboardCharts para recuperar os gráficos disponíveis. Você pode filtrar por chart_type, por exemplo, CURATED ou CUSTOM, e aplicar consultas de pesquisa.
  • Duplicar gráficos: use NativeDashboardService.DuplicateChart para copiar um gráfico da biblioteca para um painel específico.

Limitações da biblioteca de gráficos

Ao usar a biblioteca de gráficos, lembre-se das seguintes restrições:

  • Só é possível acessar a biblioteca de gráficos e adicionar gráficos quando o painel está no modo de edição.
  • A biblioteca só permite adicionar blocos de visualização, como gráficos. Os blocos de Markdown e de botão de link não estão disponíveis na biblioteca e ainda precisam ser criados do zero.
  • Não é possível editar, renomear ou excluir os gráficos originais armazenados na biblioteca diretamente da interface dela.
  • Os gráficos personalizados na biblioteca são limitados à sua organização. Não é possível acessar gráficos personalizados de outros clientes do Google SecOps.
  • Se um gráfico for copiado para outro painel e o original for excluído, ele não vai mais aparecer na lista.
  • Se um gráfico for adicionado a um painel do próprio painel, ele será duplicado, e o prefixo Copy of será adicionado ao nome dele.

Editar um gráfico

  1. Na página Editar painel, clique em Editar em um gráfico para fazer mudanças.

  2. No editor de consultas, modifique a consulta YARA-L para analisar e transformar seus dados. Você também pode ver e usar consultas anteriores do seu histórico, pesquisas salvas ou consultas compartilhadas.

  3. Modifique o período conforme necessário e clique em Executar consulta.

  4. Mude as configurações do gráfico de acordo com suas necessidades.

  5. Revise os resultados e clique em Salvar para salvar as alterações no gráfico.

Excluir um gráfico

Para excluir um gráfico, faça o seguinte:

  1. Na página Editar painel, clique em Menu no gráfico que você quer excluir e clique em Excluir.

  2. Clique em Confirmar para excluir o gráfico.

Atualizar um gráfico

É possível atualizar um gráfico para limpar o cache e mostrar os dados mais recentes.

  • Na página Painéis, clique em Atualizar para atualizar o gráfico.

Ver um gráfico como uma tabela

É possível visualizar qualquer gráfico em formato de tabela para conferir os dados subjacentes.

Para ver um gráfico como uma tabela, faça o seguinte:

  • Na página Painéis, clique em Menu ao lado de um gráfico e em Ver como tabela.

Ver uma consulta

É possível conferir uma consulta de qualquer gráfico em um painel para entender como os dados são gerados e mostrados. Você pode copiar, executar ou modificar a consulta, conforme necessário.

Para ver a consulta, faça o seguinte:

  1. Na página Painéis, clique em Menu ao lado de um gráfico e em Ver consulta.

  2. Opcional: clique em Executar na Pesquisa para executar a consulta na Pesquisa.

  3. Opcional: clique em Copiar para copiar a consulta na área de transferência.

Adicionar um botão

É possível adicionar botões a um painel e usá-los para abrir um link. Por exemplo, você pode adicionar um botão que se vincula a um sistema de venda de ingressos de terceiros.

Para adicionar um botão, faça o seguinte:

  1. Na página Editar painel, clique em Adicionar > Botão.

  2. Na caixa de diálogo Criar botão, insira um nome para o botão no campo Rótulo do botão.

  3. Insira um link que será aberto quando você clicar no botão. Somente links http:// e https:// são aceitos.

  4. Opcional: marque a caixa de seleção Abrir o link em uma nova guia para abrir o link em uma nova guia.

  5. No campo Descrição, insira uma descrição para o botão.

  6. Selecione Estilo do botão e Cor do botão.

  7. Clique em Salvar. O botão vai aparecer no painel quando as mudanças forem salvas.

Editar um botão

Para editar um botão, faça o seguinte:

  1. Na página Editar painel, clique em Editar no botão.

  2. Na caixa de diálogo Editar botão, faça as mudanças necessárias.

  3. Clique em Salvar. O botão vai aparecer no painel quando as mudanças forem salvas.

Fazer uma cópia de um botão

Para copiar um botão, faça o seguinte:

Excluir um botão

Para excluir um botão, faça o seguinte:

  1. Na página Editar painel, selecione o botão para excluir e clique em Excluir.

  2. Na caixa de diálogo Editar botão, clique em Remover > Confirmar para excluir o botão.

Adicionar um widget de Markdown

É possível adicionar um widget de Markdown ao painel para exibir mais informações sobre um gráfico ou painel.

Para adicionar um widget de Markdown, faça o seguinte:

  1. Na página Editar painel, clique em Adicionar > Markdown.

  2. Na caixa de diálogo Novo Markdown, insira o texto sobre o widget na caixa Conteúdo do Markdown.

  3. Na lista Cor do plano de fundo, selecione uma cor para o widget.

  4. Visualize o texto e clique em Salvar.

Editar um widget de Markdown

Para editar um widget do Markdown, faça o seguinte:

  1. Na página Editar painel, selecione um widget de Markdown para editar e clique em Editar.

  2. Modifique o texto conforme necessário e clique em Salvar.

Excluir um widget de Markdown

Para excluir um widget de Markdown, faça o seguinte:

  1. Na página Editar painel, clique em Menu no widget de Markdown que você quer excluir e clique em Excluir.

  2. Clique em Confirmar para excluir o widget de Markdown.

Selecione um tipo de gráfico

As visualizações ajudam a identificar anomalias e tendências rapidamente. Escolha o gráfico certo para visualizar seus dados de maneira eficaz. Para criar gráficos exclusivos, considere seu público-alvo e escolha um tipo de gráfico que represente melhor seus dados. Verifique se os dados estão formatados corretamente e use rótulos claros e concisos para eixos e legendas.

Gráfico de barras

Os gráficos de barras são úteis para comparar categorias de dados ou acompanhar mudanças em dados quantitativos em vários grupos ao longo do tempo. Os pontos de dados são mostrados em dois eixos, com categorias em um eixo e valores no outro. As barras podem ser orientadas verticalmente (gráficos de colunas) ou horizontalmente.

Gráfico de linhas

Os gráficos de linhas mostram tendências ou mudanças em um intervalo contínuo, como tempo, ou um gráfico de área para enfatizar o volume de mudança. O eixo horizontal (X) representa o intervalo contínuo, e o eixo vertical (Y) mostra a variável quantitativa. Os pontos de dados são conectados por linhas, destacando padrões de mudança. Os principais recursos incluem ênfase em tendências, comparação de várias séries de dados e análise de dados contínuos.

Diagrama de Sankey

Os diagramas de Sankey visualizam fluxos, relações e caminhos de dados. Eles mostram nós que representam pontos de dados conectados por links que representam o fluxo entre eles. A largura de cada link é proporcional ao volume ou peso do fluxo, o que permite identificar os principais caminhos de dados, gargalos e anomalias. Esses gráficos são especialmente úteis para visualizar eventos de segurança que envolvem caminhos de vários saltos ou fluxos direcionais, como análise de tráfego de rede, detecção de exfiltração de dados, fluxos de autenticação e monitoramento de fluxo de trabalho do SOC.

Consulte Visualizar fluxos de dados com diagramas de Sankey para ver detalhes e exemplos de casos de uso.

Gráfico de área

Os gráficos de área, semelhantes aos de linhas, enfatizam a magnitude da mudança ao longo do tempo. Eles visualizam tendências e mostram a contribuição cumulativa dos componentes para a tendência geral. O eixo horizontal (X) representa o intervalo contínuo, como o tempo, e o eixo vertical (Y) mostra a variável quantitativa. A área entre a linha e o eixo X é preenchida, destacando a magnitude do valor. Os principais recursos incluem ênfase na magnitude, o uso de gráficos de área empilhada para mostrar contribuições individuais e ao longo do tempo.

Gráfico de dispersão

Os gráficos de dispersão mostram a relação entre duas variáveis quantitativas, revelando correlações, padrões e distribuições em dados bivariados. Uma variável quantitativa é representada no eixo horizontal (X) e a outra no eixo vertical (Y). Cada ponto de dados aparece como um ponto, posicionado de acordo com os valores das duas variáveis. Os principais recursos incluem a identificação de correlações, a detecção de padrões e a análise da distribuição de dados.

Configuração do gráfico

A tabela a seguir descreve as opções de configuração comuns para gráficos de barras, linhas, área e dispersão.

Campo Descrição
Nome Insira um nome descritivo para o gráfico.
Descrição Adicione uma breve explicação sobre a finalidade do gráfico.
Eixo X Escolha o campo de dados que será exibido ao longo do eixo X (eixo horizontal).
Eixo Y Escolha o campo de dados que será exibido no eixo Y (eixo vertical).
Coloração do limite

Clique no botão para ativar a coloração de limite. Essa opção ajusta automaticamente a cor dos elementos do gráfico com base nas condições numéricas definidas.

Insira valores mínimos e máximos.

Selecione uma cor para o intervalo de limite.

Opcional: clique em Adicionar limite para adicionar mais limites.
Mostrar eixo na escala de registro Clique no botão para mostrar o eixo X usando uma escala logarítmica.
Identificador do eixo X Especifique o rótulo do eixo X (eixo horizontal).
Identificador do eixo Y Especifique o rótulo do eixo Y (eixo vertical).
Legenda Selecione onde mostrar a legenda do gráfico. Por exemplo, "Acima", "Abaixo", "Esquerda", "Direita", "Nenhum".
Detalhamentos Clique em Personalizar detalhamentos para configurar os detalhamentos. Para mais informações, consulte Detalhar gráficos.

Gráfico de tabela

Os gráficos de tabela mostram dados detalhados e estruturados em linhas e colunas, fornecendo valores precisos e permitindo comparações entre várias dimensões. Eles oferecem suporte a classificação, filtragem e paginação para melhorar a análise detalhada e a usabilidade dos dados.

Campo Descrição
Nome Insira um nome descritivo para o gráfico.
Descrição Adicione uma breve explicação sobre a finalidade do gráfico.
Configurações da tabela Adicione um rótulo para as variáveis de evento.
Detalhamentos Clique em Personalizar detalhamentos para configurar os detalhamentos. Para mais informações, consulte Detalhar gráficos.

Gráfico de pizza

Os gráficos de pizza mostram como um todo é dividido em partes, visualizando de forma eficaz o tamanho relativo de cada categoria em um único conjunto de dados. Eles representam os dados como fatias de um círculo, em que o tamanho de cada fatia corresponde à proporção do todo. Você pode usar gráficos de pizza para entender rapidamente as relações entre a parte e o todo, mas limite-os a conjuntos de dados com poucas categorias.

Campo Descrição
Nome Insira um nome descritivo para o gráfico.
Descrição Adicione uma breve explicação da finalidade do gráfico.
Campo de dados Selecione uma variável de evento adequada.
Valor dos dados Selecione uma variável de evento adequada.
Gráfico de rosca Clique no botão Gráfico de rosca para exibir os dados em forma de rosca.
Coloração de limite

Clique no botão para ativar a coloração do limite. A coloração de limite nos gráficos do painel ajusta automaticamente a cor dos elementos de dados com base em condições numéricas.

Insira os valores mínimo e máximo.

Selecione uma cor apropriada para o limite.

Opcional: clique em Adicionar limite para incluir mais cores de limite.
Legenda Selecione onde mostrar a legenda do gráfico. Por exemplo, "Acima", "Abaixo", "Esquerda", "Direita", "Nenhum".
Detalhamentos Clique em Personalizar detalhamentos para configurar os detalhamentos. Para mais informações, consulte Detalhar gráficos.

Gráfico de métricas

Os gráficos de métricas fornecem um resumo rápido dos indicadores principais de desempenho, exibindo um único valor numérico em destaque, geralmente acompanhado por um rótulo e indicadores de tendência opcionais para contexto. Eles destacam um ponto de dados específico para insights imediatos, focando em um único valor para fornecer uma compreensão clara e concisa das métricas críticas.

Campo Descrição
Nome Insira um nome descritivo para o gráfico.
Descrição Adicione uma breve explicação sobre a finalidade do gráfico.
Tipo de dados de métricas Selecione uma variável de evento adequada.
Rótulo da métrica Digite um nome descritivo para o rótulo.
Coloração de limite

Clique no botão para ativar a coloração do limite. A coloração de limite nos gráficos do painel ajusta automaticamente a cor dos elementos de dados com base em condições numéricas.

Insira os valores mínimo e máximo.

Selecione uma cor apropriada para o limite.

Opcional: clique em Adicionar limite para adicionar mais cores de limite.
Formato da métrica

Especifica como o valor da métrica é mostrado no gráfico.

Texto simples: mostra o valor da métrica como texto bruto e sem formatação.

Número: mostra o valor da métrica como um número formatado com separadores.
Mostrar tendência de dados Especifica se a tendência de dados deve ser mostrada.

A tendência compara o período atual com o período imediatamente anterior de mesma duração. Por exemplo, se você selecionar um período de last 7 days (12 a 18 de agosto), a tendência será comparada com o período de 5 a 11 de agosto. Da mesma forma, para um período absoluto, como 16 a 20 de maio, a tendência é baseada em 11 a 15 de maio.
Mostrar tendência

Mostra a tendência da métrica.

Valor absoluto: mostra o valor numérico real da métrica.

Porcentagem: mostra o valor da tendência como uma porcentagem.

Ambos: mostra o valor absoluto e a porcentagem da tendência.
Tipo de tendência

Especifica o tipo de tendência a ser exibido.

Normal: padrão. Mostra valores crescentes em verde com uma seta para cima e valores decrescentes em vermelho com uma seta para baixo.

Inversa: mostra valores crescentes em vermelho com uma seta para cima e valores decrescentes em verde com uma seta para baixo.
Detalhamentos Clique em Personalizar detalhamentos para configurar os detalhamentos. Para mais informações, consulte Detalhar gráficos.

Gráfico de mapa

Os gráficos de mapa visualizam dados geográficos representando coordenadas para revelar padrões e distribuições espaciais. Com recursos interativos, como zoom e movimentação, eles são ideais para exibir e analisar informações baseadas em localização.

Campo Descrição
Nome Insira um nome descritivo para o gráfico.
Descrição Adicione uma breve explicação sobre a finalidade do gráfico.
Latitude Selecione uma variável de evento adequada.
Longitude Selecione uma variável de evento adequada.
Campo da contagem Selecione uma variável de evento adequada.
Modo de plotagem Selecione um modo de representação adequado para marcar a latitude e a longitude de pontos geográficos individuais. Você pode selecionar Mapa de calor, Pontos ou Ambos.
Posição no mapa Clique no botão para ajustar os dados. O mapa ajusta automaticamente o nível de zoom e o ponto central para verificar se todos os pontos de dados representados estão visíveis na visualização atual.
Configurações de ponto Selecione uma opção adequada para definir o tamanho do ponto como Fixo ou Proporcional ao tamanho.
Cor Selecione uma cor adequada para as configurações de ponto.
Detalhamentos Clique em Personalizar detalhamentos para configurar os detalhamentos. Para mais informações, consulte Detalhar gráficos.
Coloração de limite

Clique no botão para ativar a coloração de limite. A coloração de limite ajusta automaticamente a cor dos pontos de plotagem e de outros elementos de dados em gráficos de painel com base em condições numéricas.

Insira os valores mínimo e máximo.

Selecione uma cor apropriada para o limite.

Opcional: clique em Adicionar limite para adicionar mais cores de limite.

Gráfico de medidor

Os gráficos de medidor representam visualmente um único valor em um intervalo definido, usando mostradores ou barras, para indicar a performance ou o progresso em relação a uma meta ou um limite.

Campo Descrição
Nome Insira um nome descritivo para o gráfico.
Descrição Adicione uma breve explicação da finalidade do gráfico.
Campo de dados Selecione uma variável de evento adequada.
Valor de exibição do medidor Selecione uma variável de evento adequada.
Mostrar valores de dados Clique no botão para mostrar os valores dos dados.
Configuração do medidor Insira um valor adequado para Valor de base e Valor limite.

Selecione uma cor apropriada para o Valor limite.

Clique em Adicionar intervalo para adicionar o Valor limite.

Detalhar gráficos

Com os detalhamentos, você pode clicar em um ponto de dados ou elemento específico em um gráfico do painel para acessar informações mais detalhadas ou relacionadas. Essa ação leva você de um resumo geral para uma visualização mais detalhada. É possível configurar o detalhamento para todos os tipos de gráficos, exceto os de medidor.

Personalizar detalhamentos

É possível configurar um detalhamento para ativar com um clique com o botão esquerdo ou direito do mouse no elemento do gráfico.

Para personalizar os detalhamentos, faça o seguinte:

  1. Na página Editar painel, clique em Editar em um gráfico.

  2. Clique em Personalizar detalhamentos.

  3. Na janela Detalhamentos, no painel à esquerda, clique em Adicionar detalhamento para criar um novo detalhamento.

  4. Em Configuração de detalhamento, insira um nome para o detalhamento.

  5. Na lista Ação, selecione uma ação apropriada para o detalhamento. Você pode selecionar qualquer uma das seguintes opções:

  6. Configure o detalhamento e clique em Concluído.

Executar pesquisa

É possível personalizar um detalhamento para executar uma consulta na Pesquisa.

  1. Na janela Detalhamentos, em Configuração de detalhamento, insira o nome no campo Nome.

  2. Na lista Ação, selecione Executar pesquisa.

  3. Opcional: marque a caixa de seleção Abrir em uma nova guia para abrir a pesquisa em uma nova guia.

  4. Na lista Mostrar campos para copiar, selecione um valor adequado para configurar o acionador. Os valores na lista são os retornados pela consulta de pesquisa original.

  5. No campo Pesquisar, digite uma consulta.

  6. Selecione o período adequado.

  7. Clique em Testar para testar a consulta na Pesquisa.

  8. Clique em Concluído.

É possível personalizar um detalhamento para abrir um link externo. Por exemplo, é possível personalizar o detalhamento para abrir a página de inteligência contra ameaças de um endereço IP clicado.

Para criar um link externo para um gatilho, faça o seguinte:

  1. Na janela Detalhamentos, em Configuração de detalhamento, insira o nome no campo Nome.

  2. Na lista Ação, selecione Abrir link externo.

  3. Opcional: marque a caixa de seleção Abrir em nova guia para abrir o link em uma nova guia.

  4. Na lista Mostrar campos para copiar, selecione um valor adequado para configurar o detalhamento. Os valores na lista são os retornados pela consulta de pesquisa original.

  5. No campo Link, insira um link que será aberto quando você clicar no acionador.

  6. Clique em Concluído.

Aplicar filtro do painel

É possível personalizar um detalhamento para selecionar e editar filtros.

Para aplicar um filtro de painel a um gatilho, faça o seguinte:

  1. Na janela Detalhamentos, em Configuração de detalhamento, insira o nome no campo Nome.

  2. Na lista Ação, selecione Aplicar filtro do painel.

  3. Clique em Adicionar filtro.

  4. Na lista Filtro, selecione um filtro.

  5. Modifique o filtro de acordo com seus requisitos.

  6. Opcional: clique em Adicionar filtro para incluir mais filtros.

  7. Opcional: clique em Excluir para excluir um filtro.

  8. Clique em Concluído para salvar as alterações.

Fazer uma cópia do detalhamento

Para copiar um detalhamento, faça o seguinte:

  • Na janela Detalhamentos, no painel à esquerda, clique no detalhamento que você quer copiar e, em seguida, clique em Duplicar.

Reordenar um detalhamento

Se você tiver vários detalhamentos de clique com o botão direito do mouse, poderá reordená-los para controlar a ordem de exibição no menu de contexto.

Para reordenar um detalhamento, faça o seguinte:

  • Na janela Detalhamentos, no painel à esquerda, arraste um detalhamento para reordenar.

Excluir um detalhamento

Para excluir um detalhamento, faça o seguinte:

  • Na janela Detalhamentos, no painel à esquerda, clique no detalhamento que você quer excluir e em Excluir.

Precisa de mais ajuda? Receba respostas de membros da comunidade e profissionais do Google SecOps.