Log

São detalhadas abaixo as configurações para controle de log.

Variável	Descrição Rápida
HSM_LOG_LEVEL	Nível de informação registrada no log (1000: nenhum log, 0: erro, 3: depuração).
HSM_LOG_DIR	Caminho do diretório de logs.

Nível

Variável de ambiente a ser definida: HSM_LOG_LEVEL

Valor	Nível de Log
1000	Desabilitado: nenhum evento é registrado em log.
0	Apenas erros: registra apenas situações de erro (normalmente impedem a execução do serviço solicitado).
3	Depuração: registra informações detalhadas de operação, além das mensagens de erro, advertência e informação.

O valor é o tipo e detalhamento desejado dos eventos no arquivo de log. Em condições normais de operação, é recomendável manter o mínimo de log da biblioteca. O detalhamento maior nos registros de eventos pode ser usado para diagnosticar problemas de operação.

Diretório

Variável de ambiente a ser definida: HSM_LOG_DIR

Valor	Caminho do diretório de Log
Não definida	Não gera logs.
dir path	Caminho completo do diretório de log.
stdout	Direciona as mensagens de log de para a saída padrão stdout e as mensagens de erro para stderr. Use o literal stdout. Geralmente utilizado em ambientes baseados em container.

A biblioteca tenta criar os arquivos de log no caminho indicado, se não conseguir (falta de espaço, falta de permissão, etc) ela continuará executando as operações normalmente.

Quando esta variável de ambiente é definida, a geração de logs é feita por padrão com o nível de logs em depuração e com escrita direta no arquivo (sem cache). Para alterar o nível de logs, defina a variável de ambiente HSM_LOG_LEVEL.

Formação do nome dos arquivos de log gerados

Os arquivo de log são gerados por processo que carrega a(s) biblioteca(s), usando o Process ID (PID) para diferenciar os arquivos de log gerados. A formação do nome do arquivo de log obedece a seguinte lei de formação:

tacnd<library>_<PID>.log

Onde <library> pode ser:

• lib (biblioteca nativa)

• csp (biblioteca de integração MS CAPI/CNG)

• p11 (biblioteca de integração PKCS#11)

• jca (biblioteca de integração Java)

Exemplo:

tacndlib_34565.log
tacndlib_42892.log

tacndcsp_24329.log
tacndcsp_17643.log