Esta documentação abrange a área de troubleshooting, essencial para resolver problemas técnicos e manter sistemas funcionando adequadamente. Exploraremos a abordagem sistemática de análise de sintomas, testes e diagnóstico, além de destacar a importância da colaboração e compartilhamento de conhecimento. O guia fornece informações valiosas para aprimorar habilidades técnicas e enfrentar desafios com confiança, garantindo a eficiência operacional. Mantenha-se atualizado com as últimas tendências nesse campo em constante evolução.

Timezone

Problema: Como colocar os horários dos logs corretamente?

Para trocar o fuso horário (timezone) de um container Docker em execução, você pode seguir estas etapas:

1. Primeiro, você precisa entrar no container. Você pode fazer isso usando o comando docker exec seguido pelo ID ou nome do container e um shell interativo, como o bash. Por exemplo:

   docker exec -it <container_id_ou_nome> bash

2. Dentro do container, você pode configurar o fuso horário usando o comando tzdata, selecionando o local de horário correspondente a sua área de localização (São Paulo/Brasilia, Acre, Amazonas ou Fernando de Noronha)

   # Configurar o fuso horário interativamente dpkg-reconfigure tzdata

3. Após configurar o fuso horário, saia do shell interativo dentro do container, digitando exit.

4. Reinicie o container para que as alterações se reflitam

docker restart <container_id_ou_nome>

5. Verifique que agora os horários estão corretamente acompanhando o seu container

docker logs -f <container_id_ou_nome>

Omnilink não responde !?

Problema: Ao tentar realizar o login na plataforma da Mobile, não é retornado nada!

É necessário confirmar se o omnilink está funcionando corretamente, vamos seguir algumas etapas:

1. Verifique se as requisições de login efetuadas pelo Configurador Público estão batendo em seu Firewall (é obrigatório que as requisições sejam realizadas do configurador público e não da rede local), caso não esteja é necessário verificar com sua equipe de infraestrutura ( no 5 passo sempre coloque um timeout entre 30 e 45 segundos)

