Versão: 20 R7 BETA

Arquivo de histórico

Aplicações 4D podem gerar vários arquivos de histórico ou log que são úteis para depuração e otimizar sua execução. Os logs geralmente são iniciados ou parados usando seletores dos comandos SET DATABASE PARAMETER, WEB SET OPTION, ou HTTP SET OPTION e são armazenados na pasta Logs do projeto.

Informação gravada precisa ser analisada para detectar e corrigir os problemas. Esta seção oferece uma descrição detalhada dos arquivos de log abaixo:

4DRequestsLog.txt
4DRequestsLog_ProcessInfo.txt
HTTPDebugLog.txt
4DHTTPClientLog.txt
4DDebugLog.txt (standard & tabular)
4DDiagnosticLog.txt
4DIMAPLog.txt
4DPOP3Log.txt
4DSMTPLog.txt
ORDA requests log file

Nota: quando um arquivo de histórico for gerado seja em 4D Server ou em cliente remoto, a palavra "Server" é adicionada ao nome do arquivo do lado servidor, por exemplo "4DRequestsLogServer.txt"

Arquivos de Histórico compartilham alguns campos para que possa estabelecer uma cronologia e fazer conexões entre entradas quando depurar:

sequence_number: esse número é exclusivo em todos os logs de depuração e é incrementado para cada nova entrada, seja qual for o arquivo de log, para que você possa saber a sequência exata das operações.
connection_uuid: para cada proceso 4D creado en un cliente 4D que se conecte a un servidor, este UUID de conexión se registra tanto del lado del servidor como del cliente. Permite que facilmente identifique o cliente remoto que lança cada processo.

4DRequestsLog.txt

Esses arquivos de histórico gravam petições normais realizadas pela máquina 4D Server ou a máquina remota 4D que executaram o comando (excluindo petições Web).

Como iniciar esse log:

no servidor:

SET DATABASE PARAMETER(4D Server log recording;1)
//lado servidor

em um cliente:

SET DATABASE PARAMETER(Client Log Recording;1)
//lado remoto

Essa instrução também inicia o arquivo de registro 4DRequestsLog_ProcessInfo.txt.

Cabeçalhos

Este arquivo começa com os cabeçalhos abaixo:

Identificador de sessão de histórico
Hostname do servidor que hospeda a aplicação
Nome login Usuário: login do SO do usuário que roda a aplicação 4D no servidor.

Conteúdos

Para cada petição, os campos abaixo estão logados:

Campo nome	Descrição
sequence_number	Número de operação único e sequencial da sessão de histórico
time	Data e hora usando formato ISO 8601: 'YYYY-MM-DDTHH:MM:SS.mmm'
systemid	ID de sistema
componente	Assinatura de componente (por exemplo '4SQLS' ou 'dbmg')
processinfo	index Corresponds to the "index" field in 4DRequestsLog_ProcessInfo.txt log, and permits linking a request to a process.
request	ID da petição C/S u ORDA ou mensagem para as solicitações SQL ou mensagens `LOG EVENT`
bytes_in	Número de bytes recebidos
bytes_out	Número de bytes enviados
server_duration \| exec_duration	Depende de onde o registro é gerado: server_duration quando gerado no cliente --Tempo gasto em microssegundos para que o servidor processe a solicitação e retorne uma resposta. B to F in image below, OR exec_duration when generated on the server --Time taken in microseconds for the server to process the request. B a E na imagem abaixo.
write_duration	Tempo em microssegundos para enviar a: Solicitação (quando executado no cliente). A to B in image below. Response (when run on the server). E a F na imagem abaixo.
task_kind	Preemptivo ou cooperativo (respectivamente 'p' ou 'c')
rtt	Tempo estimado em microssegundos para o cliente enviar a petição e o servidor para reconhecê-la. De A a D e de E a H na imagem abaixo. Somente medido ao usar a camada de rede ServerNet, retorna 0 quando usado com a camada de rede legada. Para as versões de Windows anteriores a Windows 10 ou Windows Server 2016, a chamada retornará 0.
extra	Informações adicionais relacionadas com o contexto, por exemplo, nome da classe de dados e/ou nome do atributo no caso de um pedido ORDA

