Log Transaccional
[en] The transaction log registers every transaction executed in the platform with detailed information, such as its response code, the transaction's duration, its steps and each step's result, which allows you to monitor the transaction's health in depth. With this information, if you encounter an error in an app, you can analyze the log of that day and detect errors in the whole transactional flow.
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).
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
[en] Each transaction executed in the system is stored in the daily transaction log table, created by the Settlement process. The name of this table follows this format: XX_TRANSAC_LOG_YYYYMMDD, XX being the product code, such as Mobile Banking.
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) | Indica desde dónde se regeneró la solicitud |
trxl_responder | char(1) | 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) | [en] Sequence number that identifies a transaction. Each terminal has its own sequence number |
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 | [en] Timestamp that determines when the request enters the system. This is set by the Device Handler or the Host Interface |
trxl_exit_tim | Dametime | [en] Timestamp that determines when the request exits the system for an external authorization. This is set by the Device Handler or the Host Interface |
trxl_re_entry_tim | datetime | [en] Timestamp that determines when the request reenters the system after an external authorization. This is set by the Device Handler or the 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) | [en] Client's card number. It can be ommited, or it can hide several digits |
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) | [en] Primary identifier of the accounts involved in a transaction. For example, an account type |
trxl_account_sec_id1, trxl_account_sec_id2, trxl_account_sec_id3, trxl_account_sec_id4 (*) | varchar(10) | [en] Secondary identifier of the accounts involved in a transaction. For example, an account sub-type |
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 implicadas en una transacción |
trxl_auth_code_step1, trxl_auth_code_step2, trxl_auth_code_step3, trxl_auth_code_step4 (*) | varchar(10) | [en] Authorization code related to an authorization's step. It is generated as a security measure by the authorizator when the transaction requires it |
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, la cabecera, y una parte que varía, que contiene los datos.
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.
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: