Criação de uma consulta do Mapeamento de serviços usando o Construtor de consulta do CMDB

  • Versão de lançamento: Xanadu
  • Atualizado 1 de ago. de 2024
  • 6 min. de leitura
  • O tipo de consulta do Mapeamento de serviços é um padrão que consiste em classes e relacionamentos entre essas classes. Depois de criar o padrão e executar a consulta, a consulta retorna todos os serviços do Mapeamento de serviços que contêm esse padrão.

    Antes de Iniciar

    Função necessária: cmdb_query_builder_read para exibir e executar somente consultas salvas, e cmdb_query_builder (contida para itil, itil_admin e asset) para criar e salvar consultas, modificar consultas salvas e executar consultas.

    Usuários autorizados podem atualizar e excluir uma consulta criada por outro usuário.

    Por Que e Quando Desempenhar Esta Tarefa

    Para criar a consulta, arraste as classes de IC que você deseja incluir na consulta, solte-as como nó na tela e defina as propriedades de relacionamento entre elas. Em cada nó classe da consulta, você pode filtrar seus atributos para restringir os resultados a um conjunto específico de ICs dessa classe ou a um único IC específico. Você também pode selecionar quais colunas de propriedade devem ser exibidas nos resultados da consulta.

    Ao avançar na criação de uma consulta, as opções de lista e outros elementos da interface do usuário do Construtor de consulta do CMDB são filtrados de forma dinâmica, conforme apropriado para as suas seleções.

    Consulte Consultas de exemplo para obter orientações passo a passo de como criar uma consulta do Mapeamento de serviços no Construtor de consulta do CMDB.

    Procedimento

    1. Navegar até Todos > Configuração > Construtor de consulta do CMDB.
    2. Na página do Construtor de consulta do CMDB, execute uma destas opções:
      1. Selecione Criar novo.
      2. Insira um Nome.
      3. Selecione Consulta de mapeamento de serviços como o Tipo de consulta.
      4. Selecione Criar.
      5. Selecione um widget de uma consulta salva para continuar criando uma consulta existente. Como pesquisar uma consulta salva primeiro, se necessário.
      6. Aponte para o canto superior direito de um widget de consulta salva.
      7. Selecione o ícone Duplicar consulta para editar uma cópia de uma consulta salva.
        O nome padrão da nova consulta contém a "cópia" da cadeia de caracteres.
    3. Na tela, é possível executar qualquer uma destas opções:
      • Adicionar classes de IC à consulta: selecione classes da lista de hierarquia Classes do CMDB e arraste-as para a tela.
      • Adicionar conexões (relacionamentos) entre dois nós na tela:
        1. No primeiro nó do relacionamento, selecione o pequeno quadrado no centro do lado direito.
        2. No segundo nó do relacionamento, selecione o pequeno quadrado no centro do lado esquerdo para criar a conexão.
        3. Em Propriedades da conexão na barra lateral direita, defina as seguintes configurações (selecione a linha de conexão se necessário):
          • Na seção "Direção do relacionamento", selecione o nó Primário (o nó Secundário se ajustará automaticamente).
          • Na seção Propriedades da consulta de serviço, selecione Localizar ICs relacionados ou Localizar ICs não relacionados para consultar um padrão no qual as duas classes mantenham ou não relacionamentos entre si, respectivamente.

            Por exemplo, Todos os ICs do Tomcat WAR não conectados a um servidor Windows.

        Tabela 1. Notações de IU de relacionamento
        Notação Descrição
        Linha tracejada Um relacionamento em uma consulta do Mapeamento de serviços.
      • Adicionar filtros a um nó classe: aplique filtros para restringir uma classe a um conjunto específico de ICs ou a um único IC específico.
        1. Aponte para o nó ao qual adicionar um filtro e selecione o ícone Aplicar filtros que aparece acima do nó.
        2. Na seção Filtros, adicione o atributo e as condições da lista relacionada.
        3. Feche a seção Filtros.
        Por exemplo: adicione um filtro de criticalidade de negócio para consultar os negócios considerados "extremamente críticos".

        Selecione Filtros aplicados na barra lateral direita para exibir todos os filtros de cada nó na tela.

      • Adicionar operadores E/OU à consulta:
        1. Conecte um nó a dois outros nós.
        2. Selecione a caixa E que é exibida na linha de conexão para alternar entre os operadores E e Ou.

        Por exemplo, C1 é Tomcat WAR, C2 é Servidor Linux e C3 é Servidor Windows. Consulte todos os ICs do Tomcat WAR conectados ao servidor Linux ou a um servidor Windows.

      • Adicionar colunas de propriedade de um nó que deverão ser exibidas nos resultados da consulta:
        Nota:
        em um relacionamento, os resultados da consulta são exibidos nas colunas parent, child e type. Não é possível adicionar outras colunas da tabela [cmdb_rel_ci].
        1. Selecione Propriedades no painel lateral direito.
        2. Selecione um nó uma ou duas vezes para que a seção "Colunas do relatório" do nó seja exibida na barra lateral direita e selecione Adicionar colunas.
        3. Selecione as propriedades e clique fora da lista de propriedades para fechá-la.
      • Selecionar colunas e adicionar filtros que serão aplicados ao conjunto de serviços resultante:
        1. Selecione Propriedades na barra lateral direita e selecione um espaço vazio na tela para garantir que nada seja selecionado.
        2. Selecione Adicionar colunas na parte inferior da barra lateral direita e selecione as colunas para adicionar. Selecione um ponto fora da lista de colunas para fechá-la.
        3. Selecione o ícone Aplicar filtros de consulta de mapeamento de serviço na parte superior da tela e adicione filtros.
      • Inverter toda a consulta e pesquisar todos os serviços do Mapeamento de serviços que não incluem o padrão de consulta: clique em um nó uma ou duas vezes para que as "Propriedades da consulta" sejam exibidas na barra lateral direita. Na seção Metadados, alterne os Serviços que Incluem este padrão para habilitar ou desabilitar a opção.
      • Adicionar um marcador de pesquisa que pode ser usado como critério de pesquisa para consultas salvas:
        1. Selecione o ícone Adicionar marcadores na parte superior da tela.
        2. Selecione Adicionar marcador e, na caixa de diálogo Marcadores de consulta, insira uma ou mais cadeias de caracteres de marcador.
        3. Selecione o ícone Adicionar marcadores novamente para fechar a caixa de diálogo Marcadores de consulta.
    4. Selecione Salvar.

      Na guia Consultas salvas, aponte para um widget de consulta salva e selecione Informações da consulta para exibir detalhes da consulta, como o tipo de consulta, a data da última atualização e os cronogramas de consulta.

    O que Fazer Depois

    • Selecione Executar.

      O painel de resultados da consulte exibe apenas os 100 primeiros resultados da consulta.
      • Selecione Carregar mais resultados para mostrar o próximo conjunto de 100 resultados.
      • Selecione Carregar todos os resultados para mostrar o restante dos resultados da consulta, até o número especificado pela propriedade de sistema glide.cmdb.query.max_results_limit (10.000 por padrão).

      Selecione um IC para abrir o formulário de IC e, no formulário de IC, selecione Abrir no Espaço do CMDB para exibir a integridade do IC no bloco Integridade do IC no Espaço do CMDB. Esta operação requer a função sn_cmdb_user (usuário do CMDB).

      Nota:
      Quando uma consulta estiver em execução, aguarde a conclusão ou o tempo limite antes de abrir ou executar outra consulta.
    • Modificar configurações do Construtor de consulta: selecione o ícone "Configurações" (ícone de Configurações) para abrir a caixa de diálogo Configurações do Construtor de consulta.
    • Copiar e compartilhar a URL de uma consulta salva com usuários que tenham acesso ao Construtor de consulta do CMDB. Colar o URL compartilhado em uma nova janela do navegador da Internet abre diretamente a consulta salva no Construtor de consulta do CMDB.
    • Criação de um relatório no Construtor de consulta do CMDB.
    • Crie uma programação para executar a consulta no futuro e enviar os resultados por e-mail às partes interessadas.
    • Exportar os resultados da consulta:

      Exportar resultados visíveis da consulta: selecione o menu contextual "Resultados da consulta" e selecione Exportar. Mesmo se o botão Carregar mais resultados estiver visível, indicando a existência de resultados adicionais da consulta, somente os resultados visíveis serão exportados.

    • Exportar e importar uma consulta do CMDB para transmitir uma definição de consulta entre instâncias.
    • Preencha um grupo do CMDB usando a consulta salva.
    • Excluir consultas do CMDB.