Fluxo de petição:

4DRequestsLog_ProcessInfo.txt

Este arquivo de histórico registra a informação em cada processo criado na máquina 4D Server ou na máquina remota 4D que executa o comando (excluindo petições Web).

Como iniciar esse log:

no servidor:

SET DATABASE PARAMETER(4D Server log recording;1) //lado servidor

em um cliente:

SET DATABASE PARAMETER(Client Log Recording;1) //lado remoto

Essa instrução também inicia o arquivo de registro 4DRequestsLog.txt.

Cabeçalhos

Este arquivo começa com os cabeçalhos abaixo:

Identificador de sessão de histórico
Hostname do servidor que hospeda a aplicação
Nome login Usuário: login do SO do usuário que roda a aplicação 4D no servidor.

Conteúdos

Para cada processo, os campos abaixo são registrados:

Campo nome	Descrição
sequence_number	Número de operação único e sequencial da sessão de histórico
time	Hora e data usando o formato ISO 8601 format: "YYYY-MM-DDTHH:MM:SS.mmm"
process_info_index	Número de processo único e sequencial
CDB4DBaseContext	DB4D contexto de componente database UUID
systemid	ID de sistema
server_process_id	ID de processo no servidor
remote_process_id	Id de processo no cliente
process_name	Nome de processo
cID	Identificador de conexão 4D
uID	Identificador de Cliente 4D
IP Client	IPv4/IPv6アドレス
host_name	Hostname do cliente
user_name	Nome de login de usuário no cliente
connection_uuid	Identificador UUID da conexão de processo
server_process_unique_id	ID de Processo único em Servidor

HTTPDebugLog.txt

Este arquivo registra cada petição HTTP e cada resposta em modo raw (não processado). Petições inteiras, incluindo cabeçalhos, são registradas; opcionalmente, partes do corpo podem ser registradas também.

Como iniciar esse log:

WEB SET OPTION(Web debug log;wdl enable without body)  
//outros valores estão disponíveis

Os campos abaixo são registrados tanto para Request quanto para Response:

Campo nome	Descrição
SocketID	ID da socked usada para comunicação
PeerIP	Endereço IPv4 do host (cliente)
PeerPort	Porta usada por host (cliente)
TimeStamp	Timestamp em milisegundos (desde início sistema)
ConnectionID	Connection UUID (UUID de VTCPSocket usada para comunicação)
SequenceNumber	Número de operação único e sequencial da sessão de histórico

4DHTTPClientLog.txt

Este arquivo de histórico registra o tráfego HTTP que passa pelo cliente HTTP do 4D. Whole requests and responses, including headers, are logged; optionally, body parts can be logged as well.

Como iniciar esse log:

HTTP SET OPTION(HTTP client log; HTTP enable log with all body parts)  
//outros valores estão disponíveis

Os campos abaixo são registrados tanto para Request quanto para Response:

Campo nome	Descrição
SequenceID	Número de operação único e sequencial da sessão de histórico
ConnectionID	Identificador UUID da conexão de processo
LocalIP	Endereço IP do Cliente
PeerIP	Endereço IP do servidor
TimeStamp	Timestamp (ms) at the time the request is sent or the response is fully received
ElapsedTimeInMs	(response only) Difference with the request timestamp

Depending on log options, various other fields can also be logged.

Para solicitação: linha de solicitação, cabeçalhos, corpo da solicitação
Para resposta: linha de estado, cabeçalhos, corpo da resposta (não compactado), se houver

4DDebugLog.txt (standard)

Esses registros de histórico gravam cada evento que ocorreu ao nível de programação de 4D. Modo padrão oferece uma vista básica de eventos.

Como iniciar esse log:

SET DATABASE PARAMETER(Debug Log Recording;2)  
//standard, all processes SET DATABASE PARAMETER(Current process debug log recording;2)  
//standard, current process only

Os campos abaixo estão registrados para cada evento:

Coluna #	Descrição
1	Número de operação único e sequencial da sessão de histórico
2	Data e hora em formato ISO 8601 (YYYY-MM-DDThh:mm:ss.mmm)
3	ID de processo (p=xx) e ID de processo único (puid=xx)
4	Nível de stack
5	Pode ser Command Name/ Method Name/Message/ Task Start Stop info/Plugin Name, event ou Callback/Connection UUID
6	Tempo que leva para a operação de histórico em milissegundos

