Solução de Problemas

Guia para diagnosticar e resolver problemas comuns no Sincroniza.

Problemas de Conectividade

Active Directory Desconectado

Sintoma: Status "Desconectado" no Dashboard

Diagnóstico:

1. Verifique conectividade de rede com o DC
2. Teste porta LDAP (389) ou LDAPS (636)
3. Valide credenciais da conta de serviço

Soluções:

# Testar conectividade
telnet dc01.corp.local 389

# Testar LDAP
ldapsearch -h dc01.corp.local -p 389 -D "CORP\svc-sincroniza" -w "senha" -b "DC=corp,DC=local" "(objectClass=user)"

Erro	Causa	Solução
Connection refused	Porta bloqueada	Verificar firewall
Timeout	Servidor inacessível	Verificar rede
Invalid credentials	Senha errada	Redefinir senha
Account locked	Muitas tentativas	Desbloquear conta

Entra ID Desconectado

Sintoma: Erro de autenticação com Graph API

Diagnóstico:

1. Verifique se o Client Secret não expirou
2. Valide permissões de API
3. Verifique Tenant ID e Application ID

Soluções:

Erro	Causa	Solução
AADSTS7000215	Secret inválido	Renovar secret
AADSTS700016	App não encontrado	Verificar App ID
Forbidden	Permissões insuficientes	Adicionar permissões

Problemas de Sincronização

Sincronização Falhando

Sintoma: Status "Erro" na última sincronização

Diagnóstico:

1. Verifique logs da sincronização
2. Identifique em qual etapa falhou
3. Verifique conectividade com fonte de dados

Causas Comuns:

Etapa	Erro	Solução
Conexão HR	Timeout	Verificar banco de dados
Importação	Dados inválidos	Revisar mapeamentos
Avaliação	Perfil inválido	Verificar perfis
Execução	Provedor offline	Verificar provedores

Funcionários Não Atualizando

Sintoma: Dados do RH não refletem no Sincroniza

Diagnóstico:

1. Verifique se a view do RH está atualizada
2. Confirme que o mapeamento de campos está correto
3. Verifique se há erros de transformação

Soluções:

-- Verificar dados na view do RH
SELECT * FROM VW_SINCRONIZA_COLABORADORES
WHERE MATRICULA = '12345'

Problema	Causa	Solução
Dados antigos	View não atualizada	Verificar com DBA
Campo vazio	Mapeamento incorreto	Revisar mapeamento
Formato errado	Transformação falhou	Ajustar transformação

Sincronização Lenta

Sintoma: Sincronização demora mais que o normal

Diagnóstico:

1. Verifique número de funcionários
2. Analise quantidade de mudanças
3. Verifique performance do banco de dados

Soluções:

Causa	Solução
Muitos funcionários	Otimizar query do RH
Muitas mudanças	Verificar se dados estão oscilando
Banco lento	Adicionar índices
Rede lenta	Verificar infraestrutura

Problemas de Ações

Ações Falhando Repetidamente

Sintoma: Mesma ação falha múltiplas vezes

Diagnóstico:

1. Verifique mensagem de erro detalhada
2. Identifique o tipo de ação
3. Teste operação manualmente

Erros Comuns:

Erro	Causa	Solução
Access denied	Permissão insuficiente	Verificar conta de serviço
User not found	Conta não existe	Verificar vinculação
Group not found	Grupo removido	Atualizar perfil
License unavailable	Sem licenças	Adquirir licenças
Constraint violation	Dado inválido	Verificar dados

Ações Pendentes Acumulando

Sintoma: Muitas ações em status "Pendente"

Diagnóstico:

1. Verifique se o executor está rodando
2. Confirme conectividade com provedores
3. Verifique se há bloqueio de aprovação

Soluções:

Causa	Solução
Provedor offline	Restaurar conectividade
Executor parado	Reiniciar serviço
Aguardando aprovação	Processar aprovações
Rate limiting	Aguardar e reprocessar

Problemas de Aprovação

Notificações Não Chegando

Sintoma: Aprovadores não recebem email

Diagnóstico:

1. Verifique configuração de email
2. Confirme destinatários
3. Verifique logs de envio

Soluções:

Causa	Solução
Email incorreto	Corrigir destinatário
SMTP falhou	Verificar configuração
Bloqueado por spam	Whitelist o remetente
Serviço indisponível	Verificar Azure Communication Services

Lotes Não Sendo Criados

Sintoma: Ações executam sem aprovação

Diagnóstico:

1. Verifique políticas de aprovação
2. Confirme limites configurados
3. Verifique se tipos obrigatórios estão marcados

Soluções:

Causa	Solução
Limites altos	Reduzir limites
Política desativada	Ativar política
Tipo não marcado	Marcar tipos obrigatórios

Problemas de Descoberta

Descoberta Não Encontra Contas

Sintoma: Poucos ou nenhum resultado

Diagnóstico:

1. Verifique filtros de busca
2. Confirme Base DN ou escopo
3. Teste consulta manualmente

Soluções:

Causa	Solução
Filtro restritivo	Ampliar filtro
Base DN errada	Corrigir Base DN
Contas desabilitadas	Incluir desabilitadas
Permissão negada	Verificar conta de serviço

Correspondências Incorretas

Sintoma: Algoritmo sugere matches errados

Diagnóstico:

1. Verifique dados de funcionários
2. Analise atributos das contas
3. Compare critérios de match

Soluções:

Causa	Solução
Dados incompletos	Melhorar dados do RH
Nomes diferentes	Normalizar nomes
Email diferente	Usar outro critério

Problemas de Performance

Sistema Lento

Sintoma: Interface demora para responder

Diagnóstico:

1. Verifique uso de CPU e memória
2. Analise queries lentas no banco
3. Verifique latência de rede

Soluções:

Causa	Solução
CPU alta	Aumentar recursos
Memória baixa	Adicionar RAM
Banco lento	Otimizar índices
Muitos dados	Implementar paginação

Banco de Dados Cheio

Sintoma: Erros de espaço em disco

Diagnóstico:

1. Verifique espaço em disco
2. Analise tamanho das tabelas
3. Verifique logs acumulados

Soluções:

Causa	Solução
Logs antigos	Limpar logs
Auditoria grande	Arquivar dados antigos
Backups locais	Mover para storage

Logs e Diagnóstico

Habilitando Logs Detalhados

Para troubleshooting, aumente o nível de log:

1. Acesse configurações de log
2. Mude para nível "Debug"
3. Reproduza o problema
4. Analise os logs
5. Retorne ao nível "Warning"

Coletando Informações

Ao reportar problemas, inclua:

• [ ] Versão do Sincroniza
• [ ] Mensagem de erro exata
• [ ] Logs relevantes
• [ ] Passos para reproduzir
• [ ] Configurações relacionadas

Contato com Suporte

Se o problema persistir:

1. Documente todas as tentativas de solução
2. Colete logs e configurações
3. Entre em contato com suporte IP5 Tecnologia

Informações Necessárias

• Descrição do problema
• Ambiente (produção, teste)
• Versão do sistema
• Logs de erro
• Screenshots (se aplicável)