Criar ou editar uma regra de identificação de IC

Versão de lançamento: Washingtondc

Atualizado 1 de fev. de 2024

10 min. de leitura

Regras de identificação são usadas para identificar exclusivamente os ICs no CMDB, como parte do processo de identificação e reconciliação. Cada classe do CMDB pode ser associada a apenas uma regra de identificação.

Antes de Iniciar

Função necessária: itil tem acesso de leitura, itil_admin (além de itil) tem acesso total.

Por Que e Quando Desempenhar Esta Tarefa

Em uma regra de identificação de IC, especifique um identificador de IC e entradas de identificador e entradas relacionadas que identificam exclusivamente o IC.

Revise o seguinte antes de criar regras de identificação:

Procedimento

Navegar até Tudo > Configuração > Gerenciador de classe de IC.
Clique em Hierarquia para exibir a lista de Classes de IC. Selecione a classe para a qual criar uma regra de identificação.
Na barra de navegação de classe, expanda Informações de classe e clique em Regra de identificação.

Clique em Editar para editar uma regra existente ou clique em Adicionar na seção Regra de identificação para criar uma nova. Preencha o formulário e clique em Salvar.


Campo	Descrição
Independente/dependente	Designação que define se o identificador de IC pode identificar o IC independentemente de outros ICs ou não. Nota: Para definir a regra como Dependente, você deve especificar regras de relacionamento dependente para a classe selecionada.
Nome	Nome do identificador de IC.
Descrição	Descrição do identificador de IC.

Na seção Entradas do Identificador, clique em uma entrada do identificador existente para editar ou clique em Adicionar para criar uma nova.

Na caixa de diálogo Entrada do Identificador, escolha uma opção e clique em Avançar. Prossiga com uma das três etapas a seguir de acordo com a opção selecionada.


Opção	Descrição
Usar atributos da tabela principal <table>	Permite selecionar atributos da tabela selecionada no momento (entrada de identificador regular).
Usar atributos de outra tabela (Tabela de pesquisa)	Permite selecionar atributos de qualquer tabela relacionada, exceto a tabela atualmente selecionada (entrada do identificador de pesquisa).
Use atributos da tabela principal e de outra (Híbrido)	Permite selecionar atributos da tabela atualmente selecionada e de outra tabela (entrada de identificador híbrido).

Opção Usar atributos da tabela principal <'table'> : defina as opções no formulário e clique em Salvar.

Pesquisar na tabela é predefinido para a tabela selecionada no momento na lista de Classes de IC.


Campo	Descrição
Ativo	Caixa de seleção que especifica que a entrada do identificador está ativa. Pelo menos uma entrada de identificador em uma regra de identificação deve estar ativa para que a regra seja aplicada.
Prioridade	Prioridade da entrada do identificador. As entradas do identificador são aplicadas com base na prioridade. Regras com números de prioridade mais baixa recebem prioridade mais alta. Entradas do identificador de prioridades idênticas são aplicadas aleatoriamente. Você pode manter lacunas entre os números de prioridade, para que possa atribuir os números de prioridade não utilizados a novas entradas sem modificar a ordem de prioridade existente.
Atributos de critério	Definição de atributos que identificam o IC de modo exclusivo. Os atributos podem pertencer à classe atual ou a uma classe primária. Nota: É possível adicionar campos de referência como um atributo de critério. No entanto, esses campos podem não ser eficazes sempre: Campos de referência armazenam sys_ids que apontam para um registro em outra tabela e, portanto, são considerados um atributo de critério fraco (em termos de exclusividade) para a tabela atual. O sistema detecta e substitui valores inválidos em um campo de referência por "Desconhecido". Por exemplo, um valor Model ID inválido é substituído pelo valor "Desconhecido". Além disso, se vários ICs tiverem o mesmo campo de referência definido como "Desconhecido", esses ICs se tornarão ICs duplicados.
Permitir atributo nulo	Quando selecionado, se pelo menos um atributo de critério não for nulo, tente corresponder a uma entrada de identificador mesmo se houver atributos de critério nulos. Caso contrário, todos os atributos de critério devem ter valores para tentar corresponder a uma entrada de identificador.
Permitir fallback para regras pai	Permite que as regras de identificação do IC primário sejam usadas se uma correspondência não for encontrada para esta regra de identificação. Aplica-se somente a regras de identificação dependentes.
Opções avançadas	Um filtro para restringir o conjunto de registros em que será pesquisado um IC correspondente. Disponível somente se a propriedade do sistema glide.identification_engine.enable_identifier_optional_condition estiver definida como true (ela é false por padrão). No sistema de base, as entradas do identificador de várias classes são pré-configuradas com condições de opções avançadas. Todas essas condições pré-configuradas em entradas de identificador regulares serão aplicadas automaticamente quando você definir esta propriedade como true. Portanto, para evitar comportamento inesperado, revise essas condições predefinidas nas entradas do identificador regular antes de definir esta propriedade como true. Para obter mais detalhes sobre esta propriedade, confira Propriedades de Identificação e Reconciliação.