4DDebugLog.txt (tabular)

Esse arquivo de histórico registra cada evento que ocorrer ao nível de programação 4D em um formato tabulado e compacto que inclui informação adicional (comparado ao formato padrão).

Como iniciar esse log:

SET DATABASE PARAMETER(Debug Log Recording;2+4)  
//extended tabbed format, all processes SET DATABASE PARAMETER(Current process debug log recording;2+4)  
//extended, current process only

Os campos abaixo estão registrados para cada evento:

Coluna #	Campo nome	Descrição
1	sequence_number	Número de operação único e sequencial da sessão de histórico
2	time	Data e hora em formato ISO 8601 (YYYY-MM-DDThh:mm:ss.mmm)
3	ProcessID	Process ID
4	unique_processID	ID de processo
5	stack_level	Nível de stack
6	operation_type	Tipo operação histórico. Esse valor pode ser um valor absoluto: Comando Método (método projeto, método banco de dados, etc.) Mensagem (enviada somente pelo comando LOG EVENT) PluginMessage PluginEvent PluginCommand PluginCallback Task Método membro (método anexado a uma coleção ou a um objeto) Ao fechar um nível de pilha, as colunas `operation_type`, `operation` e `operation_parameters` têm o mesmo valor que o nível de pilha de abertura registrado na coluna `stack_opening_sequence_number`. For example: 121 15:16:50:777 5 8 1 2 CallMethod Parameters 0 122 15:16:50:777 5 8 2 1 283 0 123 15:16:50:777 5 8 2 1 283 0 122 3 124 15:16:50:777 5 8 1 2 CallMethod Parameters 0 121 61 The 1st and 2nd lines open a stack level, the 3rd and 4th lines close a stack level. Valores nas colunas 6, 7 e 8 são repetidos na linha do nível de stack ao fechar. A coluna 10 contém os números de sequência de abertura do nível de stack, ou seja, 122 para a terceira linha e 121 para a quarta.
7	operation	Pode representar (dependendo do tipo de operação) :a ID do comando de linguagem (quando tipo=1) a Nome do método (quando tipo=2) uma combinação de pluginIndex;pluginCommand (quando tipo=4, 5, 6 ou 7). May contain something like '3;2' a Task Connection UUID (when type=8)
8	operation_parameters	Parâmetros passados a comandos, métodos ou plugins
9	form_event	Evento formulário se houver: vazio em outros casos (suponha que a coluna é usada quando o código for executado em um método formulário ou método objeto)
10	stack_opening_sequence_number	Só para níveis stack fechamento: número sequencia do nível correspondente de abertura de stack
11	stack_level_execution_time	Só para níveis de stack de fechamento: tempo decorrido em microssegundos da ação de histórico atual; só para os níveis de stack de fechamento (ver décima coluna em linhas 123 e 124 no histórico acima)

4DDiagnosticLog.txt

Esse arquivo registra vários eventos relacionados à operação de aplicação e sua leitura humana. Você pode incluir informações personalizadas nesse arquivo usando o comando LOG EVENT.

Como iniciar esse log:

 SET DATABASE PARAMETER(Diagnostic log recording;1) //começa o registro

Os campos abaixo estão registrados para cada evento:

Nome de campo	Descrição
sequenceNumber	Número de operação único e sequencial da sessão de histórico
timestamp	Data e hora em formato ISO 8601 (YYYY-MM-DDThh:mm:ss.mmm)
loggerID	Opcional
componentSignature	Opcional - assinatura interna de componente
messageLevel	Informação, Aviso, Erro
message	Descrição da entrada de histórico

Dependendo do evento, vários outros campos podem ser registrados, como task, socket, etc.

Níveis de registo de diagnóstico

O arquivo 4DDiagnosticLog.txt pode registrar diferentes níveis de mensagens, de ERROR (mais importante) a TRACE (menos importante). Por padrão, o nível INFO é definido, o que significa que o arquivo registrará apenas eventos importantes, incluindo erros e resultados inesperados (veja abaixo).

