Geração e simulação da execução de carga útil usando simulação de identificação

  • Versão de lançamento: Xanadu
  • Atualizado 1 de ago. de 2024
  • 16 min. de leitura

    • A simulação de identificação é um aspecto central para criar automaticamente uma carga que tem garantia de estar completa e válida. Você pode simular o processamento da carga pelo mecanismo de identificação e reconciliação (IRE) e examinar os resultados antes de realmente enviá-los para execução pelo IRE.

    Use a simulação de identificação para criar uma carga de entrada e simular o processamento da carga por IRE. Você pode então examinar os resultados, ajustar as regras de identificação se necessário e executar novamente a simulação da carga atualizada.

    Use a simulação de identificação para:
    • Construa automaticamente a carga de entrada com base nas regras de identificação, hospedagem e contenção existentes.
    • Simule a execução de uma carga (criada automaticamente por simulação de identificação ou criada manualmente).
    • Pesquise a saída de carga e as mensagens de log de execução para uma execução simulada.
    Nota:
    • A simulação de identificação não confirma nenhuma atualização no CMDB.
    • A simulação de identificação oferece suporte à simulação de cargas úteis de processamento fornecidas e que contêm tabelas não pertencentes ao CMDB, mas não é compatível com a geração dessas cargas úteis.

    Gerar carga útil automaticamente usando simulação de identificação

    Use a simulação de identificação para criar automaticamente uma carga útil de entrada para uma classe especificada. A carga útil construída está completa com todos os ICs dependentes necessários, estruturados corretamente e sintaticamente válidos para processamento pelo mecanismo de identificação e reconciliação (IRE).

    Antes de Iniciar

    Função necessária: administrador

    Por Que e Quando Desempenhar Esta Tarefa

    A carga útil criada durante a simulação de identificação é para a classe especificada. Para uma classe de IC dependente, serão solicitadas informações sobre todas as dependências. Depois de fornecer os detalhes necessários, a simulação de identificação constrói a carga útil com base na sua entrada.

    Nota:
    Não há suporte para a geração automática de cargas úteis que contenham tabelas não pertencentes ao CMDB.

    Procedimento

    1. Navegar até Todos > Configuração > Identificação/Reconciliaçãoe clique em Simulação de identificação.
    2. Na caixa Iniciar com Classe de IC, clique em Iniciar.
    3. No formulário Informações de carga útil, no campo Fonte de dados, selecione a fonte de dados que está associada a esta atualização de classe.
      Para a fonte de dados do ServiceNow Descoberta, selecione ServiceNow.
    4. Selecione a classe na carga útil.
      1. Na área Atributos de critério, selecione os atributos do identificador de IC e especifique os valores que identificam exclusivamente um IC.
      2. Na área Atributos adicionais, especifique os atributos e valores com os quais os ICs correspondentes serão atualizados.
    5. Para ICs dependentes associados a regras de identificação dependentes, preencha as seções Atributos de critério e Atributos adicionais em todas as seções de Nível de contêiner exibidas.
    6. Clique em Gerar script.
    7. Se algum erro indicar que há campos ausentes, preencha esses campos ausentes e clique novamente em Gerar Script.

    O que Fazer Depois

    • Clique em Executar simulação para simular o processamento da carga útil por IRE.
    • Examine os resultados da simulação, ajuste a carga útil conforme necessário e combine com outras cargas úteis para outras classes, conforme desejado. Depois de finalizar a carga útil, use a API createOrUpdateCI() para executar a carga útil por IRE, o que resultará em atualizações reais no CMDB.
    • Clique em Copiar Script para copiar o script JSON para a área de transferência. Você pode colar esse script em um software de terceiros ou em outra tela da simulação de identificação.

    Simular o processamento da carga útil usando a simulação de identificação

    Use a simulação de identificação para simular o processo do mecanismo de identificação e reconciliação (IRE) de identificação de IC para uma carga útil de entrada. Forneça uma carga útil válida, que foi criada usando simulação de identificação ou que foi criada manualmente.

    Antes de Iniciar

    Função necessária: administrador

    Procedimento

    1. Navegar até Todos > Configuração > Identificação/Reconciliaçãoe clique em Simulação de identificação.
    2. Opcional: Para executar uma simulação de uma carga útil existente:
      1. Clique em Iniciar no bloco Iniciar com carga útil existente.
      2. Na página Inserir carga útil JSON, selecione a Fonte de dados associada a esta atualização de classe.
      3. Opcional: Selecione Usar identificação aprimorada para aplicar a API identifyCIEnhanced para identificação aprimorada de ICs, em vez de usar a API identifyCI.
      4. Cole a carga útil JSON na tela vazia.
    3. Opcional: Para criar uma nova carga, clique em Iniciar no bloco Iniciar com a classe de IC.
      Para mais informações, consulte Gerar carga útil automaticamente usando simulação de identificação.
    4. Clique em Executar simulação para simular o processamento da carga útil por IRE.

    O que Fazer Depois

    1. Examine os resultados da simulação no painel de resultados e ajuste a carga conforme necessário:
      1. Clique em Executar nº 1 para exibir o ID de contexto e o ID de execução da execução simulada.
      2. Clique na seta suspensa ao lado da Execução nº 1 para exibir detalhes adicionais.
        • Entrada: exibe a carga útil da simulação.
        • Logs: exibe todas as mensagens registradas que o IRE gerou ao simular o processamento da carga, de acordo com o nível de registro em log especificado.
        • Saída: exibe a carga útil de saída retornada pelo IRE.
    2. Depois de finalizar a carga útil, use a API createOrUpdateCI() para executar a carga útil por IRE, o que resultará em atualizações reais no CMDB.

    Definir nível de registro em log da simulação de identificação

    A simulação de identificação registra cada etapa de um processamento de carga útil simulada. Você pode então examinar esses logs de execução para determinar se uma carga útil foi processada conforme o esperado e se as regras de identificação são eficazes. Você pode ajustar o nível de registro em log para que seja útil e para que a quantidade de mensagens não seja excessiva ou insuficiente.

    Antes de Iniciar

    Função necessária: administrador

    Procedimento

    1. Navegar até Todos > Configuração > Identificação/Reconciliaçãoe clique em Simulação de identificação.
    2. Clique no ícone Configurações.
    3. Selecione o nível de registro em log para o mecanismo de identificação e reconciliação (IRE) em Nível de log do IRE e para o cache de serviço em Nível de log do cache de serviço.
      Os níveis de registro em log são exibidos em ordem crescente, do nível mínimo ao nível máximo.
    4. Clique no ícone Configurações novamente para fechar a caixa de diálogo Configurações.

    Examinar logs de execução

    A simulação de identificação fornece logs de execução que são gerados pelo Mecanismo de Identificação e Reconciliação (IRE). Você pode acessar esses logs de execução para execuções de carga útil, para examinar os resultados e para fins de depuração. Os logs de saída de carga útil do IRE aparecem em um formato amigável em uma página central.

    Antes de Iniciar

    Função necessária: administrador

    Por Que e Quando Desempenhar Esta Tarefa

    Além disso, as aplicações internas que usam IRE (como Descoberta) podem chamar uma API interna para fornecer uma URL para a exibição de logs de execução de IRE.

    O registro em log está no contexto de uma execução específica do mecanismo de identificação e você pode filtrar a lista de logs por uma fonte de dados e intervalo de tempo específicos. Até 1000 logs de execução com até 2 meses são listados, agrupados por IDs de contexto e tempos de execução. Você pode usar a propriedade glide.identification_logs.max_run_ids para modificar o limite de 1000.

    Você pode controlar o nível de registro em log usando a propriedade do sistema Descoberta glide.discovery.identification.log_level e definindo o valor como um dos seguintes:
    • Informação
    • Aviso
    • Erro
    • Depurar
    • DebugVerbose
    • DebugObnoxious
    Nota:
    O IRE executa uma verificação inicial de uma carga útil antes de processar as regras de identificação. Se o IRE detectar algum IC duplicado com base em qualquer identificador de classe, a carga útil será rejeitada e o processamento será interrompido.

    Procedimento

    1. Navegar até Todos > Configuração > Identificação/Reconciliação > Logs de Identificação.
    2. Filtre a lista de execuções da seguinte forma:
      1. Origem: selecione a fonte de dados para a qual os logs de execução serão exibidos.
      2. Intervalo de tempo: especifique um intervalo de tempo para exibir os logs de execução.
      A lista de execuções exibe todas as execuções da fonte de dados especificada, durante o intervalo de tempo especificado.
    3. Na lista de execuções, clique no número de uma execução para exibir o ID de contexto e o ID de execução dela.
      Um ID de contexto exclusivo é associado a cada carga útil específica executada. Cada execução dessa carga útil está associada a um ID de execução exclusivo. Um só ID de contexto para uma carga útil que é executada várias vezes é associado a vários IDs de execução.
    4. Clique na seta suspensa de uma Execução nº 1 para exibir detalhes adicionais.
      • Entrada: exibe a carga útil da execução.
      • Logs: exibe todas as mensagens registradas que o mecanismo de identificação gerou durante a execução da carga útil, de acordo com o nível de registro em log especificado.
      • Saída: exibe a carga útil de saída retornada pelo mecanismo de identificação.

    Mensagens de erro do IRE

    O Mecanismo de Identificação e Reconciliação (IRE) gera os seguintes erros e mensagens. Dependendo das configurações, essas mensagens aparecem no painel de Registro em log de Identificação e nos logs do sistema.

    Para obter informações sobre a identificação de IC baseada em pesquisa e as cadeias de qualificador, confira Criação de uma regra de identificação de IC.
    Nota:
    O IRE executa uma verificação inicial de uma carga útil antes de processar as regras de identificação. Se o IRE detectar algum IC duplicado com base em qualquer identificador de classe, a carga útil será rejeitada e o processamento será interrompido.

    Para obter informações sobre o erro de Carga de Identificação do CMDB: "FALHA NA TENTATIVA DE EXECUÇÃO NA CONEXÃO", confira o artigo da base de conhecimento Erro de carga útil de identificação do CMDB - "Falha na inserção com erro ao inserir cmdb_ci...", em que os logs de nó mostram "FALHA NA TENTATIVA DE EXECUÇÃO NA CONEXÃO" "Entrada duplicada 'XXX' para a chave 'XXX'".

    Erro - IDENTIFICATION_RULE_MISSING

    Mensagem Descrição e resolução
    Regra de identidade ausente para a tabela [xyz]
    Descrição:
    A regra de identificação está ausente para uma classe.
    Resolução:
    Certifique-se de que haja uma regra de identificação para a tabela [xyz] e que a regra esteja ativa.

    MISSING_MATCHING_ATTRIBUTES

    Mensagem Descrição e resolução
    Na carga útil, falta o conjunto mínimo de valores de entrada para atributos de critério (correspondentes) da regra de identificação da tabela [xyz]. Adicionar esses valores de entrada no item de carga útil 'abc'
    Descrição:
    Conjunto mínimo ausente de valores de atributos de critério para uma regra de identificação.
    Resolução:
    Na carga útil, adicione o conjunto mínimo de valores para atributos de critério do Identificador de IC da tabela [xyz]. Abra o gerenciador de classe de IC, clique em Hierarquia e selecione a classe [xyz. Verifique a regra de identificação e as entradas do identificador da tabela [xyz.

    Erro - NO_CLASS_NAME_FOR_INDEPENDENT_CI

    Mensagem Descrição e resolução
    Não é possível ter 'sys_class_name' como um campo de chave em uma Regra de Identidade Independente em 'xyz'
    Descrição:
    O atributo de classe foi adicionado ao identificador de IC que não é compatível.
    Resolução:
    Remova o atributo de classe do Identificador de IC da tabela [xyz].

    Erro - IDENTIFICATION_RULE_FOR_LOOKUP_MISSING

    Mensagem Descrição e resolução
    Regra de Identidade para a tabela [xyz] Regra de Pesquisa ausente para classe [abc]
    Descrição:
    A carga útil tem um nome de classe de pesquisa, mas a regra de pesquisa correspondente está ausente.
    Resolução:
    Adicione a entrada do identificador de pesquisa com [Pesquisar na tabela] como [abc] para o Identificador de IC da tabela [xyz].

    Erro - IDENTIFICATION_RULE_FOR_RELATED_ITEM_MISSING

    Mensagem Descrição e resolução
    Regra de Identidade para a tabela [xyz] Regra relacionada ausente para classe [abc]
    Descrição:
    A carga útil tem um nome de classe relacionada, mas a regra relacionada correspondente está ausente.
    Resolução:
    Adicione a entrada relacionada com [Tabela relacionada] como [abc] no Identificador de IC para a tabela [xyz].

    Erro - NO_LOOKUP_RULES_FOR_DEPENDENT_CI

    Mensagem Descrição e resolução
    Não é possível ter regra de pesquisa para uma regra de identidade dependente em 'xyz'
    Descrição:
    Não é possível ter regra de pesquisa para uma regra de identidade dependente.
    Resolução:
    Remova a entrada do identificador de pesquisa do Identificador de IC dependente da tabela [xyz].

    Erro - INVALID_INPUT_DATA

    Mensagem Descrição e resolução
    Sys_id inválido encontrado na carga útil. Não existe nenhum registro com sys_id [xyz] na tabela [abc] ou é um registro duplicado com o campo [duplicate_of] definido como um IC principal
    Descrição:
    A carga útil tem uma referência a um sys_id inválido.
    Resolução:
    Remova o sys_id referenciado ou forneça um sys_id válido.
    Não existe nenhuma fonte de dados na carga útil. Você precisa fornecer o valor de opção do campo de opção [discovery_source] na tabela [cmdb_ci]
    Descrição:

    Não existe nenhuma fonte de dados na carga útil.

    Resolução:
    Na carga útil, forneça um valor de opção válido do campo de opção [discovery_source] da tabela [cmdb_ci].
    Existe uma fonte de dados inválida [xyz] na carga útil. Você precisa fornecer um valor de opção válido do campo de opção [discovery_source] na tabela [cmdb_ci]
    Descrição:
    A carga útil contém uma fonte de dados inválida.
    Resolução:
    Na carga útil, forneça um valor de opção válido do campo de opção [discovery_source] da tabela [cmdb_ci].
    Não existe tal relacionamento com o nome [xyz] na tabela [cmdb_rel_type]. Se o relacionamento pronto para uso para [xyz] tiver sido removido ou renomeado, ele deverá ser restaurado
    Descrição:
    A carga útil está fazendo referência a um relacionamento que não existe na tabela [cmdb_rel_type].
    Resolução:
    Verifique se a referência ao relacionamento é precisa. Ou, se for um novo relacionamento, adicione-o à tabela [cmdb_rel_type]. Ou, se o relacionamento pronto para uso para [xyz] tiver sido removido ou renomeado, restaure-o.
    As relações de carga 'xyz' têm índice de registro primário inválido: [0]
    Descrição:
    A carga útil faz referência a índices primários inválidos.
    Resolução:
    Verifique os índices de carga útil e certifique-se de que todos sejam válidos.
    As relações de carga útil 'xyz' têm índice de registro secundário inválido: [0]
    Descrição:
    A carga útil faz referência a índices secundários inválidos.
    Resolução:
    Verifique os índices de carga útil e certifique-se de que todos sejam válidos.

    Erro - DUPLICATE_RELATIONSHIP_TYPES

    Mensagem Descrição e resolução
    Existem registros de tipo de relacionamento duplicados com o nome [xyz] na tabela [cmdb_rel_type] tendo sys_ids: [abc]
    Descrição:
    Há registros duplicados na tabela [rel_ci_type] para o relacionamento.
    Resolução:
    Remova os registros duplicados.

    Erro - DUPLICATE_PAYLOAD_RECORDS

    Mensagem Descrição e resolução
    Foram encontrados itens duplicados na carga útil (índices 0 e 1), usando className [xyz] e campos [abc]. Remover itens duplicados da carga útil
    Descrição:
    A carga útil contém dois itens cujos atributos de critério têm valores idênticos.
    Resolução:
    Remova um dos itens duplicados.

    Erro - LOCK_TIMEOUT

    Mensagem Descrição e resolução
    Falha ao adquirir bloqueio de sincronização para xyz
    Descrição:
    Falha ao adquirir o bloqueio de mutex do sistema.
    Resolução:
    Aumente o tempo de expiração do mutex adicionando a propriedade do sistema glide.identification_engine.mutex_expiration_time e definindo como um valor inteiro maior do que o valor padrão (15 min).

    Erro - MULTIPLE_DUPLICATE_RECORDS

    Mensagem Descrição e resolução
    Registros duplicados encontrados na tabela [xyz] usando os campos [abc]
    Descrição:
    Registros duplicados encontrados na tabela especificada.
    Resolução:
    Corrija os registros duplicados encontrados pelo mecanismo de identificação. Verifique as tarefas de eliminação de duplicação para obter informações sobre todas as duplicatas.

    Erro - REQUIRED_ATTRIBUTE_EMPTY

    Mensagem Descrição e resolução
    Campo obrigatório [xyz] ausente na tabela [abc]. Adicionar valor de entrada para campo obrigatório da carga útil
    Descrição:
    Um atributo obrigatório está ausente na carga útil.
    Resolução:
    Na carga útil, adicione o valor de entrada do campo obrigatório [xyz] na tabela [abc].

    Erro - MISSING_DEPENDENCY

    Mensagem Descrição e resolução
    Na carga útil, não há relações definidas para a classe dependente [xyz] que corresponda a qualquer regra de contenção/hospedagem: [abc]. Adicionar relações apropriadas na carga útil para 'def'
    Descrição:
    Nenhuma relação definida para a classe dependente que corresponda a qualquer uma de suas regras de metadados.
    Resolução:
    Na carga útil, adicione relações apropriadas para a classe dependente [xyz] que corresponda a qualquer regra de contenção/hospedagem: [abc].

    Erro - METADATA_RULE_MISSING

    Mensagem Descrição e resolução
    Não há regras de contenção ou hospedagem definidas para a classe dependente [xyz]. Adicionar regras de contenção/hospedagem para 'abc'
    Descrição:
    Não há regras de contenção ou hospedagem definidas para a classe dependente.
    Resolução:
    Adicione regras de contenção ou hospedagem para a classe dependente [xyz].

    Erro - MULTIPLE_DEPENDENCIES

    Mensagem Descrição e resolução
    Encontrados vários itens de relação dependente [xyz] e [abc] na carga útil
    Descrição:
    Existem vários itens de relação dependente.
    Resolução:
    Remova um dos vários itens de relação dependente [xyz] ou [abc].
    Vários caminhos que levam ao mesmo destino: xyz -> abc
    Descrição:
    Vários caminhos que levam ao mesmo destino.
    Resolução:
    Remova cadeias de relacionamento/qualificador duplicadas que possam existir entre xyz -> abc.

    Erro - ABANDONED

    Mensagem Descrição e resolução
    Abandonando o processamento do item de carga útil 'xyz', já que ele depende do item de carga útil 'abc' e tem erros
    Descrição:
    O item dependente da carga útil tem erros, portanto, abandona o processamento.
    Resolução:
    Resolva o erro no item dependente de carga útil 'abc'.
    Não é possível encontrar o registro correspondente com sys_id [xyz] na tabela [abc]
    Descrição:
    O sys_id correspondente não existe na tabela em questão.
    Resolução:
    Verifique na tabela [abc] se o registro correspondente é um registro válido com base na carga de entrada.
    A API do mecanismo de identificação foi chamada recursivamente, anulando...
    Descrição:
    A API do mecanismo de identificação foi chamada recursivamente.
    Resolução:
    Evite chamar a API do mecanismo de identificação recursivamente.
    Erro detectado ao processar a carga útil de xyz
    Descrição:
    Ocorreu um erro durante o processamento da carga útil.
    Resolução:
    Resolva todos os erros mencionados na carga útil de saída de xyz.
    Ao processar as relações, foram encontrados erros no item de carga útil: xyz
    Descrição:
    O item de carga útil tem erros.
    Resolução:
    Resolver erros no item de carga útil 'xyz'.
    Ocorreu um erro durante a análise da carga útil json de entrada: xyz
    Descrição:
    Ocorreu um erro durante a análise da carga útil JSON.
    Resolução:
    Certifique-se de que a carga útil JSON de entrada tenha o formato JSON correto.

    Erro - MULTI_MATCH

    Mensagem Descrição e resolução
    Registros dependentes duplicados encontrados com relacionamento [xyz] com o mesmo IC (className: [abc], sysId: [def])
    Descrição:
    ICs dependentes duplicados encontrados.
    Resolução:
    Verifique as tarefas de eliminação de duplicação para obter informações sobre todas as duplicatas, e depois apagar os registros duplicados.
    Várias relações encontradas entre os itens de carga útil: 'xyz' e 'abc'
    Descrição:
    Várias relações encontradas entre os itens de carga útil.
    Resolução:
    Verifique se há cadeias de relacionamento duplicadas e cadeias de qualificador que possam existir.
    Registros duplicados encontrados na tabela de pesquisa [xyz] usando campos [abc] e campo de referência [def]
    Descrição:
    Registros duplicados encontrados na tabela de pesquisa.
    Resolução:
    Verifique as tarefas de eliminação de duplicação para obter informações sobre todas as duplicatas, e depois apagar os registros duplicados.

    Erro - QUALIFICATION_LOOP

    Mensagem Descrição e resolução
    A cadeia de qualificação tem um loop que contém a relação 'xyz'
    Descrição:
    A cadeia de qualificação tem um loop.
    Resolução:
    Remova o loop da cadeia de qualificação com a relação 'xyz'.

    Erro - TYPE_CONFLICT_IN_QUALIFICATION

    Mensagem Descrição e resolução
    Carga útil inválida, a cadeia de qualificação tem vários caminhos possíveis para itens de carga útil: 'xyz' e 'abc'
    Descrição:
    Vários caminhos de qualificação encontrados.
    Resolução:
    Remova vários caminhos de qualificação possíveis entre os itens 'xyz' e 'abc'.

    Erro - RECLASSIFICATION_NOT_ALLOWED

    Mensagem Descrição e resolução
    Reclassificação de IC não permitida da classe: [xyz] para [abc]
    Descrição:
    Reclassificação de IC não permitida.
    Resolução:
    Verifique as tarefas de reclassificação para obter informações sobre a reclassificação e verifique se a reclassificação da classe: [xyz] para [abc] é válida.

    Erro - DUPLICATE_RELATED_PAYLOAD

    Mensagem Descrição e resolução
    Itens relacionados duplicados encontrados (0 e 1) no índice de carga útil 1 usando os campos xyz
    Descrição:
    Itens relacionados duplicados presentes.
    Resolução:
    Remova um dos itens relacionados duplicados presentes na carga útil.

    Erro - DUPLICATE_LOOKUP_PAYLOAD

    Mensagem Descrição e resolução
    Itens de pesquisa duplicados encontrados (0 e 1) no índice de carga útil 1 usando os campos xyz
    Descrição:
    Itens de pesquisa duplicados presentes.
    Resolução:
    Remova um dos itens de pesquisa duplicados presentes na carga útil.

    INSERT_NOT_ALLOWED_FOR_SOURCE

    Mensagem Descrição e resolução
    A inserção em [xyz] está bloqueada para a fonte de dados [abc] pela regra de fonte de dados do IRE
    Descrição:
    Uma regra de fonte de dados do IRE é configurada para impedir que a fonte de dados [abc] insira ICs da classe [xyz].
    Resolução:

    Exclua ou atualize a regra de fonte de dados do IRE apropriada para permitir que a fonte de dados [abc] insira ICs da classe [xyz].

    Ou aguarde até que outra fonte de dados permitida crie o mesmo IC.