2. Em caso destas requisições estarem batendo pelo firewall da empresa vamos para a segunda etapa (siga para esta etapa apenas confirmação das requisições realizadas pelo configurador público estarem “batendo" no firewall da empresa), que é verificar dentro na maquina na qual está instalado o omnilink as queries que estão sendo executadas;

• Acesse o terminal linux do seu servidor e execute o comando:

# docker ps

• Na saída desse comando procure a instancia do omnlink que está apresentando problemas em retornar as devidas informações (Autenticação, Boletos, Extratos , etc.. ) deve ser semelhante a essa:

• Para analisar as falhas, recomendamos verificar o log do OMNILINK, através do comando de análise de logs:

# docker logs -f nome_da_sua_instancia_OMNILINK

• Realize uma nova requisição a partir do configurador público, neste momento com este comando sendo executado em seu terminal, será possível capturar as requisições efetuadas para o omnilink;

• Pegue as queries que foram capturadas no Omnilink e realize essa requisição no SGDB para o seu banco de dados e verifique se estão retornando dados. (Não mude nenhum parâmetro ao rodar a query em seu banco de dados, se está precisando mudar os parâmetros para que se obtenha retornos é necessário verificar as regras de negócio da Operadora).

• Verifique as Views que foram implementadas (existem views que são opcionais e caso não tenha sido implementada pela operadora podem ser ignoradas, mas apenas as views opcionais que NÃO foram implementadas, a partir do momento que foi implementadas a verificação e suas regras de negócio tornam-se OBRIGATÓRIAS).

• Identifique e ajuste o problema para que o omnilink possa a funcionar novamente de forma correta.

Omnilink - Débitos não retorna os dados ordenados!

Problema: Ao tentar utilizar a rotina de boletos a mesma não vem com os dados ordenados

O Omnilink não possui ordenação em sua requisições, os dados são retornados conforme estão disponíveis nas views, ou seja é necessário que os dados estejam ordenados na view ( e isso deve ser feito conforme a necessidade de regras de negócio da Operadora).

Ou seja a aplicação Web ou App só reflete o retorno da API que é gerada pelo Omnilink, existem alguns filtros existentes nas aplicações porém a exibição padrão é definida pelo retorno da API que é gerada pelo Omnilink.

Como consigo verificar se minha view está retornando os dados corretamente?

• Acesse o terminal linux do seu servidor e execute o comando:

# docker ps

• Na saída desse comando procure a instancia do omnlink que está apresentando problemas em retornar as devidas informações (Autenticação, Boletos, Extratos , etc.. ) deve ser semelhante a essa:

• Para analisar, recomendamos verificar o log do OMNILINK, através do comando de análise de logs:

# docker logs -f nome_da_sua_instancia_OMNILINK

• Realize uma nova requisição a partir do configurador público (neste caso na acessando a funcionalidade de boletos) no método listaDebitos

• Neste momento com este comando sendo executado em seu terminal, será possível capturar as requisições efetuadas para o omnilink;

• Pegue as queries que foram capturadas no Omnilink e realize essa requisição no SGDB para o seu banco de dados e verifique se estão retornando dados. (Não mude nenhum parâmetro ao rodar a query em seu banco de dados, se está precisando mudar os parâmetros para que se obtenha retornos é necessário verificar as regras de negócio da Operadora).

• O resultado destas queries são o resultado que será levado para a API de listagem do débito.

• Ajuste a view ordenando de forma que as queries de listagem do débito retornem da forma que seja desejado pela operadora.

Testes de conexão Omnilink - Postman

Após instalação do OMNILINK, para iniciar os testes de conexão a partir de seu computador, recomendamos que acesse o painel e baixe a collection do POSTMAN
Acesse o Painel > Ferramentas > Omnilink > Editar > Coleção do Postman.

Caso não tenha o Postman instalado no seu computador, instale-o utilizando o link https://www.postman.com/downloads/

Estes testes servem para certificar se os Endpoints gerados estão retornando corretamente, sendo possível verificar as queries que foram capturadas conforme explicado no passo anterior.
https://mobilesaudejira.atlassian.net/wiki/spaces/MO/pages/edit-v2/3178758145#Omnilink-n%C3%A3o-responde-!%3F

Recomendamos fortemente os testes realizados no Postman verificando as queries antes de prosseguir com a integração no Painel Publico, pois estes testes ajudam a verificar eventuais problemas antes de disponibilizar os Endpoints na plataforma.

Atualização de Omnilink

Caso exista necessidade de atualizar o Omnlink recomendamos atentar para:

1 - Atualizações que são apenas para atualizar o Omnlink com a versão mais atual que a Mobile Saúde disponibiliza.

Resposta: Se não existe mudança a da infra estrutura ( Local onde está instalado Omnlink e mudança de banco de dados), pode ser feita a atualização diretamente, pois só serão atualizados dados do Omnlink.

2 - Atualização de Omnlink visando migrar a máquina onde está instalado o Omnlink

Resposta: No caso de existir necessidade de mudança da infra estrutura onde está instalado o Omnlink ( mudança de servidor, atualização do docker instalado na máquina, mudança de sistema operacional na maquina que esta o omnilink Ex: do Ubuntu para um CentOs), recomendamos que a atualização/migração seja realizada de forma cautelosa onde recomendamos que seja testado a instalação do Omnlink na infra nova e depois de testa-la que seja feito o apontamento do Omnlink no Painel da Mobile Saúde para a nova infra.

Exemplo: Omnilink - PRD - Autenticação instalado é necessário ser migrado para uma nova infra estrutura, neste caso instale o Omnlink - Sandbox/Homologação - Autenticação na nova infra ( Existem portas para o Omnlink Produção e Sandbox (clique aqui para ver serviços e portas dos serviços do Omnlink) com isso realize todos os teste em todos os serviços e métodos ( Trocar senha, relogin, buscaBeneficiarios e etc) com tudo validado é rodar o script de produção na nova infra com a certeza de que tudo funcionará corretamente.

3 - Atualização de Omnlink visando migrar/atualizar versão do banco de dados

Resposta: No caso de necessidade de atualização de versão do banco de dados (Postgress X → Postres X+1) ou mesmo migrar de um banco para outro (Posgres → MySql), recomendamos fortemente que seja realizado a mesma orientação do anterior ( 2 - Atualização de Omnlink visando migrar a máquina onde está instalado o Omnlink), onde deve-se instalar uma versão com as portas de sandbox/homologação e realizar todos os testes de forma interna e externa a fim de garantir que a migração não impactará nos serviços já disponíveis.