Reorganizamos a estrutura de navegação da documentação para se alinhar diretamente aos seus fluxos de trabalho operacionais. Consulte as notas da versão e o vídeo explicativo para mais informações.

O Google usa tecnologia de IA na tradução de conteúdos para seu idioma de preferência. As traduções com IA podem ter erros.

Gerenciar gráficos em painéis

Compatível com:

Google SecOps SIEM

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

Um painel é composto de 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:

Na página Editar painel, clique em Adicionar gráfico.
No editor de consultas, insira uma consulta em YARA-L para analisar e transformar seus dados. Você também pode conferir e usar consultas anteriores em Histórico, na pesquisa salva ou em consultas compartilhadas com você anteriormente.
Selecione um período Absoluto ou Relativo. Consulte Entender a Pesquisa para detalhes do operador Período relativo.
Clique em Executar pesquisa. Os resultados são mostrados em formato tabular, que serve como o tipo de gráfico padrão.
Em Detalhes do gráfico, insira um nome para o gráfico.
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áficos disponíveis, consulte Tipos de gráficos.
Mude as configurações do gráfico de acordo com seus requisitos.
Analise os resultados e clique em Adicionar ao painel.

Mostrar valores zero em gráficos de linha do tempo

Para representar intervalos de tempo vazios como 0 em vez de desenhar linhas contínuas entre pontos de dados diferentes de zero nos 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 YARA-L integradas (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 consultas, 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 selecionar entre uma coleção de gráficos do sistema selecionados ou gráficos personalizados criados pela sua organização.

Ao editar um painel, você pode acessar a biblioteca de gráficos por uma caixa de diálogo. Ela oferece uma lista pesquisável (pesquisa de texto sem diferenciação de maiúsculas e minúsculas por nome ou descrição) e paginada 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 e métricas do sistema comuns, por exemplo, capacidade de processamento de ingestão, contagens 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 do gráfico 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 usam.

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

Na página Editar painel, clique na seta para baixo ao lado de Adicionar gráfico.
Selecione Adicionar da biblioteca de gráficos no menu suspenso.
Na caixa de diálogo Adicionar da biblioteca de gráficos, selecione a guia Organizado ou Personalizado para filtrar por origem do gráfico.
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.
Selecione uma linha na tabela de dados.
Clique em Adicionar para copiar o gráfico ao painel. A caixa de diálogo é fechada, e o novo gráfico aparece no painel.

Os gráficos aparecem em uma tabela com as seguintes colunas:

Nome: o nome de exibição do gráfico.
Descrição: uma breve explicação sobre o 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. É possível 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 Editar.
A biblioteca só permite adicionar blocos de visualização, como gráficos. Os blocos de Markdown e 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 restritos à 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

Na página Editar painel, clique em Editar em um gráfico para fazer mudanças.
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.
Modifique o período conforme necessário e clique em Executar consulta.
Mude as configurações do gráfico de acordo com seus requisitos.
Analise os resultados e clique em Salvar para salvar as mudanças no gráfico.

Excluir um gráfico

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

Na página Editar painel, clique em Menu no gráfico que você quer excluir e clique em Excluir.
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 conferir qualquer gráfico em formato de tabela para ver os dados dele.

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:

Na página Painéis, clique em Menu ao lado de um gráfico e em Ver consulta.
Opcional: clique em Executar na pesquisa para executar a consulta na Pesquisa.
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:

Na página Editar painel, clique em Adicionar > Botão.
Na caixa de diálogo Criar botão, insira um nome para o botão no campo Rótulo do botão.
Insira um link que será aberto quando você clicar no botão. Somente links http:// e https:// são aceitos.
Opcional: marque a caixa de seleção Abrir o link em uma nova guia para abrir o link em uma nova guia.
No campo Descrição, insira uma descrição do botão.
Selecione Estilo do botão e Cor do botão.
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:

Na página Editar painel, clique em Editar no botão.
Na caixa de diálogo Botão Editar, faça as mudanças necessárias.
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:

Na página Editar painel, clique em Copiar.

Excluir um botão

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

Na página Editar painel, selecione o botão a ser excluído e clique em Excluir.
Na caixa de diálogo Editar botão, clique em Remover > Confirmar para excluir o botão.

Adicionar um widget Markdown

Adicione um widget do Markdown ao painel para mostrar mais informações sobre um gráfico ou painel.

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

Na página Editar painel, clique em Adicionar > Markdown.
Na caixa de diálogo Novo Markdown, insira o texto sobre o widget na caixa Conteúdo do Markdown.
Na lista Cor de plano de fundo, selecione uma cor para o widget.
Visualize o texto e clique em Salvar.

Editar um widget de markdown

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

Na página Editar painel, selecione um widget do Markdown para editar e clique em Editar.
Modifique o texto conforme necessário e clique em Salvar.

Excluir um widget de Markdown

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

Na página Editar painel, clique em Menu no widget do Markdown que você quer excluir e clique em Excluir.
Clique em Confirmar para excluir o widget do Markdown.

Selecione um tipo de gráfico

As visualizações ajudam a identificar rapidamente anomalias e tendências. Escolha o gráfico certo para visualizar seus dados de maneira eficaz. Para criar gráficos exclusivos, pense no seu público-alvo e escolha um tipo 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 rastrear mudanças em dados quantitativos em vários grupos ao longo do tempo. Os pontos de dados são representados em dois eixos, com categorias em um e valores no outro. As barras podem ser orientadas na vertical (gráficos de colunas) ou na horizontal.

Gráficos 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.

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, enquanto 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 e o uso de gráficos de área empilhados para mostrar contribuições individuais 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 identificar correlações, detectar padrões e analisar a 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, de linhas, de área e de 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 a ser mostrado ao longo do eixo X (horizontal).
Eixo Y	Escolha o campo de dados que será mostrado ao longo do eixo Y (vertical).
Coloração de 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 incluir mais limites.
Mostrar eixo na escala de registro	Clique no botão de alternância para mostrar o eixo X usando uma escala logarítmica.
Identificador do eixo X	Especifique o marcador do eixo X (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. 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 em 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. 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 dados como fatias de um círculo, em que o tamanho de cada fatia corresponde à sua proporção do todo. Use gráficos de pizza para entender rapidamente e de forma visual 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 sobre a finalidade do gráfico.
Campo de dados	Selecione uma variável de evento adequada.
O valor dos dados	Selecione uma variável de evento adequada.
Gráfico de rosca	Clique na opção Gráfico de rosca para mostrar os dados em formato de rosca.
Coloração de limite	Clique no botão para ativar a coloração de limite. A coloração por limite nos gráficos do painel ajusta automaticamente a cor dos elementos de dados com base em condições numéricas. Insira valores mínimos e máximos. Selecione uma cor adequada para o limite. Opcional: clique em Adicionar limite para adicionar 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. Para mais informações, consulte Detalhar gráficos.

Gráfico de métricas

Os gráficos de métricas oferecem um resumo rápido dos indicadores principais de performance mostrando um único valor numérico em destaque, geralmente acompanhado de 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	Insira um nome descritivo para o marcador.
Coloração de limite	Clique no botão para ativar a coloração de limite. A coloração por limite nos gráficos do painel ajusta automaticamente a cor dos elementos de dados com base em condições numéricas. Insira valores mínimos e máximos. Selecione uma cor adequada 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 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.
Tendência de exibição	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 exibida. 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. 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 panorâmica, eles são ideais para mostrar 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 gráfico	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 na chave 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 escolher 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. 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 por limite ajusta automaticamente a cor dos pontos de plotagem e outros elementos de dados nos gráficos do painel com base em condições numéricas. Insira valores mínimos e máximos. Selecione uma cor adequada 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 dentro de um intervalo definido, usando mostradores ou barras, para indicar o desempenho 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 sobre a 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 na opção para mostrar os valores de dados.
Configuração do medidor	Insira um valor adequado para Valor de base e Valor limite. Selecione uma cor adequada para o Valor do limite. Clique em Adicionar intervalo para incluir um Valor de limite.

Detalhamento em 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 muda 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

Você pode configurar um detalhamento para ativar com um clique com o botão esquerdo ou direito do mouse no elemento do gráfico.

Para personalizar detalhamentos, faça o seguinte:

Na página Editar painel, clique em Editar em um gráfico.
Clique em Personalizar detalhamentos.
Na janela Detalhamentos, no painel à esquerda, clique em Adicionar detalhamento para criar um novo detalhamento.
Em Configuração de detalhamento, insira um nome para o detalhamento.
Na lista Ação, selecione uma ação adequada para o detalhamento. Você pode selecionar uma das seguintes opções:
- Executar pesquisa
- Aplicar filtro do painel
- Abrir link externo
Configure o detalhamento e clique em Concluído.

Executar pesquisa

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

Na janela Detalhamentos, em Configuração de detalhamento, insira o nome no campo Nome.
Na lista Ação, selecione Executar pesquisa.
Opcional: marque a caixa de seleção Abrir em uma nova guia para abrir a pesquisa em uma nova guia.
Na lista Mostrar campos para copiar, selecione um valor adequado para configurar o gatilho. Os valores na lista são os retornados pela consulta de pesquisa original.
No campo Pesquisar, digite uma consulta.
Selecione o período adequado.
Clique em Testar para testar a consulta na Pesquisa.
Clique em Concluído.

Abrir link externo

É 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:

Na janela Detalhamentos, em Configuração de detalhamento, insira o nome no campo Nome.
Na lista Ação, selecione Abrir link externo.
Opcional: marque a caixa de seleção Abrir em uma nova guia para abrir o link em uma nova guia.
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.
No campo Link, insira um link que será aberto quando você clicar no gatilho.
Clique em Concluído.

Aplicar filtro do painel

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

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

Na janela Detalhamentos, em Configuração de detalhamento, insira o nome no campo Nome.
Na lista Ação, selecione Aplicar filtro do painel.
Clique em Adicionar filtro.
Na lista Filtro, selecione um filtro.
Modifique o filtro de acordo com seus requisitos.
Opcional: clique em Adicionar filtro para incluir mais filtros.
Opcional: clique em Excluir para excluir um filtro.
Clique em Concluído para salvar as alterações.

Fazer uma cópia do detalhamento

Para fazer uma cópia de um detalhamento, faça o seguinte:

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

Reordenar um detalhamento

Se você tiver vários detalhamentos com clique direito, 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 esquerdo, 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 clique em Excluir.

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