Nota:

Se os atributos de critério tiverem apenas dois atributos e sys_class_name for um deles (por exemplo [name, sys_class_name], [ip_address, sys_class_name]), o outro atributo não poderá ser NULO, mesmo se a opçao Permitir atributo nulo estiver habilitada. Esta restrição deve-se ao fato de sys_class_name ser considerado um atributo de correspondência do sistema especial.

Opção Usar atributos de outra tabela (Tabela de pesquisa):

Defina Pesquisar na tabela para uma tabela diferente da tabela selecionada no momento na lista de Classes de IC. A pesquisa na tabela deve ter um campo de referência para cmdb_ci, caso contrário, a entrada do identificador será considerada inválida.
Defina o restante dos campos conforme descrito na etapa anterior.

Opcional: Clique em Opções avançadas e insira as informações de um identificador de pesquisa (role para baixo se necessário).


Opção avançada	Descrição
Todas estas condições devem ser atendidas	Um filtro para restringir o conjunto de registros em que será pesquisado um IC correspondente.
Forçar correspondência de contagem exata	Para identificação de pesquisa, corresponda a um IC apenas na correspondência exata de contagem de registros de pesquisa. Quando aplicados, todos os itens de pesquisa de um IC na carga útil devem ter registros correspondentes na tabela de pesquisa, que fazem referência ao mesmo IC: Corresponde somente aos ICs que têm todos os itens de pesquisa da carga útil de entrada que faz referência ao IC no CMDB. Se houver várias correspondências, seleciona o IC criado mais antigo como a correspondência final. Quando não for aplicado, um item de pesquisa de um IC na carga útil correspondente a um registro da tabela de pesquisa é suficiente para considerar uma correspondência: Corresponde a qualquer IC que tenha pelo menos um dos itens de pesquisa da carga útil de entrada que faz referência ao IC no CMDB. Se houver várias correspondências, seleciona os ICs com o número máximo de itens de pesquisa da carga útil de entrada que faz referência ao IC no CMDB. Se ainda houver várias correspondências, seleciona o IC mais antigo criado como a correspondência final.

Clique em Salvar.

Opção Usar atributos da tabela principal e de outra tabela (híbrido):
1. Defina as opções na guia Configurações gerais conforme descrito nas etapas anteriores e clique em Avançar.
2. Na guia Configurações da tabela principal, selecione os atributos a serem usados na tabela selecionada no momento e clique em Avançar.
  Pesquisar na tabela é predefinido para a tabela selecionada no momento na lista de Classes de IC.
3. Na guia Configurações da tabela de pesquisa, selecione Pesquisar na tabela e, em Atributos de critério, selecione os atributos da tabela especificada. Pesquisar na tabela deve ter um campo de referência para cmdb_ci, caso contrário, a entrada do identificador será considerada inválida.
  Você pode clicar em Opções avançadas e inserir as informações para um identificador de pesquisa, conforme descrito na etapa anterior (role para baixo, se necessário).
4. Clique em Salvar.
Nota:
A opção Permitir atributo nulo na opção híbrida está definida como false. Portanto, todos os atributos de critério selecionados da tabela selecionada no momento e da tabela de pesquisa devem ter um valor. Além disso, a definição de condições opcionais está disponível somente para a tabela de pesquisa e não está disponível para a tabela principal.

Opcional: Na seção Entradas relacionadas, clique em uma entrada relacionada existente para editar ou clique em Adicionar para criar uma.

Atualize o formulário de Entrada relacionada e clique em Salvar.

