/
Logar / Log

Logar / Log

Gera um log na saída do console de acordo com a configuração do nível de log. Quanto maior a abrangência do Nível de log, mais logs serão gerados. Para mais detalhes, acesse a documentação oficial.

 

Figura 1 – Bloco Logar

Compatibilidade

  • Bloco servidor: cronapi.util.Operations.log()

Retorno

Bloco sem retorno.

Parâmetros

Categoria

Chave de referência da mensagem do log. O Cronapp utiliza a categoria "General" por padrão, porém, é possível personalizar a categoria para facilitar a identificação da mensagem em meio a um documento de log muito extenso.

  • Posição: 1

  • Inglês: Category

  • Tipo: Texto / String

  • Exemplo: "General"

Nível de log

Define o nível e tipo de log. Por padrão, o sistema do Cronapp é configurado com os níveis de log "Informação", "Erro" e "Aviso". Para exibir o log das demais opções, será necessário criar um novo parâmetro do sistema. Assim, acesse no menu do sistema Projeto > Parâmetros do sistema. Na janela que será exibida, clique em "Novo" para criar um novo parâmetro e, nele, escolha a opção Nível de log. A exibição do log ocorre por ordem hierárquica, ou seja, habilitar o log em um determinado nível também habilitará o log em todos os níveis superiores.

  • Posição: 2

  • Inglês:  Log Level

  • Tipo: Texto / String

  • Exemplo: configurando a opção Refinado Médio no parâmetro do sistema e Refinado Médio no bloco, ele irá exibir os logs de Refinado Médio e todas as outras antes dele, e assim por diante.

  • Níveis em ordem decrescente:

    • Erro (SEVERE (maior valor)): mensagens de erro devem descrever eventos de considerável importância que impedirão a execução normal do programa.

    • Aviso (WARNING): mensagens de aviso devem descrever eventos que indicam problemas potenciais para usuários finais e administradores do sistema.

    • Informação (INFO): as mensagens de informação devem ser usadas apenas para mensagens razoavelmente significativas que façam sentido para usuários finais e administradores do sistema.

    • Configuração (CONFIG): mensagens de configuração são destinadas a fornecer uma variedade de informações de configuração estática para auxiliar na solução de problemas associados a configurações específicas. Por exemplo, uma mensagem de configuração pode incluir o tipo de CPU, a profundidade gráfica e a aparência da interface gráfica.

    • Refinado Baixo (FINE): mensagens fine podem incluir informações sobre falhas menores (recuperáveis). Questões que indicam potenciais problemas de desempenho também valem a pena ser registradas nesse nível.

    • Refinado Médio (FINER): indica uma mensagem de rastreamento bastante detalhada. Por padrão, chamadas de registro para entrada, retorno ou lançamento de uma exceção são rastreadas neste nível.

    • Refinado Alto (FINEST (menor valor)): indica uma mensagem de rastreamento altamente detalhada.

Mensagem de log

Texto que será enviado para o log.

  • Posição: 3

  • Inglês: Log Menssage

  • Tipo: Texto / String

  • Exemplo: "E-mail enviado com sucesso."

Detalhe de log

Poderá ser um texto ou um objeto de exceção contendo os detalhes do log.

  • Posição: 4

  • Inglês:  Log Detail

  • Tipo: Objeto / Object 

  • Exemplo: é possível utilizar um bloco texto ou uma variável de parâmetro da função, como no exemplo da figura 2.

Exemplo 

A função abaixo enviará para o console uma mensagem de log do tipo Informação após um e-mail ser enviado.

Figura 2 - Enviando log para o console com o bloco Logar


Após a função acima ser executada, é exibido no console o log que foi configurado no bloco Logar. 

Figura 2.1 - Log gerado no console

Nesta página