Skip to main content

Veritran Docs

Log Transaccional

El log transaccional registra cada transacción ejecutada en la plataforma con información detallada, como su código de respuesta, la duración de la transacción, sus pasos y el resultado de cada paso, lo que te permite monitorear en profundidad la salud de la transacción. Con esta información, en caso de encontrar un error en una aplicación, puedes analizar el log de ese día y detectar errores en todo el flujo transaccional.

El proceso Settlement crea tablas de transacciones diarias y mensuales que se exportan al final del día y del mes, y también crea un resumen de las transacciones diarias. Puedes acceder a los logs transaccionales a través de la base de datos y el sistema de archivos, o a través de Middleware (consola).

transaction_log.png

Lee a continuación para obtener más información sobre cada log transaccional generado por el Settlement.

Importante

Este artículo se centra únicamente en los logs transaccionales. Para obtener información sobre los logs de operación, que cubren los componentes de la plataforma, lee la sección Logs en la documentación de VT-NET.

Tabla diaria de transacciones

Cada transacción ejecutada en el sistema se almacena en la tabla diaria de transacciones, creada por el proceso Settlement. El nombre de esta tabla sigue este formato: XX_TRANSAC_LOG_YYYYMMDD, siendo XX el código de producto, como Banca Móvil.

En un momento definido en el parámetro maxLNCutoverTime, el Settlement exporta la tabla de transacciones diarias y la comprime en un archivo .gzip, con el siguiente formato de nombre: XX_TRANSAC_LOG_YYYYMMDD_YYYYMMDDhhmmss.trxlog.gz. Los archivos se almacenan en el Core Server, en el directorio establecido en el parámetro SettleLogDumpPath del Settlement. Cada archivo contiene el DDL de las tablas y sus registros.

A continuación se muestra un detalle de cada campo de datos que se puede encontrar en una tabla de transacciones diarias.

Campo

Tipo

Descripción

trxl_id

int(10)

Identificación del registro

trxl_write_timestamp

timestamp

Fecha y hora del registro

trxl_msg_typ

int(4)

Tipo de mensaje transaccional

trxl_msg_stat

int(2)

Estado del mensaje

trxl_orig_pro_env

varchar2(2)

Entorno del proceso que originó la solicitud

trxl_orig_pro_siteid

number(2)

Site ID del proceso que originó la solicitud

trxl_orig_pro_node

varchar(4)

Nodo del proceso que originó la solicitud

trxl_orig_pro_name

varchar(16)

Nombre lógico del proceso que originó la solicitud

trxl_hld_orig_pro_env

varchar2(4)

Entorno del primer proceso que originó la solicitud

trxl_hld_orig_pro_siteid

number(2)

Site ID del primer proceso que originó la solicitud

trxl_hld_orig_pro_node

varchar(4)

Nodo del primer proceso que originó la solicitud

trxl_hld_orig_pro_name

varchar(16)

Nombre lógico del primer proceso que originó la solicitud

trxl_originator

char(1)

Información que indica desde dónde se regeneró la solicitud

trxl_responder

char(1)

Información que indica desde dónde se genera la respuesta

trxl_excpt_flg

char(1)

Excepciones encontradas mientras se ejecutaba la transacción

trxl_host_id

varchar(4)

Código de host que recibe la transacción

trxl_step_id

int(1)

Paso de la transacción en el que interviene el host

trxl_proc_step1, trxl_proc_step2, trxl_proc_step3, trxl_proc_step4

char(1)

Paso de la transacción y su resultado, solo en transacciones que admiten la autorización en varios pasos

trxl_host_step1, trxl_host_step2, ,trxl_host_step3 trxl_host_step4

varchar(4)

Código de host que recibe la transacción después de cada paso

trxl_tran_dat

date

Fecha de la transacción: aaaammdd

trxl_tran_tim

time

Hora de la transacción: hhmmsscc

trxl_post_dat

date

Fecha de la transacción registrada en el log transaccional, establecida por Device Handler o el Host Interface

trxl_term_id

varchar(36)

Identificador del terminal que ejecutó la transacción. Identifica, por ejemplo, una aplicación móvil instalada en un dispositivo en particular