Pode selecionar o nível das mensagens utilizando o seletor Diagnostic log level do comando SET DATABASE PARAMETER , consoante as suas necessidades. Quando se selecciona um nível, os níveis acima (que são mais importantes) são implicitamente seleccionados também. Estão disponíveis os seguintes níveis:

Parâmetros	Descrição	Quando seleccionado, inclui
`Log error`	Uma parte da aplicação não funciona	`Log error`
`Log warn`	Erro potencial, utilização de uma função obsoleta, má utilização, situação indesejável ou inesperada	`Log error`, `Log warn`
`Log info`	*Nível padrão - Evento de aplicação importante	`Log error`, `Log warn`, `Log info`
`Log debug`	Detalhe do fluxo de aplicação (para serviços técnicos 4D)	`Log error`, `Log warn`, `Log info`, `Log debug`
`Log trace`	Outras informações internas (para serviços técnicos 4D)	`Log error`, `Log warn`, `Log info`, `Log debug`, `Log trace`

Exemplo:

SET DATABASE PARAMETER (Diagnostic log recording; 1)
SET DATABASE PARAMETER (Diagnostic log level; Log trace)

4DSMTPLog.txt, 4DPOP3Log.txt, e 4DIMAPLog.txt

Esses históricos registram cada troca entre a aplicação 4D e o servidor de mail (SMTP, POP3, IMAP) que foram iniciados pelos comandos abaixo:

Os arquivos de histórico podem ser produzidos em duas versões:

uma versão comum:
- chamada 4DSMTPLog.txt, 4DPOP3Log.txt, ou 4DIMAPLog.txt
- sem anexos
- usa um arquivo circular automático que é reciclado a cada 10MB
- para depurações comuns

Para começar esse histórico:

SET DATABASE PARAMETER(SMTP Log;1) //inicia SMTP log
SET DATABASE PARAMETER(POP3 Log;1) //inicia POP3 log
SET DATABASE PARAMETER(IMAP Log;1) //inicia IMAP log

4D Server: Clique no botão Start Request and Debug Logs na [Página de manutenção] (ServerWindow/maintenance.md) da janela de administração do 4D Server.

Esta rota do histórico é retornada pelo comando Get 4D file.

uma versão estendida:
- attachment(s) included no automatic recycling
- nome personalizado
- guardado para propósitos específicos

Para começar esse histórico:

$server:=New object
...
//SMTP
$server.logFile:="MySMTPAuthLog.txt"
$transporter:=SMTP New transporter($server)

// POP3
$server.logFile:="MyPOP3AuthLog.txt"
$transporter:=POP3 New transporter($server)

//IMAP
$server.logFile:="MyIMAPAuthLog.txt"
$transporter:=IMAP New transporter($server)

Conteúdos

Para cada petição, os campos abaixo estão logados:

Coluna #	Descrição
1	Número de operação único e sequencial da sessão de histórico
2	Data e hora em formato RFC3339 (yyyy-mm-ddThh:mm:ss.ms)
3	ID de 4D Process
4	ID de processo
5	Informações de inicialização da sessão SMTP, POP3 ou IMAP, incluindo o nome do host do servidor, o número da porta TCP usada para se conectar ao servidor SMTP, POP3 ou IMAP e o status do TLS; ou dados trocados entre o servidor e o cliente, começando com "S <" (data received from the SMTP,POP3, or IMAP server) or "C >" (dados enviados pelo cliente SMTP, POP3 ou IMAP): lista de modos de autenticação enviada pelo servidor e modo de autenticação selecionado, qualquer erro relatado pelo servidor SMTP, POP3 ou IMAP, informações de cabeçalho do e-mail enviado (somente versão padrão) e se o e-mail foi salvo no servidor, ou informações de fechamento de sessão SMTP, POP3 ou IMAP.

Pedidos ORDA

Os registos de pedidos ORDA podem registar cada pedido ORDA e a resposta do servidor. Estão disponíveis dois registos de pedidos ORDA:

um registo de pedidos ORDA do lado do cliente, em formato .txt
um registo de pedidos ORDA do lado do servidor, em formato .jsonl

Do lado do cliente

