O utilitário Logs do administrador

Saiba como o utilitário Logs do administrador ajuda você a diagnosticar, monitorar e resolver problemas de configuração com eficiência no CPQ ambiente.

O utilitário Logs do administrador fornece aos administradores visibilidade centralizada das atividades do sistema, erros de configuração e problemas de integração. Ele permite o diagnóstico e a resolução rápidos de problemas capturando os principais detalhes de tempo de execução, mensagens de erro e dados contextuais sobre o ambiente. Projetado com a usabilidade e precisão em mente, os logs do administrador ajudam os administradores a identificar problemas, entender suas causas e agir rapidamente para manter a estabilidade do sistema.

Seja acessado por meio da IU do administrador ou pela API, os logs do administrador ajudam a fornecer informações que os administradores podem usar para otimizar configurações e manter os usuários produtivos.

Principais benefícios

Tabela 1. Principais benefícios dos logs do administrador

Benefício	Descrição
Visibilidade centralizada	Monitore erros de configuração, tempo de execução e integração em um local.
Monitoramento em tempo real	Atualize e filtre logs rapidamente para se concentrar nos períodos de tempo mais recentes ou relevantes.
Solução de problemas mais rápida	Revise códigos de erro detalhados, mensagens contextuais e IDs de usuário para obter diagnósticos precisos.
Acessibilidade da API	Recupere dados de log de forma programática para automação ou painéis personalizados.
Melhoria contínua	Acesse relatórios de erros aprimorados e detalhes contextuais para ajudar a simplificar a manutenção contínua e o suporte ao usuário.

Acessando logs do administrador

Os administradores podem acessar os logs do administrador no CPQ Ou via API, dependendo do fluxo de trabalho preferencial e do caso de uso.

Na nova experiência do administrador, acesse Logs no menu Utilitários. Na Experiência do administrador legada, clique em Logs na barra de navegação. As duas experiências fornecem os mesmos recursos de registro em log em tempo real e permitem filtrar, atualizar e exibir informações detalhadas de erros.

Atualizando e filtrando

A interface de logs oferece suporte a opções de filtragem e atualização em tempo real. Escolha um intervalo de tempo que melhor se adapte às suas necessidades de análise:

• Últimos 15 minutos
• Hora anterior
• Últimas 24 horas
• Todos os logs

Nota:

Use o botão Atualizar para atualizar a exibição com os eventos mais recentes sem sair da página Logs.

Formato de detalhes do log

Cada entrada de log é exibida em um formato estruturado, facilitando a verificação e a compreensão de problemas. Essa estrutura permite que os administradores filtrem, correlacionem e resolvam erros com eficiência em diferentes sessões e componentes. Os dados de log incluem as seguintes colunas:

• Data e hora: Exibição de data amigável e hora exata em milissegundos (adicionado em fevereiro de 2025).
• Mensagem de erro: Um resumo descritivo do problema encontrado.
• Código de erro: CPQ identificador exclusivo para referência cruzada rápida e solicitações de suporte.
• ID do usuário: O usuário que encontrou o erro (adicionado em fevereiro de 2025).

Acessando logs via API

Os administradores que preferem consultar logs de forma programática podem acessar a API Logs do administrador usando uma solicitação GET. Isso é especialmente útil para ambientes com grandes conjuntos de dados ou para integrar logs em sistemas de monitoramento externos. Essa flexibilidade permite que os administradores recuperem intervalos de log específicos para auditoria ou revisão de desempenho sem carregar todos os registros históricos.

Comando curl de exemplo:

    curl --location '<logikURL>/api/logs/v1/logs' \
    --header 'Content-Type: application/json' \
    --header 'Origin: localhost' \
    --header 'Authorization: <Admin API Key>'
   

Você pode refinar os resultados especificando beforee. afterParâmetros no formato de data/hora ISO 8601:

    curl --location '<logikURL>/api/logs/v1/logs?after=YYYY-MM-DDThh%3Amm%3AssZ&before=YYYY-MM-DDThh%3Amm%3AssZ' \
    --header 'Content-Type: application/json' \
    --header 'Origin: localhost' \
    --header 'Authorization: <Admin API Key>'
   

Melhorias contínuas

Os logs do administrador evoluem continuamente para fornecer informações mais detalhadas e melhorar a usabilidade. As melhorias introduzidas em fevereiro de 2025 incluem:

• Mensagens de erro aprimoradas: Salvar erros agora incluem erros de configuração relacionados para uma identificação mais rápida do problema.
• Informações contextuais: Para erros de script de aprimoramento, os logs agora capturam a área de aprimoramento específica, o blueprint afetado e o ID de revisão para depuração precisa.
• Erros de conexão externa detalhados: Os erros HTTP "Método não compatível" agora incluem o caminho e o método usados na chamada externa.
• Métricas de desempenho: As métricas para integrações externas agora são rastreadas e estão disponíveis mediante solicitação por meio de CPQ suporte.

Diretrizes gerais

• Use filtros de tempo curto ao solucionar problemas de configuração em tempo real.
• Exporte dados de log relevantes regularmente para acompanhamento de longo prazo ou revisão de conformidade.
• Aproveite a API para automatizar a recuperação de logs ou integrar-se às ferramentas de monitoramento da sua organização.
• Relate códigos de erro pouco claros ou contexto ausente para CPQ suporte para análise e melhoria.