Criar uma consulta do CMDB usando o Construtor de consulta do CMDB

  • Versão de lançamento: Washingtondc
  • Atualizado 1 de fev. de 2024
  • 8 min. de leitura
  • Correspondea um tipo de consulta do CMDB que consulta a infraestrutura em busca de classes de IC e, opcionalmente, tabelas não CMDB, bem como relacionamentos e referências que os conectam.

    Antes de Iniciar

    O plug-in Core UI (com.glide.ui.ui16) deve estar ativado.

    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 e as tabelas não CMDB que você deseja incluir na consulta. Em seguida, solte-as como nó na tela e defina as propriedades de relacionamento entre elas. É possível filtrar os atributos de qualquer nó 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.

    À medida que você avança 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.

    Para saber mais sobre como usar o Construtor de consulta, consulte o vídeo Consultas e relatórios do Construtor de consulta do CMDB — Platform Analytics Academy ServiceNow Community. Para obter uma orientação passo a passo sobre como criar consultas do CMDB no Construtor de consulta do CMDB, inclusive consultas que integram serviços de aplicações, consulte Exemplo de consultas.

    Procedimento

    1. Navegar até Tudo > Configuração e clique em Construtor de consulta do CMDB.
    2. Na página do Construtor de consulta do CMDB, execute uma das etapas a seguir:
      • Clique em Criar novo. Digite um Nome, escolha Consulta do CMDB como o Tipo de consulta e clique em Criar.
      • Clique em um widget de uma consulta salva para continuar criando uma consulta existente. Pesquisar consultas salvas primeiro, se necessário.
      • Aponte para o canto superior direito de um widget de consulta salvo e clique no ícone Duplicar consulta para editar a 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 das seguintes operações:
      • Adicione classes de IC à consulta: na guia Classes do CMDB, selecione classes na lista de hierarquia e arraste-as para a tela.
      • Adicionar um IC de serviço de aplicativos à consulta: na guia Classes do CMDB, selecione a classe do Serviço de aplicações na lista de hierarquia e arraste-a para a tela.

        Em Propriedades do serviço de aplicativos na barra lateral direita, é possível selecionar Converter nós anexados ao padrão para consultar padrões entre o serviço de aplicativos e outros nós de classe do CMDB. Ao consultar em um padrão, os nós em ambas as extremidades da conexão do padrão podem ser qualquer número de níveis separados. Se Converter nós anexados em padrão não estiver selecionado, a conexão entre o nó serviço de aplicativos e outros nós de classe do CMDB representará relacionamentos diretos.

      • Adicione tabelas não CMDB à consulta: selecione uma tabela na lista Tabelas não CMDB e arraste-a para a tela.
        Nota:
        Uma tabela não CMDB não pode ser o nó inicial da consulta.
      • Adicione conexões (relacionamentos ou padrões de serviços de aplicações) entre dois nós na tela:
        1. No primeiro nó da conexão, clique no pequeno quadrado no centro do lado direito.
        2. No segundo nó da conexão, clique no pequeno quadrado no centro do lado esquerdo para criar a conexão.
        Tabela 1. Notações de IU de conexão
        Notação Descrição
        Linha inteira Um relacionamento em uma consulta do CMDB.
        Asterisco vermelho no centro da linha de conexão Informações como tipo de relacionamento estão ausentes, o que invalida a consulta.
        Notação Levels:<n> Types:<n ou uma notação <Reference type>> na linha de conexão

        Conforme aplicável: o número de níveis de relacionamento e o número de tipos de relacionamento incluídos na conexão. Ou um tipo de referência de um relacionamento que é considerado uma referência.

        Linha tracejada Uma conexão de padrão entre um nó serviço de aplicativos e outro nó.
      • Em Propriedades da conexão na barra lateral direita, defina as configurações de relacionamento (clique na linha de conexão se necessário):
        1. Na seção Direção do relacionamento, selecione o nó Primário (o nó Secundário se ajusta automaticamente).
        2. Na seção Níveis de relacionamento, defina Nível como Relacionamentos de primeiro nível se os ICs estiverem diretamente conectados. Ou Relacionamentos até o segundo nível se os ICs estiverem conectados direta ou indiretamente a outro IC.
        3. Na seção Tipos de relacionamento e Itens relacionados, selecione uma destas opções:
          Opção Descrição
          Nenhum relacionamento Para consultar ICs sem relacionamentos de conexão, como Todos os ICs do Tomcat WAR não conectados a um servidor Windows.
          Adicionar Tipos de relacionamentos Para selecionar um tipo de relacionamento específico ou qualquer outro tipo.
          Adicionar um Item relacionado Para consultar ICs relacionados entre os nós.
      • Configure a coluna de referência de IC para estabelecer conexão com uma tabela não CMDB: na barra lateral direita Propriedades da conexão, na seção Coluna de referência de IC, selecione a coluna com uma referência a um IC na lista Usar coluna de referência de IC. Se houver apenas uma opção disponível, ela será selecionada automaticamente.
      • Configure o padrão entre um nó serviço de aplicativos definido com a opção Converter nós anexados em padrão e um nó tabela não CMDB: selecione Aplicar <table> filtro de referência a todos os nós no padrão para aplicar a consulta ao próprio IC de serviço de aplicativos e aos ICs no serviço de aplicativos.
      • Adicione filtros a um nó classe: aplique filtros para restringir uma consulta de 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 clique no ícone Aplicar filtros que aparece acima do nó.
        2. Na seção Filtros, adicione o atributo e as condições de lista relacionada.
        3. Feche a seção Filtros.
        Por exemplo: adicione um filtro de localização de banco de dados para consultar bancos de dados localizados em Seattle.

        Clique em 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. Clique na caixa E exibida na linha de conexão para alternar entre os operadores 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.
      • Adicione colunas de propriedade de um nó que deverão ser exibidas nos resultados da consulta:
        Nota:
        Em um relacionamento, os resultados da consulta incluem as colunas parent, child e type. Não é possível adicionar outras colunas da tabela [cmdb_rel_ci].
        1. Clique em Propriedades no painel lateral direito.
        2. Clique em um nó uma ou duas vezes para que a seção Colunas do relatório seja exibida na barra lateral direita e clique em Adicionar colunas.
        3. Selecione as propriedades e clique fora da lista de propriedades para fechá-la.
      • Crie uma consulta de combinação integrando uma consulta do Mapeamento de serviços em uma consulta do CMDB:
        1. Ao criar uma consulta do CMDB, clique em Consultas de serviço salvas na barra lateral esquerda.
        2. Selecione e arraste uma consulta do Mapeamento de serviços para a tela.
        Essa consulta retorna todos os ICs que atendem à consulta do CMDB e que estão incluídos nos serviços retornados pela consulta incorporada do Mapeamento de serviços.
      • Adicione um marcador de pesquisa que pode ser usado como um critério de pesquisa para consultas salvas:
        1. Clique no ícone Adicionar marcadores na parte superior da tela.
        2. Clique em Adicionar marcador e, na caixa de diálogo Marcadores de consulta, insira uma ou mais cadeias de caracteres de marcador.
        3. Clique no ícone Adicionar marcadores novamente para fechar a caixa de diálogo Marcadores de consulta.
    4. Clique em Salvar.

      Na guia Consultas salvas, aponte para um widget de consulta salvo e clique em Informações da consulta. Detalhes da consulta, como tipo de consulta, data do último upgrade, grupos do CMDB associados à consulta e programações de consulta, são exibidos.

    O que Fazer Depois

    • Clique em Executar.

      Somente os 100 primeiros resultados da consulta são exibidos no painel de resultados.
      • Clique em Carregar mais resultados para exibir o próximo conjunto de 100 resultados.
      • Clique em Carregar todos os resultados para exibir 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).

      Clique em um IC para abrir seu formulário de IC e, no formulário de IC, clique em Painel para exibir a integridade do IC no painel de IC.

      Nota:
      • Verifique se a propriedade glide.security.use_csrf_token está definida como verdadeiro, permitindo a exibição de todos os resultados.
      • Quando Nível estiver definido como Relacionamentos até o segundo nível, o tipo de relacionamento não será exibido nos resultados da consulta.
      • Quando uma consulta estiver em execução, aguarde a conclusão ou o tempo limite antes de abrir ou executar outra consulta.
    • Modifique configurações do Construtor de consulta: clique no ícone Configurações. (Configurações) para abrir a caixa de diálogo Configurações do construtor de consulta.
    • Copie e compartilhe o 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.
    • Criar relatórios 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.
    • Exporte os resultados da consulta:

      Clique no menu de contexto Resultados da consulta e selecione Exportar. Mesmo se o botão Carregar mais resultados estiver visível, indicando que há resultados de consulta adicionais, 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 uma consulta salva.
    • Excluir consultas do CMDB.