O registo ORDA do lado do cliente regista cada pedido ORDA enviado a partir de uma máquina remota. Pode direcionar as informações de registo para a memória ou para um arquivo .txt no disco da máquina remota. O nome e rota desse arquivo pode ser escolhido.

Como iniciar esse log:

	//numa máquina remota
SET DATABASE PARAMETER(Client Log Recording;1)  
ds.startRequestLog(File("/PACKAGE/Logs/ordaLog.txt")) 
	//pode também ser enviado para a memória
SET DATABASE PARAMETER(Client Log Recording;0)  

nota

Não é obrigatório acionar o [4DRequestsLog.txt] (#4drequestslogtxt) do lado do cliente usando SET DATABASE PARAMETER. No entanto, é necessário se pretender registar o campo único sequenceNumber.

Os campos abaixo são registrados para cada petição:

Campo nome	Descrição	Exemplo
sequenceNumber	Número de operação único e sequencial da sessão de histórico	104
url	Solicitar URL	"rest/Persons(30001)"
startTime	Data e hora de início utilizando o formato ISO 8601	"2019-05-28T08:25:12.346Z"
endTime	Data e hora final usando formato ISO 8601	"2019-05-28T08:25:12.371Z"
duration	Duração do processamento do cliente em milissegundos (ms)	25
response	Objeto resposta servidor	{"status":200,"body":{"__entityModel":"Persons",[...]

Exemplo

Eis um exemplo de um registo de ficheiro de registo ORDA do lado do cliente:

	{
		"sequenceNumber": 7880,
		"url": "rest/Employees/$entityset/F910C2E4A2EE6B43BBEE74A0A4F68E5A/Salary?$compute='sum'&$progress4Dinfo='D0706F1E77D4F24985BE4DDE9FFA1739'",
		"startTime": "2023-05-15T10:43:39.400Z",
		"endTime": "2023-05-15T10:43:39.419Z",
		"duration": 19,
		"response": {
			"status": 200,
			"body": 75651
		}
	}

Do lado do servidor

O registo ORDA do lado do servidor regista cada pedido ORDA processado pelo servidor, bem como a resposta do servidor (opcional). As informações de registro são salvas em um arquivo .jsonl no disco da máquina do servidor (por padrão, ordaRequests.jsonl).

Como iniciar esse log:

//no servidor
SET DATABASE PARAMETER(4D Server log recording;1)
ds.startRequestLog(File("/PACKAGE/Logs/ordaRequests.jsonl");srl log response without body) 
 //O parâmetro srl é opcional 
SET DATABASE PARAMETER(4D Server log recording;0)

nota

Não é obrigatório acionar o 4DRequestsLog.txt do lado do servidor usando SET DATABASE PARAMETER. No entanto, é necessário se você deseja registrar os campos únicos sequenceNumber e duration.

Os campos abaixo são registrados para cada petição:

Campo nome	Descrição	Exemplo
sequenceNumber	Número de operação único e sequencial da sessão de histórico	104
url	Solicitar URL	"rest/Persons(30001)"
startTime	Data e hora de início utilizando o formato ISO 8601	"2019-05-28T08:25:12.346Z"
duration	Duração do processamento do servidor em microssegundos (µ)	2500
response	Objeto de resposta do servidor, pode ser configurado em `.startRequestLog()`	{"status":200,"body":{"__entityModel":"Persons",[...]
ipAddress	Endereço IP do usuário	"192.168.1.5"
userName	Nome do usuário 4D	"henry"
systemUserName	Nome de login do usuário na máquina	"hsmith"
machineName	Nome da máquina do utilizador	"PC of Henry Smith"

Exemplo

Eis um exemplo de um registo de registo ORDA do lado do servidor:

   {
		"url": "rest/Employees/$entityset/F910C2E4A2EE6B43BBEE74A0A4F68E5A/Salary?$compute='sum'&$progress4Dinfo='D0706F1E77D4F24985BE4DDE9FFA1739'",
		"systemUserName": "Admin",
		"userName": "Designer",
		"machineName": "DESKTOP-QSK9738",
		"taskID": 5,
		"taskName": "P_1",
		"startTime": "2023-05-15T11:43:39.401",
		"response": {
			"status": 200,
			"body": 75651
		},
		"sequenceNumber": 7008,
		"duration": 240
	}

Utilizar um ficheiro de configuração de log

Você pode usar um arquivo de configuração de log para gerenciar facilmente a gravação de logs em um ambiente de produção. Este arquivo é pré-configurado pelo programador. Normalmente, pode ser enviado aos clientes para que estes apenas tenham de o selecionar ou copiar para uma pasta local. Uma vez ativado, o arquivo de configuração de registos desencadeia a gravação de registos específicos.

Como activar o arquivo

Existem várias formas de ativar o arquivo de configuração do registo, dependendo da sua configuração:

Servidor 4D com interface: você pode abrir a página Manutenção e clicar no botão Carregar arquivo de configuração dos registos, depois selecionar o arquivo. Neste caso, pode utilizar qualquer nome para o arquivo de configuração. É imediatamente ativado no servidor.
um projeto interpretado ou compilado: o arquivo deve ter o nome logConfig.json e ser copiado para a pasta Settings do projeto (situada ao mesmo nível que a pasta Project). É ativado no arranque do projeto (apenas no servidor em cliente/servidor).
uma aplicação construída: o arquivo deve ter o nome logConfig.json e ser copiado para a pasta seguinte:
- Windows: Users\[userName]\AppData\Roaming\[application]
- macOS: /Users/[userName]/Library/ApplicationSupport/[application]
todos os projetos com um 4D autônomo ou remoto: o arquivo deve chamar-se logConfig.json e ser copiado para a pasta seguinte:
- Windows: Users\[userName]\AppData\Roaming\4D
- macOS: /Users/[userName]/Library/ApplicationSupport/4D
todos os projetos com 4D Server: o arquivo deve ser nomeado logConfig.json e copiado para a seguinte pasta:
- Windows: Users\[userName]\AppData\Roaming\4D Server
- macOS: /Users/[userName]/Library/ApplicationSupport/4D Server

nota

Se um arquivo logConfig.json estiver instalado nas pastas Settings e AppData/Library, o arquivo da pasta Settings terá prioridade.

Descrição do ficheiro JSON

O arquivo de configuração do registo é um arquivo .json que deve estar em conformidade com o seguinte esquema json:

{
    "$schema": "http://json-schema.org/draft-07/schema",
    "title": "Logs Configuration File",
    "description": "A file that controls the state of different types of logs in 4D clients and servers",
    "type": "object",
    "properties": {
        "forceConfiguration": {
            "description": "Forcing the logs configuration described in the file ingoring changes coming from code or user interface",
            "type": "boolean",
            "default": true
        },
        "requestLogs": {
            "description": "Configuration for request logs",
            "type": "object",
            "properties": {
                "clientState": {
                    "description": "Enable/Disable client request logs (from 0 to N)",
                    "type": "integer",
                    "minimum": 0
                },
                "serverState": {
                    "description": "Enable/Disable server request logs (from 0 to N)",
                    "type": "integer",
                    "minimum": 0
                }
            }
        },
        "debugLogs": {
            "description": "Configuration for debug logs",
            "type": "object",
            "properties": {
                "commandList": {
                    "description": "Commands to log or not log",
                    "type": "array",
                    "items": {
                        "type": "string"
                    },
                    "minItems": 1,
                    "uniqueItems": true
                },
                "state": {
                    "description": "integer to specify type of debuglog and options",

                    "type": "integer",
                    "minimum": 0
                }
            }
        },
        "diagnosticLogs":{
            "description": "Configuration for debug logs",
            "type": "object",
            "properties": {
                "state":{
                    "description": "Enable/Disable diagnostic logs 0 or 1 (0 = do not record, 1 = record)",
                    "type": "integer",
                    "minimum": 0    
                },
                "level": {
              "description": "Configure diagnostic logs",
              "type": "integer",
              "minimum": 2,
              "maximum": 6
          }
            }
          },
        "httpDebugLogs": {
            "description": "Configuration for http debug logs",
            "type": "object",
            "properties": {
                "level": {
                    "description": "Configure http request logs",
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 7
                },
                "state": {
                    "description": "Enable/Disable recording of web requests",
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 4
                }
            }
        },
        "HTTPClientLogs": {
		     "description": "Configuration for http client logs",
		     "type": "object",
		     "properties": {
		          "state": {
		               "description": "Configure http client logs",
		               "type": "integer",
		               "minimum": 0,
		               "maximum": 7
		          },
		     }
		},
        "POP3Logs": {
            "description": "Configuration for POP3 logs",
            "type": "object",
            "properties": {
                "state": {
                    "description": "Enable/Disable POP3 logs (from 0 to N)",
                    "type": "integer",
                    "minimum": 0
                }
            }
        },
        "SMTPLogs": {
            "description": "Configuration for SMTP logs",
            "type": "object",
            "properties": {
                "state": {
                    "description": "Enable/Disable SMTP log recording (from 0 to N)",
                    "type": "integer",
                    "minimum": 0
                }
            }
        },
        "IMAPLogs": {
            "description": "Configuration for IMAP logs",
            "type": "object",
            "properties": {
                "state": {
                    "description": "Enable/Disable IMAP log recording (from 0 to N)",
                    "type": "integer"
                }
            }
        },
        "ORDALogs": {
            "description": "Configuration for ORDA logs",
            "type": "object",
            "properties": {
                "state": {
                    "description": "Enable/Disable ORDA logs (0 or 1)",
                    "type": "integer"
                },
                "filename": {
                    "type": "string"
                }
            }
        }
    }
}

nota

The "state" property values are described in the corresponding commands: [WEB SET OPTION](../commands-legacy/web-set-option.md) (Web log recording), [HTTP SET OPTION](../commands-legacy/http-set-option.md) (HTTP client log), [SET DATABASE PARAMETER](../commands-legacy/set-database-parameter.md) (Client Web log recording, IMAP Log`,...).
For httpDebugLogs, the "level" property corresponds to the wdl constant options described in the WEB SET OPTION command.
For diagnosticLogs, the "level" property corresponds to the Diagnostic log level constant values described in the SET DATABASE PARAMETER command.

Exemplo

Aqui está um exemplo de arquivo de configuração de log:

{
 "forceLoggingConfiguration": false,
 "requestLogs": {
  "clientState": 1,
  "serverState": 1
 },
 "debugLogs": {
  "commandList":["322","311","112"],
        "state": 4
 },
 "diagnosticLogs":{
        "state" : 1
 },
 "httpDebugLogs": {
  "level": 5,
        "state" : 1
 },
 "POP3Logs": {
        "state" : 1
 },
 "SMTPLogs": {
        "state" : 1
 },
 "IMAPLogs": {
        "state" : 1

 },
 "ORDALogs": {
        "state" : 1,
  "filename": "ORDALog.txt"
 }
}

4DRequestsLog.txt​

Cabeçalhos​

Conteúdos​

4DRequestsLog_ProcessInfo.txt​

Cabeçalhos​

Conteúdos​

HTTPDebugLog.txt​

4DHTTPClientLog.txt​

4DDebugLog.txt (standard)​

4DDebugLog.txt (tabular)​

4DDiagnosticLog.txt​

Níveis de registo de diagnóstico​

4DSMTPLog.txt, 4DPOP3Log.txt, e 4DIMAPLog.txt​

Conteúdos​

Pedidos ORDA​

Do lado do cliente​

Exemplo​

Do lado do servidor​

Exemplo​

Utilizar um ficheiro de configuração de log​

Como activar o arquivo​

Descrição do ficheiro JSON​

Exemplo​

4DRequestsLog.txt

Cabeçalhos

Conteúdos

4DRequestsLog_ProcessInfo.txt

Cabeçalhos

Conteúdos

HTTPDebugLog.txt

4DHTTPClientLog.txt

4DDebugLog.txt (standard)

4DDebugLog.txt (tabular)

4DDiagnosticLog.txt

Níveis de registo de diagnóstico

4DSMTPLog.txt, 4DPOP3Log.txt, e 4DIMAPLog.txt

Conteúdos

Pedidos ORDA

Do lado do cliente

Exemplo

Do lado do servidor

Exemplo

Utilizar um ficheiro de configuração de log

Como activar o arquivo

Descrição do ficheiro JSON

Exemplo