|
Compatível Países:
|
Todos
|
|
Sistemas Operacionais:
|
Todos
|
|
Compatível às Bases de Dados:
|
Todos
|
|
Nível de Acesso:
|
Nível 1 (Acesso Clientes)
|
|
Idiomas:
|
Português, Inglês, Espanhol
|
|
Versão
|
V12
|
Sintaxe
FWLogMsg(<cSeverity >, [ cTransactionId ], <cGroup >, <cCategory >, <cStep >, <cMsgId >, <cMessage >, <nMensure >, <nElapseTime >, <aMessage >)-> NIL
Descrição
Registra uma mensagem de log com as informações do sistema, conforme padrão SysLog - RFC-5424
Parâmetros
|
Nome
|
Tipo
|
Descrição
|
Default
|
Obrigatório
|
Referência
|
|
cSeverity
|
Caracteres
|
Informe a severidade da mensagem de log. As opções possiveis são: INFO,WARN,ERROR,FATAL,DEBUG
|
|
X
|
|
|
cTransactionId
|
Caracteres
|
Informe o Id de identificação da transação para operações correlatas. Informe "LAST" para o sistema assumir o mesmo id anterior
|
FWUUIDV1()
|
|
|
|
cGroup
|
Caracteres
|
Informe o Id do agrupador de mensagem de Log
|
|
X
|
|
|
cCategory
|
Caracteres
|
Informe o Id da categoria da mensagem
|
|
X
|
|
|
cStep
|
Caracteres
|
Informe o Id do passo da mensagem
|
|
X
|
|
|
cMsgId
|
Caracteres
|
Informe o Id do código da mensagem
|
|
X
|
|
|
cMessage
|
Caracteres
|
Informe a mensagem de log. Limitada à 10K
|
|
X
|
|
|
nMensure
|
Numérico
|
Informe a uma unidade de medida da mensagem
|
|
X
|
|
|
nElapseTime
|
Numérico
|
Informe o tempo decorrido da transação
|
|
X
|
|
|
aMessage
|
Array
|
Informe a mensagem de log em formato de Array
|
|
X
|
|
Observações
Esta API refere-se a padronização da linha Microsiga Protheus sobre a
implementação da API LogMsg da Virtual Machine.
1) O Id do agrupador da mensagem é um código padronizado entre todas as linhas de produto TOTVS e visa indentificar um agrupamento de mensagem relacionadas
2) O Id da categoria da mensagem é uma sub-divisão do Id do agrupador da mensagem e é padronizado entre todas as linhas de produto TOTVS.
3) O Id do passo da mensagem, indica uma etapa de avança de terminada transação que é monitorada. Pode ser ou não padronizada nas linhas de produto.
4) O Id do código do mensagem é padronizado dentro da linha TOTVS
5) A mensagem de log é livre, mas deve ser clara e simples
6) A unidade de medida da mensagem é padronizada entre as linhas de produto TOTVS e visa fornecer um balanço de comparativo de tempo
7) O tempo decorrido visa fornecer um parametro de desempenho do sistema em determinadas operações. Em alguns casos é padronizado.
O log de Debug somente é ativado pela chave no environment FWLOGMSG_DEBUG=1
** Quando o LogServer não esta ativo é escrito no ConsoleLog do AppServer a seguinte estrutura de mensagem:
[Id do Produto][Data e Hora][Severidade][Id da Mensagem][sStrData no padrão SysLog][texto da mensagem]
Veja também