trxl_term_ln

varchar(4)

Identificador de la red VT-NET del terminal

trxl_seq_num

int(5)

Número de secuencia que identifica una transacción. Cada terminal tiene su propio número de secuencia

trxl_term_typ

char(2)

Tipo de terminal desde donde se originó la transacción

trxl_rvsl_cde

int(2)

Código de transacción de reversa establecido por el Device Handler o el Host Interface

trxl_compl_req

char(1)

Indica si el host necesita una notificación de finalización

trxl_orig_compl_req

char(1)

Indica si es necesario recibir una confirmación de la transacción desde el dispositivo de origen

trxl_reversible

char(1)

Indica si es necesario establecer una transacción de reversa si no hay confirmación de respuesta

trxl_resp

char(3)

Código de respuesta de la transacción que es único para cada instalación

trxl_auth_dest

trxl_auth_dest

Nombre del autorizador

trxl_entry_tim

datetime

Marca de tiempo que determina cuándo entra la solicitud en el sistema. Esto se establece mediante el Device Handler o el Host Interface

trxl_exit_tim

dametime

Marca de tiempo que determina cuándo sale la solicitud del sistema para una autorización externa. Esto se establece mediante el Device Handler o el Host Interface

trxl_re_entry_tim

datetime

Marca de tiempo que determina cuándo la solicitud vuelve a entrar en el sistema después de una autorización externa. Esto se establece mediante el Device Handler o el Host Interface

trxl_transaction_code (*)

int(4)

Código de transacción único para cada instalación

trxl_institution_code  (*)

varchar(4)

Código de la Institución del cliente

trxl_client_id_type (*)

varchar(4)

Tipo de identificador de cliente

trxl_client_id (*)

varchar(64)

Identificador de cliente, con cifrado AES-128-CBC

trxl_card_number (*)

varchar(30)

Número de tarjeta del cliente. Se puede omitir u ocultar varios dígitos

trxl_host_post_date (*)

date

Fecha de publicación del host autorizador

trxl_host_current_date (*)

date

Fecha del host autorizador

trxl_host_current_time (*)

time

Hora del host autorizador

trxl_host_seq_number (*)

varchar(20)

Número de secuencia del host autorizador

trxl_host_terminal (*)

varchar(20)

Código de terminal del host autorizador

trxl_configuration_group (*)

int(2)

Grupo de configuración de la aplicación móvil

trxl_authorization_code (*)

varchar(10)

Código de autorización de la transacción, generado como medida de seguridad cuando la transacción lo requiere

trxl_banners_group (*)

int(3)

Grupo de banners de la aplicación móvil

trxl_client_alt_id (*)

varchar(64)

Identificador alternativo del cliente, con encriptación AES-128-CBC

trxl_amount1, trxl_amount, trxl_amount3, trxl_amount4 (*)

float

Importes implicados en una transacción

trxl_date1, trxl_date2, trxl_date3, trxl_date4(*)

date

Fechas involucradas en una transacción

trxl_account_pri_id1, trxl_account_pri_id2, trxl_account_pri_id3, trxl_account_pri_id4 (*)

varchar(10)

Identificador principal de las cuentas involucradas en una transacción. Por ejemplo, un tipo de cuenta

trxl_account_sec_id1, trxl_account_sec_id2, trxl_account_sec_id3, trxl_account_sec_id4 (*)

varchar(10)

Identificador secundario de las cuentas involucradas en una transacción. Por ejemplo, un subtipo de cuenta

trxl_account1, trxl_account2, trxl_account3, trxl_account4 (*)

varchar(35)

Números de cuenta involucrados en una transacción

trxl_text1, trxl_text2, trxl_text3, trxl_text4 (*)

varchar(255)

Textos o descripciones que intervienen en una transacción

trxl_flag1, trxl_flag2, trxl_flag3, trxl_flag4 (*)

char(1)

Banderas o flags de una transacción

trxl_auth_code_step1, trxl_auth_code_step2, trxl_auth_code_step3, trxl_auth_code_step4 (*)

varchar(10)

