Descripción de los archivos históricos
Las aplicaciones 4D pueden generar varios archivos de historial que son útiles para depurar u optimizar su ejecución. Los historiales suelen iniciarse o detenerse utilizando selectores de los comandos SET DATABASE PARAMETER o WEB SET OPTION y se almacenan en la carpeta Logs folder del proyecto.
La información histórica debe ser analizada para detectar y solucionar los problemas. Esta sección ofrece una descripción completa de los siguientes archivos de registro:
- 4DRequestsLog.txt
- 4DRequestsLog_ProcessInfo.txt
- HTTPDebugLog.txt
- 4DDebugLog.txt (standard & tabular)
- 4DDiagnosticLog.txt
- 4DIMAPLog.txt
- 4DPOP3Log.txt
- 4DSMTPLog.txt
- Archivo de historial de peticiones ORDA clientes
Nota: cuando un archivo de historial puede generarse tanto en 4D Server como en el cliente remoto, se añade la palabra "Server" al nombre del archivo de historial del lado del servidor, por ejemplo "4DRequestsLogServer.txt"
Los archivos de historial comparten algunos campos para que pueda establecer una cronología y hacer conexiones entre las entradas mientras depura:
sequence_number: este número es único en todos los registros de depuración y se incrementa para cada nueva entrada cualquiera que sea el archivo de historial, para que pueda conocer la secuencia exacta de las operaciones.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 identificar fácilmente el cliente remoto que lanzó cada proceso.
4DRequestsLog.txt
Este archivo de historial registra las solicitudes estándar llevadas a cabo por la máquina 4D Server o la máquina remota 4D que ejecutó el comando (excluyendo las solicitudes web).
Como iniciar este historial:
- en el servidor:
SET DATABASE PARAMETER(4D Server log recording;1)
//del lado del servidor
- en un cliente:
SET DATABASE PARAMETER(Client Log Recording;1)
//del lado remoto
Esta instrucción también inicia el archivo de historial 4DRequestsLog_ProcessInfo.txt.
Encabezados
Este archivo comienza con los siguientes encabezados:
- Log Session Identifier (Identificador de sesión de historial)
- Nombre del servidor que aloja la aplicación
- Nombre de usuario: nombre de usuario en el sistema operativo que ejecutó la aplicación 4D en el servidor.
Contenido
Para cada petición, se registran los siguientes campos:
| Nombre del campo | Descripción |
|---|---|
| sequence_number | Número de operación único y secuencial en la sesión de historial |
| time | Fecha y hora utilizando el formato ISO 8601: 'YYYY-MM-DDTHH:MM:SS.mmm' |
| systemid | ID del sistema |
| component | Firma del componente (por ejemplo, "4SQLS" o "dbmg") |
| process_info_ | corresponde al campo "index" en el archivo de historial 4DRequestsLog_ProcessInfo.txt, y permite vincular una petición a un proceso. |
| request | ID de petición en modo remoto cadena de mensajes para las peticiones SQL o mensajes LOG EVENT |
| bytes_in | Número de bytes recibidos |
| bytes_out | Número de bytes enviados |
| server_duration | exec_duration | Depende de dónde se genere el registro: |
| write_duration | Tiempo de envío en microsegundos: |
| task_kind | Apropiativo o cooperativo (respectivamente "p" o "c") |
| rtt | Tiempo estimado en microsegundos para que el cliente envíe la solicitud y el servidor la acuse de recibo. De la A a la D y de la E a la H en la imagen de abajo. |
Flujo de solicitudes:
4DRequestsLog_ProcessInfo.txt
Este archivo de historial registra la información de cada proceso creado en la máquina 4D Server o en la máquina remota 4D que ejecutó el comando (excluyendo las solicitudes web).
Como iniciar este historial:
- en el servidor:
SET DATABASE PARAMETER(4D Server log recording;1) //lado servidor
- en un cliente:
SET DATABASE PARAMETER(Client Log Recording;1) //del lado remoto
Esta instrucción también inicia el archivo de historial 4DRequestsLog.txt.
Encabezados
Este archivo comienza con los siguientes encabezados:
- Log Session Identifier (Identificador de sesión de historial)
- Nombre del servidor que aloja la aplicación
- Nombre de usuario: nombre de usuario en el sistema operativo que ejecutó la aplicación 4D en el servidor.
Contenido
Para cada proceso, se registran los siguientes campos:
| Nombre del campo | Descripción |
|---|---|
| sequence_number | Número de operación único y secuencial en la sesión de historial |
| time | Fecha y hora utilizando el formato ISO 8601: 'YYYY-MM-DDTHH:MM:SS.mmm" |
| process_info_index | Número de proceso único y secuencial |
| CDB4DBaseContext | UUID del contexto de base del componente DB4D |
| systemid | ID del sistema |
| server_process_id | ID del proceso en el servidor |
| remote_process_id | ID del proceso en el cliente |
| process_name | Nombre del proceso |
| cID | Identificador de la conexión 4D |
| uID | Identificador del cliente 4D |
| IP Client | Dirección IPv4/IPv6 |
| host_name | Nombre de host del cliente |
| user_name | Nombre de conexión usuario en el cliente |
| connection_uuid | Identificador UUID de proceso de conexión |
| server_process_unique_id | ID único del proceso en el servidor |
HTTPDebugLog.txt
Este archivo de historial registra cada petición HTTP y cada respuesta en modo bruto (raw). Se registran las solicitudes completas, incluidos los encabezados; opcionalmente, también se pueden registrar las partes del cuerpo.
Como iniciar este historial:
WEB SET OPTION(Web debug log;wdl enable without body)
//otros valores están disponibles
Los siguientes campos se registran tanto para la solicitud como para la respuesta:
| Nombre del campo | Descripción |
|---|---|
| SocketID | ID del socket utilizado para la comunicación |
| PeerIP | Dirección IPv4 del host (cliente) |
| PeerPort | Puerto utilizado por host (cliente) |
| TimeStamp | Timestamp en milisegundos (desde el inicio del sistema) |
| ConnectionID | Conexión UUID (UUID del VTCPSocket utilizado para la comunicación) |
| SequenceNumber | Número de operación único y secuencial en la sesión de historial |
4DDebugLog.txt (estándar)
Este archivo de historial registra cada evento que se produce a nivel de programación 4D. El modo estándar ofrece una visión básica de los eventos.
Como iniciar este historial:
SET DATABASE PARAMETER(Debug Log Recording;2)
//estándar, todos los procesos
SET DATABASE PARAMETER(Current process debug log recording;2)
//estándar, sólo el proceso actual
Los siguientes campos se registran para cada evento:
| Columna # | Descripción |
|---|---|
| 1 | Número de operación único y secuencial en la sesión de historial |
| 2 | Fecha y hora en el formato ISO 8601: (YYYY-MM-DDThh:mm:ss.mmm) |
| 3 | ID proceso (p=xx) e ID único proceso (puid=xx) |
| 4 | Nivel de stack |
| 5 | Puede ser Nombre del comando/Nombre del método/Mensaje/Información de inicio y parada de la tarea/Nombre, evento o callback plugin / UUID conexión |
| 6 | Tiempo de la operación de conexión en milisegundos |
4DDebugLog.txt (tabular)
Este archivo de historial registra cada evento que se produce a nivel de programación 4D en un formato compacto y con tabulaciones que incluye información adicional (en comparación con el formato estándar).
Como iniciar este historial:
SET DATABASE PARAMETER(Debug Log Recording;2+4)
//formato tabular extendido, todos los procesos
SET DATABASE PARAMETER(Current process debug log recording;2+4)
//extendido, sólo el proceso actual
Los siguientes campos se registran para cada evento:
| Columna # | Nombre del campo | Descripción |
|---|---|---|
| 1 | sequence_number | Número de operación único y secuencial en la sesión de historial |
| 2 | time | Fecha y hora en el formato ISO 8601: (YYYY-MM-DDThh:mm:ss.mmm) |
| 3 | ProcessID | ID del Proceso |
| 4 | unique_processID | ID único del proceso |
| 5 | stack_level | Nivel de stack |
| 6 | operation_type | Tipo de operación histórico. Este valor puede ser un valor absoluto:
operation_type, operation y operation_parameters tienen el mismo valor que el nivel de pila de apertura registrado en la columna stack_opening_sequence_number. Por ejemplo:
|
| 7 | operation | Puede representar (según el tipo de operación): |
| 8 | operation_parameters | Parámetros pasados a comandos, métodos o plugins |
| 9 | form_event | Evento formulario si lo hay; vacío en otros casos (supongamos que la columna se utiliza cuando se ejecuta el código en un método formulario o en un método objeto) |
| 10 | stack_opening_sequence_number | Sólo para los niveles de pila de cierre: número de secuencia del nivel de pila de apertura correspondiente |
| 11 | stack_level_execution_time | Sólo cuando se cierra el nivel de la pila: el tiempo transcurrido en microsegundos de la acción registrada actualmente (ver la décima columna en las líneas 123 y 124 del registro anterior) |
4DDiagnosticLog.txt
Este archivo de historial registra muchos eventos relacionados con el funcionamiento interno de la aplicación y es legible para las personas. Puede incluir información personalizada en este archivo utilizando el comando LOG EVENT.
Como iniciar este historial:
SET DATABASE PARAMETER(Diagnostic log recording;1) //iniciar registro
Los siguientes campos se registran para cada evento:
| Nombre del campo | Descripción |
|---|---|
| sequenceNumber | Número de operación único y secuencial en la sesión de historial |
| timestamp | Fecha y hora en el formato ISO 8601: (YYYY-MM-DDThh:mm:ss.mmm) |
| loggerID | Opcional |
| componentSignature | Opcional - firma del componente interno |
| messageLevel | Información, avisos, errores |
| message | Descripción de la entrada del historial |
Dependiendo del evento, se pueden incluir otros campos en el registro, como la tarea, socket, etc.
4DSMTPLog.txt, 4DPOP3Log.txt y 4DIMAPLog.txt
Estos archivos de registro registran cada intercambio entre la aplicación 4D y el servidor de correo (SMTP, POP3, IMAP) que ha sido iniciado por los siguientes comandos:
- SMTP - SMTP New transporter
- POP3 - POP3 New transporter
- IMAP - IMAP New transporter
Los archivos de historial pueden producirse en dos versiones:
- una versión normal:
- archivos llamados 4DSMTPLog.txt, 4DPOP3Log.txt, o 4DIMAPLog.txt
- sin adjuntos
- utiliza un reciclaje automático de archivos circulares cada 10 MB
- destinado a la depuración habitual
Para iniciar este historial:
SET DATABASE PARAMETER(SMTP Log;1) //iniciar log SMTP
SET DATABASE PARAMETER(POP3 Log;1) //iniciar log POP3
SET DATABASE PARAMETER(IMAP Log;1) //iniciar log IMAP
4D Server: clic en el botón Iniciar los historiales de peticiones y de depuración en la página Mantenimiento ode la ventana de administración de 4D Server.
Esta ruta al historial es devuelta por el comando Get 4D file.
- una versión extendida:
- attachment(s) included no automatic recycling
- nombre personalizado
- reservado con fines específicos
Para iniciar este historial:
$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)
Contenido
Para cada petición, se registran los siguientes campos:
| Columna # | Descripción |
|---|---|
| 1 | Número de operación único y secuencial en la sesión de historial |
| 2 | Fecha y hora en el formato RFC3339 (yyyy-mm-ddThh:mm:ss.ms) |
| 3 | ID Proceso 4D |
| 4 | ID único del proceso |
| 5 |
|
Peticiones cliente ORDA
Este diario registra cada petición de ORDA enviada desde una máquina remota. Puede dirigir la información de registro a la memoria o a un archivo en el disco. El nombre y la ubicación de este archivo de registro son de su elección.
Como iniciar este historial:
//a ejecutar en una máquina remota
ds.startRequestLog(File("/PACKAGE/Logs/ordaLog.txt"))
//también puede enviarse a la memoria
Si desea utilizar el número de secuencia único en el registro de peticiones de ORDA, debe activarlo:
//a ejecutar en una máquina remota
SET DATABASE PARAMETER(Client Log Recording;1)
//para activar el número de secuencia del historial
ds.startRequestLog(File("/PACKAGE/Logs/ordaLog.txt"))
//también puede enviarse a la memoria
SET DATABASE PARAMETER(Client Log Recording;0)
//desactiva el número de secuencia
Los siguientes campos se registran para cada petición:
| Nombre del campo | Descripción | Ejemplo |
|---|---|---|
| sequenceNumber | Número de operación único y secuencial en la sesión de historial | 104 |
| url | URL de la petición ORDA efectuada por el cliente | "rest/Persons(30001)" |
| startTime | Fecha y hora de inicio en formato ISO 8601 | "2019-05-28T08:25:12.346Z" |
| endTime | Fecha y hora final en formato ISO 8601 | "2019-05-28T08:25:12.371Z" |
| duration | Duración del procesamiento cliente (ms) | 25 |
| response | Objeto respuesta del servidor | {"status":200,"body":{"__entityModel":"Persons",[...] |