Tabela 1. Formulário Entrada relacionada
Campo	Descrição
Ativo	Caixa de seleção que especifica que a entrada relacionada está ativa.
Tabela relacionada	Uma tabela relacionada que faz referência ao IC que está sendo correspondido.
Campo referenciado	Um campo referenciado na Tabela relacionada que deve armazenar o IC referenciado. Este campo sempre faz referência à tabela cmdb_ci ou um descendente da tabela cmdb_ci.
Prioridade	Prioridade da entrada relacionada para a Tabela relacionada especificada. Regras com números de prioridade mais baixa recebem prioridade mais alta enquanto correspondem a um item relacionado a uma tabela relacionada específica. Entradas relacionadas para a tabela relacionada especificada com prioridades idênticas são aplicadas aleatoriamente. Você pode manter lacunas entre os números de prioridade, para que possa atribuir os números de prioridade não utilizados a novas entradas sem modificar a ordem de prioridade existente.
Atributos de critério	O conjunto de atributos para identificar exclusivamente o item relacionado. Os atributos podem pertencer à classe atual ou a uma classe primária. Nota: É possível adicionar campos de referência como um atributo de critério. No entanto, esses campos podem não ser eficazes sempre: Campos de referência armazenam sys_ids que apontam para um registro em outra tabela e, portanto, são considerados um atributo de critério fraco (em termos de exclusividade) para a tabela atual. O sistema detecta e substitui valores inválidos em um campo de referência por "Desconhecido". Por exemplo, um valor Model ID inválido é substituído pelo valor "Desconhecido". Além disso, se vários ICs tiverem o mesmo campo de referência definido como "Desconhecido", esses ICs se tornarão ICs duplicados. Clique no ícone de cadeado para exibir, adicionar ou remover atributos da regra de identificação.
Permitir atributo nulo	Se pelo menos um atributo de critério na tabela relacionada não for nulo, permita a tentativa de correspondência com uma entrada de identificador, mesmo se houver atributos de critério que sejam nulos.
Condições do filtro	Filtre as condições para restringir o conjunto de registros que serão pesquisados para um item relacionado correspondente.

Nota:

Exemplo

Por exemplo, a Regra de hardware predefinida se aplica à tabela Hardware [cmdb_ci_hardware]. Ele tem uma entrada de identificador com o atributo de critério Número de série, Tipo de número de série e seu campo Pesquisar na tabela está definido como Número de série.

O snippet de carga útil a seguir adiciona um IC à classe cmdb_ci_linux_server, que é secundária da classe Hardware. Ele também mostra como você pode adicionar itens relacionados à carga útil para a qual você deve criar Entradas relacionadas na página Identificador de IC para a tabela Hardware [cmdb_ci_hardware]:


{
    "items": [
        {
            "className": "cmdb_ci_linux_server",
            "lookup": [
                {
                    "className": "cmdb_serial_number",
                    "values": {
                        "serial_number": "VMware-42 21 e3 da 44 14 5a a6-56 48 2b 0a 28 53 42 4c",
                        "serial_number_type": "system",
                        "valid": "true"
                    }
                },
                {
                    "className": "cmdb_serial_number",
                    "values": {
                        "serial_number": "4221E3DA-4414-5AA6-5648-2B0A2853424C",
                        "serial_number_type": "uuid",
                        "valid": "true"
                    }
                },                }
            ],

    “related": [
                {
                    "className": "cmdb_ci_ucs_chassis",
                    "values": {
                        “name": “chassis1",
                        “category": “category1",
                        “short_description": “My Chassis 1"
                    }
                },
                {
                    "className": "cmdb_ci_ucs_chassis",
                    "values": {
                        “name": "chassis2",
                        "category": "category2",
                        "short_description": "My Chassis 2"
                    }
                },    }
     ],

            "values": {
                ......
                "name": "xpolog2.lab3",
                "os_name": "Linux",
                "output": "Linux xpolog2.lab3 2.6.32-431.el6.x86_64 #1 SMP Fri Nov 22 03:15:09 UTC 2013 x86_64 x86_64 x86_64 GNU/Linux",
                "serial_number": "VMware-42 21 e3 da 44 14 5a a6-56 48 2b 0a 28 53 42 4c",
                "sys_class_name": "cmdb_ci_linux_server"
            }
        }
    ]
}

Quando a regra de hardware é aplicada, a tabela de número de série [cmdb_serial_number] é pesquisada em busca de uma correspondência com os valores especificados na chave de pesquisa. A menos que a opção Impor correspondência de contagem exata (Pesquisa) esteja marcada, não é necessário que cada chave de pesquisa retorne uma correspondência, desde que haja pelo menos uma correspondência. Se todas as correspondências fizerem referência ao mesmo IC, ele será considerado o registro de IC existente. Se nenhuma correspondência for encontrada, a pesquisa de identificação continuará para a próxima entrada de regra. Depois que todas as regras forem esgotadas sem encontrar uma correspondência, um novo registro de IC será criado no banco de dados.

O que Fazer Depois

Opcionalmente, você pode criar uma regra de inclusão para restringir o escopo de ICs que estão incluídos na identificação.