Código de autorización relacionado con el paso de una autorización. Se genera como medida de seguridad por parte del autorizador cuando la transacción lo requiere

trxl_currency1, trxl_currency2 (*)

int(3)

Código de la moneda involucrada en la transacción, utilizando el esquema de codificación numérico ANSI

trxl_detail

varchar (4000)

Información adicional sobre la transacción y el dispositivo de origen

trxl_tech_detail

clob

Información detallada sobre los pasos de la transacción

trxl_host_begin

timestamp

Fecha en la que el host recibió la transacción

trxl_host_end

timestamp

Fecha en la que el host devuelve la transacción

trxl_client_plain_id

varchar2(64)

Identificador del usuario (sin cifrar)

trxl_channel

varchar2(35)

Canal que recibe la transacción (web, móvil o smartPOS)

trxl_used_version

number(10)

Versión de transacción utilizada por el host

trxl_requested_version

number(10)

Versión de transacción solicitada al host

trxl_timeout

number(10)

Tiempo de espera asignado para la transacción

trxl_auth_methods_desc

varchar2(255)

Método de autenticación utilizado por el usuario final (huella dactilar, reconocimiento facial, contraseña, etc.)

trxl_rcdc_name_id

varchar2(64)

Nombre del experimento de Bluegreen que está corriendo durante la ejecución de la transacción

trxl_rc_path

varchar2(20)

Ruta que tomó la transacción durante un experimento de Bluegreen (NULL es igual a BLUE)

trxl_session_id

varchar2(3000)

Identificador de sesión de la transacción

Nota

(*) Estos campos solo estarán disponibles para las transacciones que contengan esta información.

También se puede acceder al log transaccional diario a través de Middleware, en la opción Transaction Log.

Archivo diario del log transaccional

Además de la tabla de transacciones diarias, el Settlement también almacena un archivo diario del log transaccional directamente en el servidor. Este archivo contiene todas las transacciones procesadas por nodo y se puede utilizar junto con herramientas de monitoreo o análisis para verificar el rendimiento de la plataforma.

Para acceder al archivo diario del log transaccional, ve al directorio de logs de VT-NET, /veritran/vt-net/log/. Se almacena con el siguiente formato de nombre: XX_TRANSAC_LOG_<<LOGICALNETWORK>>_<<NODE>>.log. Todos los días a medianoche, este archivo cambiará de nombre a: XX_TRANSAC_LOG_<<LOGICALNETWORK>>_<<NODE>>.logYYYYMMDDHHMMSS.

Cada línea del archivo del log transaccional corresponde a una transacción o registro, y contiene una parte fija, el encabezado, y una parte que varía, que contiene los datos.

Tabla 1. Campos de encabezado

Nombre

Tipo

Largo

Descripción

Separator

String

1

Separador fijo "["

Status

String

4

Estado del registro

Separator

String

2

Separador fijo "]"

TimeStamp

TimeStamp

24

Fecha y hora del registro

Separator

String

3

Separador fijo "–"

Pid

Integer

8

Identificador del proceso del sistema operativo

Separator

String

1

Separador fijo ":"

ThreadId

Integer

10

Identificador del subproceso del sistema operativo

Separator

String

2

Separador fijo "["

Object

String

16

Nombre del objeto que registró el evento

Separator

String

12

Separador fijo "]"



En referencia a la sección de datos del log, el archivo incluye toda la información listada en la tabla diaria de transacciones, con el formato |<etiqueta1>=<valor1>|<etiqueta2>=<valor2>|...|<labelN>=<valueN>|y la siguiente información adicional.

Tabla 2. Campos de datos

Campo

Tipo

Descripción

tabla

string(100)

Nombre de la tabla en la base de datos Oracle

trxl_device_brand

string(4)

Marca del dispositivo donde se originó la transacción

trxl_device_model

string(8)

Modelo del dispositivo donde se originó la transacción



