INTEGRAÇÃO INVENTÁRIO SIMON_v4 1

Prévia do material em texto

INTEGRAÇÃO INVENTÁRIO SIMON
1. GAPE - Infra Requisitos
· Low Code versão 1.9.0-RELEASE ou superior
· Events versão 1.1.0-RELEASE ou superior
· FaaS versão 1.4.0-RELEASE ou superior
· ITSM versão 1.9.9 ou superior
· Pacote da aplicação Low Code Hyper Event Processing versão 10.0 ou superior, que pode ser obtido em https://gitlab.cloud4biz.com/hyper/simon-integration/-/blob/main/package_event_processing_v10.0.json
· Pacote da aplicação Low Code CMDB Integration versão 2.0 ou superior, que pode ser obtido em https://gitlab.cloud4biz.com/hyper/simon-integration/-/blob/main/package_cmdb_integration_v1.0
· IMPORTANTE: Caso existam, devem ser desabilitados todos os eventos criados para a versão anterior da integração (simon_integration). 
2. GAPE - Infra Parametrização
· Criar a conexão de banco de dados cmdb_integration, apontando para o banco de dados do ITSM.
· Importar o pacote package_cmdb_integration_v1.0.zip.
· 
3. AIOPS - Configurar o parâmetro Lowcode
Pré-requisitos:
- URL do Simon - AIOPS
- API do Simon - AIOPS
- Service do kafka - GAPE Infraestrutura
· Configurar o parâmetro JSON cmdb.integration.parameters, definindo:
· simon.url - A URL para detalhamento do IC no Simon
· simon.maxAttempts – Quantidade máxima de novas tentativas em caso de erro no detalhamento do IC no Simon
· simon.apikey – A apikey para a URL de detalhamento do Simon
· kafka.brokers – Os servidores do Kafka
· kafka.topics.data (opcional) – Nome do tópico para atualização dos dados do IC no ITSM. O nome default é cmdb-integration-data
· kafka.topics.topology (opcional) – Nome do tópico para atualização da topologia do IC no ITSM. O nome default é cmdb-integration-topology
· itsm.maxAttempts – Quantidade máxima de novas tentativas em caso de erro na integração com ITSM
4. GAPE - Infra criar dois tópicos
Criar no Kafka os tópicos definidos no parâmetro kafka.topics.data e kafka.topics.topology com pelo menos 2 partições.
5. GAPE - Governanca - Parametrização
· 
Pré-requisitos:
- URL do Faas - Gape Infraestrutura
- Service do Kafka - GAPE - Infraestrutura
· Cadastrar o evento CMDB Integration - Start ou importar o arquivo event_cmdb_integration_-_start.json:
· Tipo: Webhook -> FaaS
· Tipo de Execução da Ação -> Synchronous
· Na ação de saída:
· FaaS name: cmdb_start_integration
· Cadastrar o evento CMDB Integration - Sync data with ITSM ou importar o arquivo event_cmdb_integration_-_sync_data_with_itsm.json
· Tipo: Kafka -> FaaS
· Tipo de execução da ação: Synchronous
· No conector Read Kafka:
· Topics: o mesmo informado no parâmetro cmdb.integration.parameters, atributo kafka.topics.data
IMPORTANTE: Eventos associados a Cluster Spaces diferentes devem ter nomes de tópicos diferentes
· Kafka servers: o mesmo informado no parâmetro cmdb.integration.parameters, atributo kafka.brokers
· Group: cmdb-integration
· Max messages: a mesma quantidade de partições criada para o tópico
· Auto Commit enable? True
· Auto offset reset: earliest
· Number messages to read: a mesma quantidade de partições criada para o tópico
· Na ação de saída:
· FaaS name: cmdb_data_sync
· Cadastrar o evento CMDB Integration - Sync topology with ITSM ou importar o arquivo event_cmdb_integration_-_sync_topology_with_itsm.json
· Tipo: Kafka -> FaaS
· Tipo de execução da ação: Synchronous
· No conector Read Kafka:
· Topics: o mesmo informado no parâmetro cmdb.integration.parameters, atributo kafka.topics.topology
IMPORTANTE: Eventos associados a Cluster Spaces diferentes devem ter nomes de tópicos diferentes
· Kafka servers: o mesmo informado no parâmetro cmdb.integration.parameters, atributo kafka.brokers
· Group: cmdb-integration
· Max messages: a mesma quantidade de partições criada para o tópico
· Auto Commit enable? True
· Auto offset reset: earliest
· Number messages to read: a mesma quantidade de partições criada para o tópico
· Na ação de saída:
· FaaS name: cmdb_topology_sync
6. AIOPS - Funcionamento
· O SIMON aciona o evento Webhook CMDB Integration - Start na URL {endereço da porta 8086 do Events /events/webhook/{uuid do evento}, enviando a relação de itens de configuração inseridos ou alterados. Exemplo de chamada:
· POST https://eventsws-run2biz.cithyper.click/events/webhook/9b470a53-8354-d355-6c55-d874e6cf0c33
· BODY
{
 "data": [
 {
 "ci_id": "CI0000093",
 "timestamp": 1731702675,
 "action": "update",
 "source": "simon"
 },
 {
 "ci_id": "CI0001951",
 "timestamp": 1731702675,
 "action": "update",
 "source": "simon"
 }
] 
· Esse evento aciona o FaaS cmdb_start_integration, que:
· Cria um registro de log no objeto de negócio LogHeader
· Percorre a lista de itens de configuração do payload e, para cada item, envia uma mensagem com a identificação do IC para o tópico definido no parâmetro cmdb.integration.parameters, atributo kafka.topics.data 
· O evento CMDB Integration - Sync data with ITSM lê o tópico Kafka definido no atributo kafka.topics.data e aciona o FaaS cmdb_data_sync, que:
· Obtem os detalhes do IC consumindo o serviço definido no parâmetro cmdb.integration.parameters, atributo simon.url. Em caso de erro, faz nova tentativa até o limite definido em parameters.simon.maxAttempts
· Formata os dados e consome o serviço /webmvc/v1/configuration-item/inventory do ITSM para incluir ou atualizar as informações do item de configuração. Em caso de erro, faz nova tentativa até o limite definido em parameters.itsm.maxAttempts
· Percorre os itens do array topology retornados no detalhamento do item. Para cada item da topologia cujo atributo source seja igual ao IC em processamento:
· Verifica se o destination existe no ITSM ou no payload original enviado pelo Simon no webhook. Se o IC não existir, envia para processamento no tópico definido pelo atributo kafka.topics.data e grava um registro no objeto de negócio LogTopology. Se o destination existir, envia para processamento no tópico definido pelo atributo kafka.topics.topology
· O evento CMDB Integration - Sync topology with ITSM lê o tópico Kafka definido no atributo kafka.topics.topology e aciona o FaaS cmdb_topology_sync, que:
· Verifica se o source e destination existem no ITSM
· Formata os dados e consome o serviço /webmvc/cmdb/topology/{source} do ITSM para incluir ou atualizar as informações da topologia
7. AIOPS - Consulta do log de processamento
O log de processamento da integração pode ser consultado através da página de CRUD do form cmdb_integration_log (/lowcode/form/cmdb_integration_log/crud)
Ao clicar no detalhamento do item, o sistema exibe uma tela com três grids: Itens processados, Itens não processados e Itens com erro. Nessa tela, é possível cancelar os itens não processados.
Em cada grid, é possível filtrar pelo CI ID
O detalhamento do item mostra o ID e nome do ITSM, o log de processamento, os itens de topologia e o payload de detalhamento do IC obtido no Simon
É possível visualizar também o detalhamento dos erros de processamento
image5.png
image6.png
image7.png
image8.png
image9.png
image10.png
image1.png
image2.png
image3.png
image4.png