...
Essa documentação trata do serviço externo Zabbix. SmartOLT O serviço externo é acessado via API. As funcionalidades descritas aqui indicam as capacidades e os requisitos da integração, bem como o questionário e as funcionalidades relacionadas.
| Table of Contents | ||||
|---|---|---|---|---|
|
Descrição
O Zabbix SmartOLT é uma ferramenta de software de código aberto para monitorar a infraestrutura de TI, como redes, servidores, máquinas virtuais, serviços em nuvem e equipamentos de rede em geral (como ONUs de clientes, por exemplo). O Zabbix coleta e exibe métricas básicas.para gerência de algumas marcas de OLTs. Adição, remoção, provisionamento, gerenciamento e monitoramento de ONUs estão entre as principais funcionalidades deste sistema.
As funcionalidades da integração entre OZmap e Zabbix SmartOLT se baseiam nos items disponíveis no sistema de monitoramento, e seus identificadores. Para extrair informações destes identificadores, são utilizadas expressões regulares, as quais extraem de um texto a informação desejada, exemplo:
| Code Block |
|---|
ITEM = JOAODASILVA-05325423605-joao.silva |
Considerando que o código utilizado no OZmap é o login PPPoE utilizado pelo cliente, a integração aplica uma função no texto acima para extrair apenas essa informação, que seria: “joao.silva“.
Para isso, a expressão regular é utilizada.
Veja aqui exemplos de como pode ser formatado o texto do item e expressões para usar
Dados Acesso
https://docs.google.com/forms/d/e/1FAIpQLSffEHBN8_z-qusFP36R3HJ9RXueblHISNsAVffnaHejj84udQ/viewform
Zabbix
na leitura de potências e status de ONUs no SmartOLT para atualização destes dados nos clientes OZmap. A integração encontra as ONUs SmartOLT no OZmap através do serial das ONUs (“sn“ no SmartOLT deve ser igual ao “serial” do cliente no OZmap para que seja atualizado).
Dados Acesso
SmartOLT
Dados de acesso necessários para buscar informações via API no sistema ZabbixSmartOLT. (Estes dados devem ser fornecidos no questionário inicial)
Parâmetro | Descrição | Exemplo | ||
|---|---|---|---|---|
URL | Endereço do servidor Zabbix considerando se existe ou não um “path” para acessar(ex: /zabbix)SmartOLT. | https://zabbixcliente.clientesmartolt.com.br/zabbix | ||
Login | Nome usuário do sistema criado para a integração. | ozmap | ||
Senha | Senha de acesso do usuário | Chave API | Chave API para acesso ao SmartOLT. | - |
OZmap
Parâmetro | Descrição | Exemplo |
|---|---|---|
Token | Token associado a conta do usuário de integração cadastrado no ozmap. ( O usuário deve ter acesso aos projetos que a integração irá trabalhar (Escolha do usuário). Tutorial de como gerar usuário/chave.) | eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJtb2R1bGUiOiJhcGkiLCJ1c2VyIjoiNWQ5ZjNmYjgyMDAxNDEwMDA2NDdmNzY4IiwiY3JlYXRpb25EYXRlIjoiMjAyMC0wOC0yNFQxNjoxMjoyMS43MTdaIiwiaWF0IjoxNTk6Mjg1NTQxfQ.S215vbHlBLtZSzxmORIc2sH1lEKi5VALKBqZB1VcFCE |
...
Configurações Base
Parâmetro | Descrição | Padrão |
|---|---|---|
Nome do Item de Status | Nome do item de status da ONU no Zabbix (ex: Status ONU) | Status ONU |
Nome do Item de Potência | Nome do item de potência lida na ONU no Zabbix (ex: Potência RX)||
Tempo entre Sincronizações | Tempo aguardado entre as sincronizações realizadas pela integração | 15 minutos |
...
Parâmetro
Descrição
Padrão
Nome do item de status da ONU no Zabbix (ex: Status ONU)
Status ONU
Atributo que será utilizado para extrair o código que será buscado dentro do OZmap, a extração ocorre por expressão regular, identificada abaixo. (ex: name, key_)
name
Expressão utilizada para extrair do parâmetro de código, o código que será buscado no OZmap, o padrão é utilizar todo o valor do atributo indicado acima.
/(.*)/
Configurações Específicas - Potência
...
Parâmetro
...
Descrição
...
Padrão
...
Nome do item que guarda a potência da ONU no Zabbix (ex: Potency ONU)
...
Potency RX
...
Atributo que será utilizado para extrair o código que será buscado dentro do OZmap, a extração ocorre por expressão regular, identificada abaixo. (ex: name, key_)
...
name
...
...
Expressão utilizada para extrair do parâmetro de código, o código que será buscado no OZmap, o padrão é utilizar todo o valor do atributo indicado acima.
...
/(.*)/
Logs
Os logs da integração são disponibilizados no endereço: https://$cliente.ozmap.com.br/integrations/zabbix/logs.
...
Funcionalidade | Descrição | Direção da integração |
|---|---|---|
Atualização de status | Atualização do valor de status do cliente no OZmap baseado na leitura informada pelo ZabbixSmartOLT. | Zabbix SmartOLT => OZmap |
Atualização de potência | Atualização do valor de potência lida no OZmap baseado na leitura informada pelo ZabbixSmartOLT. | Zabbix SmartOLT => OZmap |
Funcionalidades
Abaixo serão descritas as funcionalidades apresentadas no resumo de forma a entender como funciona o fluxo de sincronização.
...