Criando widgets por meio de uma origem de dados de consulta dinâmica

A origem de dados Procura dinâmica usa a API de procura dinâmica IBM® QRadar® para procurar dados que envolvem funções agregadas, como COUNT, SUM, MAX e AVG. Por exemplo, é possível contar o número de IDs de ativos por nome do host usando a função COUNT_PER.

Antes de iniciar

Seu administrador deve fornecer uma procura dinâmica na forma de um script JSON.

A opção Procura Dinâmica requer QRadar 7.4.1.2020.3.2.20201112005343 (Fix Pack 2) ou mais recente.

Se a versão do QRadar for 7.4.3 ou mais recente e você for um administrador, clique no link Construtor de consulta de procura dinâmica para que seja possível construir uma consulta e salvá-la como um script JSON para usar como uma consulta de widget.

Sobre esta tarefa

É possível construir sua consulta nas origens de dados a seguir:

  • Ativos
  • Ofensas
  • Vulninstances

É possível incluir um campo sem uma função como um campo simples ou um campo com uma função como um campo complexo para construir colunas. É possível também incluir condições para filtrar seus dados.

Procedimento

  1. Clique em Configurar painel.

    A tela Configurar painel exibe uma biblioteca de widgets disponíveis, com detalhes sobre cada widget.

  2. Clique em Criar novo widget.
  3. Na página Novo Item do Painel , digite um nome e uma descrição para o widget.
  4. Selecione Busca Dinâmica a partir da lista de origem de dados na seção Consulta , e digite uma consulta JSON.
  5. Opcional: Se a versão do QRadar for 7.4.3 ou posterior e você for um administrador, clique no link Construtor de consultas de procura dinâmica para construir uma consulta.
    1. Selecione um Origem de Dados.
    2. Complete as seções Colunas Disponíveis e Filtros Disponíveis .
    3. Para adicionar um nome, descrição, intervalo da pesquisa, período de retenção ou tipo de pesquisa à sua consulta, habilitar um ou mais Propriedades de Pesquisa Extra.
    4. Para copiar seu script JSON, clique em Gerar JSON.
      Seus resultados aparecem na seção JSON gerado por sua consulta. Clique em Copiar à área de transferência para copiar seu script JSON.
    5. Na página Novo item de painel , cole o script JSON copiado
  6. Opcional: Inclua parâmetros na consulta de pesquisa dinâmica.
    1. Inserir parâmetros existentes na consulta. Clique no ícone Inserir parâmetro e, em seguida, clique em Inserir para cada parâmetro relevante.
      Importante: Em consultas de procura dinâmica, os parâmetros devem ser precedidos por um sinal de dólar (por exemplo, ${NumberOfRules}).
    2. Para alterar o valor padrão do parâmetro, clique no ícone Parâmetros De Visualização e clique em Salvar depois de configurar o valor padrão.
      Ao mudar o valor padrão de um parâmetro, ele é mudado em todos os lugares nos quais o parâmetro é usado em sua área de trabalho, exceto em painéis e widgets expandidos ou fixados. Se você não configurar o valor como padrão, a mudança atualizada se aplicará apenas à sessão atual. No entanto, se você configurar o valor como padrão, o valor da sessão atual também usará esse valor.

      O parâmetro SYSTEM:username predefinido retorna o nome do usuário que está conectado. Os parâmetros do sistema são do tipo somente leitura e não é possível mudar o valor padrão.

    3. Para adicionar um parâmetro em sua área de trabalho, clique em Adicionar, dê ao parâmetro um nome e valor padrão, se necessário, e em seguida, clique em Salvar.

      Após incluir parâmetros em um widget de um painel pela primeira vez, a placa Parâmetros aparece no painel. Quando você remove parâmetros do widget e nenhum outro widget nesse painel usa o parâmetro, a placa Parâmetros desaparece.

  7. Clique em Executar Consulta.
    Quando você cria o widget pela primeira vez, não é possível configurar os gráficos quando nenhum resultado de dados é retornado. Tente tornar os critérios nos campos menos rigorosos e execute a consulta novamente.
  8. Crie um gráfico de painel na seção Visualizações .
    Como é possível criar várias visualizações e gráficos por meio da mesma consulta, dê um nome exclusivo à visualização. Por padrão, o título e o status do gráfico na barra de título são exibidos; para ocultá-los, clique no ícone Mais opções e alterne as configurações para Desativado.
  9. Selecione um tipo de gráfico e configure as propriedades relevantes. Para obter casos de uso para ajudar a decidir qual tipo de gráfico usar, consulte Tipos de gráfico de widget.
    Tipo de gráfico Instruções
    Barra Criando um gráfico de barras
    Número Grande Criando um gráfico de número grande
    Geográfico Criando um gráfico geográfico
    Setor Criando um Gráfico de Setores Circulares
    Dispersão Criando um gráfico de dispersão
    Tabular Criando um gráfico tabular
    Séries temporais Criando um gráfico de série temporal
  10. Preview como o gráfico parece e depois clique em Salvar.
    Dica: os rótulos para o gráfico têm como origem as consultas usadas. Se eles forem ininteligíveis no visualização, edite os rótulos na seção Visualizar.