š”ServiƧo de Logs Remotos
Acesso Antecipado (Beta)Esta documentação refere-se a uma versão em acesso antecipado do SDK Sankhya. As funcionalidades e APIs estão sujeitas a modificações. Para obter acesso, envie um e-mail para [email protected] informando a
appkeydo seu projeto.
š”ServiƧo de Logs Remotos
Visão Geral
O serviƧo de logs remotos permite que aplicaƧƵes que utilizam o SDK Sankhya enviem logs de maneira centralizada para anƔlise, auditoria e monitoramento.
Essa abordagem evita que cada aplicação mantenha sua própria infraestrutura de logs e facilita:
- Monitoramento de erros em produção
- Auditoria de operaƧƵes crĆticas
- Detecção de comportamentos anÓmalos
- Suporte técnico e diagnóstico
Como Funciona
Quando a funcionalidade estĆ” habilitada para o projeto:
- O SDK intercepta mensagens enviadas pelos loggers suportados.
- Os logs sĆ£o normalizados e enriquecidos com contexto (quando disponĆvel), como usuĆ”rio, transação, módulo, etc.
- Os logs são enviados para o serviço remoto de armazenamento e anÔlise.
NĆ£o Ć© necessĆ”rio alterar o código que jĆ” faz logging ā a configuração ocorre automaticamente.
Loggers Suportados
Atualmente, os seguintes loggers sĆ£o compatĆveis com o serviƧo de logs remotos:
| Framework | Suporte | Observação |
|---|---|---|
| Log4J 1.x | ā Suportado | VersƵes anteriores ao Log4J2 |
| JUL (java.util.logging) | ā Suportado | Configuração automĆ”tica via SDK |
Ativação
A ativação é automÔtica para projetos aprovados no programa Beta. Nenhuma configuração manual adicional é necessÔria.
Para verificar se o serviƧo estƔ ativo:
- Gere um log de nĆvel
INFOou superior em sua aplicação. - Consulte o painel de observabilidade disponibilizado pela Sankhya ou solicite confirmação ao suporte.
RecomendaƧƵes de Uso
Para aproveitar o serviƧo de logs remotos de forma eficiente:
- Utilize nĆveis de log de maneira consistente (ex.:
ERRORpara exceções reais). - Inclua contexto útil (ex.: ID de pedido, usuÔrio, etapa do processo).
- Evite logar objetos grandes ou dados sigilosos.
Consequência de mÔ utilização: Logs excessivos podem aumentar custos e dificultar a anÔlise, além de impactar a performance da aplicação.
CondiƧƵes de Uso
O serviço de logs remotos não é habilitado automaticamente para todos os projetos. Para garantir estabilidade, capacidade e segurança, existem condições e regras para utilização:
- Ć necessĆ”rio configurar o componente de logs na Ćrea do Desenvolvedor para habilitar o recebimento.
Após a aprovação, o serviço é ativado sem alterações no código, desde que o projeto utilize um dos loggers suportados.
Updated about 1 hour ago
