Habilitando logs

Para habilitar os logs, basta setar a variável de ambiente HSM_LOG_LEVEL com um dos valores abaixo:

1 - INFO
2 - WARNING
3 - ERROR
4 - DEBUG

Setando a variável de ambiente via terminal

export HSM_LOG_LEVEL=1
Copy

Setando a variável de ambiente via javascript

process.env.HSM_LOG_LEVEL = "4"; // DEBUG
Copy

Direcionando os logs para um arquivo

Para direcionar os logs para um arquivo, basta setar a variável de ambiente HSM_LOG_DIR com o caminho da pasta onde o arquivo será criado.
Caso essa variável não seja setada, os logs serão direcionados para o console.

Setando a variável de ambiente via terminal

export HSM_LOG_DIR=/var/logs/hsm_logs
Copy

Setando a variável de ambiente via javascript

process.env.HSM_LOG_DIR = "/var/logs/hsm_logs";
Copy

Configuração do Session Pool

O Session Pool gerencia um pool de sessões HSM TCP/TLS para operações concorrentes. Use connectPooled() para obter handles que compartilham o pool automaticamente. O pool é configurado via variáveis de ambiente:

Tamanho do pool

Variável	Padrão	Descrição
HSM_SESSION_POOL_MIN	3	Número mínimo de sessões mantidas ativas. Sessões acima deste mínimo são recicladas após ficarem ociosas.
HSM_SESSION_POOL_MAX	10	Número máximo de sessões simultâneas. Checkouts além deste limite aguardam na fila.

Fila de checkouts

Variável	Padrão	Descrição
HSM_SESSION_POOL_QUEUE_MAX	100	Profundidade máxima da fila. Checkouts além deste limite são rejeitados imediatamente com SessionPoolQueueFullError.
HSM_SESSION_POOL_QUEUE_TIMEOUT_MS	30000	Tempo máximo (ms) que um checkout pode aguardar na fila antes de ser rejeitado com SessionPoolQueueTimeoutError.

Timeout e reciclagem

Variável	Padrão	Descrição
HSM_SESSION_POOL_IDLE_TIMEOUT_MS	60000	Tempo (ms) que uma sessão ociosa acima do mínimo permanece ativa antes de ser reciclada.
HSM_SESSION_POOL_AUTOSCALING_MAX	= MAX	Teto do autoscaler. Define o limite máximo de sessões quando o PoolAutoscaler está ativo.

Hot-reload

Variável	Padrão	Descrição
HSM_SESSION_POOL_CONTROL_PATH	OS-dependent	Caminho do Unix socket (ou named pipe no Windows) para patches de configuração em tempo de execução. Padrão: <tmpdir>/dinamo-hsm-pool.sock (Linux) ou \\.\pipe\dinamo-hsm-pool (Windows).

Exemplo de configuração

export HSM_SESSION_POOL_MIN=5
export HSM_SESSION_POOL_MAX=20
export HSM_SESSION_POOL_QUEUE_MAX=200
export HSM_SESSION_POOL_QUEUE_TIMEOUT_MS=60000
export HSM_SESSION_POOL_IDLE_TIMEOUT_MS=120000
Copy

process.env.HSM_SESSION_POOL_MIN = "5";
process.env.HSM_SESSION_POOL_MAX = "20";
process.env.HSM_SESSION_POOL_QUEUE_MAX = "200";
process.env.HSM_SESSION_POOL_QUEUE_TIMEOUT_MS = "60000";
process.env.HSM_SESSION_POOL_IDLE_TIMEOUT_MS = "120000";
Copy

Configuração do Native Host Pool

As operações de rede PIX (PIXPost, PIXPut, PIXGet, PIXDelete) delegam o handshake mTLS e a comunicação HTTP a um pool de processos nativos (dinamonh). O pool é configurado via variáveis de ambiente:

Tamanho do pool

Variável	Padrão	Descrição
HSM_NATIVE_HOST_POOL_MIN	3	Número mínimo de conexões mantidas ativas. Conexões acima deste mínimo são recicladas após ficarem ociosas.
HSM_NATIVE_HOST_POOL_MAX	10	Número máximo de conexões simultâneas. Tarefas além deste limite aguardam na fila.

Fila de tarefas

Variável	Padrão	Descrição
HSM_NATIVE_HOST_QUEUE_MAX	100	Profundidade máxima da fila. Tarefas além deste limite são rejeitadas imediatamente com NativeHostQueueFullError.
HSM_NATIVE_HOST_QUEUE_TIMEOUT_MS	30000	Tempo máximo (ms) que uma tarefa pode aguardar na fila antes de ser rejeitada com NativeHostQueueTimeoutError.

Timeout e resiliência

Variável	Padrão	Descrição
HSM_NATIVE_HOST_IDLE_TIMEOUT_MS	60000	Tempo (ms) que uma conexão ociosa acima do mínimo permanece ativa antes de ser reciclada.
HSM_NATIVE_HOST_WATCHDOG_MARGIN_MS	2000	Margem de graça (ms) adicionada ao timeoutMs da tarefa antes do watchdog encerrar a conexão.
HSM_NATIVE_HOST_BACKOFF_BASE_MS	1000	Delay base (ms) para o backoff exponencial após crash de uma conexão. Dobra a cada crash consecutivo.
HSM_NATIVE_HOST_BACKOFF_MAX_MS	30000	Teto (ms) do backoff exponencial de uma conexão com crashes repetidos.

Caminho do binário

Variável	Padrão	Descrição
HSM_NATIVE_HOST_PATH	dinamonh	Caminho absoluto ou relativo para o binário dinamonh. Se não estiver no PATH, defina o caminho completo.

Exemplo de configuração

export HSM_NATIVE_HOST_POOL_MIN=5
export HSM_NATIVE_HOST_POOL_MAX=20
export HSM_NATIVE_HOST_QUEUE_MAX=200
export HSM_NATIVE_HOST_QUEUE_TIMEOUT_MS=60000
export HSM_NATIVE_HOST_PATH=/opt/dinamo/bin/dinamonh
Copy

process.env.HSM_NATIVE_HOST_POOL_MIN = "5";
process.env.HSM_NATIVE_HOST_POOL_MAX = "20";
process.env.HSM_NATIVE_HOST_QUEUE_MAX = "200";
process.env.HSM_NATIVE_HOST_QUEUE_TIMEOUT_MS = "60000";
process.env.HSM_NATIVE_HOST_PATH = "/opt/dinamo/bin/dinamonh";
Copy