[PEND] 20090304164818:642894700 -    26276:         1 [MBAUTH01        ] table=MB_TRANSAC_LOG_20090304|trxl_write_timestamp=20090304164818522402900|trxl_msg_typ=210|trxl_msg_stat=0|trxl_orig_pro_node=NOD1|trxl_orig_pro_name=MBDH01|trxl_hld_orig_pro_node=|trxl_hld_orig_pro_name=|trxl_originator=1|trxl_responder=2|trxl_excpt_flg=0|trxl_host_id=BNR1|trxl_step_id=|trxl_proc_step1=|trxl_proc_step2=|trxl_proc_step3=|trxl_proc_step4=|trxl_host_step1=|trxl_host_step2=|trxl_host_step3=|trxl_host_step4=|trxl_tran_dat=20090304|trxl_tran_tim=164816|trxl_post_dat=20090304|trxl_term_id=00f22fe1-8700-c1f2-aad2-ceb1040b46d0|trxl_term_ln=NOD1|trxl_seq_num=2|trxl_term_typ=01|trxl_rvsl_cde=0|trxl_compl_req=0|trxl_orig_compl_req=0|trxl_reversible=0|trxl_resp=H99|trxl_auth_dest=MBAUTH01|trxl_entry_tim=20090304164816480|trxl_exit_tim=20090304164817011|trxl_re_entry_tim=20090304164818507|trxl_transaction_code=1010|trxl_institution_code=0000|trxl_client_id_type=BAS|trxl_client_id=7c6fc7d062e3edf21275cd5b3a967a9c|trxl_configuration_group=0|trxl_authorization_code=null|trxl_banners_group=0|trxl_client_alt_id=null|trxl_card_number=null|trxl_host_post_date=null|trxl_host_current_date=null|trxl_host_current_time=null|trxl_host_seq_number=null|trxl_host_terminal=null|trxl_device_brand=NOKI|trxl_device_model=6267____|trxl_amount1=null|trxl_amount2=null|trxl_amount3=null|trxl_amount4=null|trxl_date1=null|trxl_date2=null|trxl_date3=null|trxl_date4=null|trxl_account_pri_id1=null|trxl_account_pri_id2=null|trxl_account_pri_id3=null|trxl_account_pri_id4=null|trxl_account_sec_id1=null|trxl_account_sec_id2=null|trxl_account_sec_id3=null|trxl_account_sec_id4=null|trxl_account1=null|trxl_account2=null|trxl_account3=null|trxl_account4=null|trxl_text1=null|trxl_text2=null|trxl_text3=null|trxl_text4=Los datos proporcionados son incorrectos|trxl_flag1=null|trxl_flag2=null|trxl_flag3=null|trxl_flag4=null|trxl_auth_code_step1=null|trxl_auth_code_step2=null|trxl_auth_code_step3=null|trxl_auth_code_step4=null|trxl_currency1=null|trxl_currency2=null 

Tabla diaria de resumen de transacciones

A la hora definida en el parámetro maxLNCutoverTime, el Settlement ejecuta un resumen de las transacciones del día y guarda la tabla con el siguiente formato de nombre: XX_TRANSAC_SUMMARY_YYYYMMDD.

A continuación se muestra un detalle de cada campo de datos que se puede encontrar en una tabla diaria de transacciones.

Campo

Tipo

Descripción

trxs_id

int(10)

Identificador de la tabla

trxs_post_dat

date

Fecha del resumen

trxs_msg_typ

int(4)

Tipo de mensaje

trxs_transaction_code

int(4)

Código de la transacción

trxs_resp

char(3)

Código de respuesta

trxs_count

int(10)

Número de transacciones

trxs_write_timestamp

datetime

Fecha y hora de creación del registro

trxs_max_trxl_id

int(10)

Último identificador de la tabla del log transaccional

trxs_verify

char(8)

Hash de integridad de los datos

Informe Mensual de Actividad

Al final del mes, el proceso Settlement genera y exporta un informe de actividad mensual, en el que recoge toda la actividad relacionada con las transacciones ejecutadas durante el mes. El nombre de esta tabla sigue este formato: XX_TRANSAC_LOG_YYYYMMDD XX_TRANSAC_SUMMARY_ YYYYMMDD_YYYYMMDDhhmmss.rpt.

Los archivos se almacenan en el Core Server, en el directorio establecido en el parámetro SettleMonthRptPath del Settlement.

Cada archivo contiene el siguiente formato: