Registro en el SDK de Rapid para Java
El SDK de Rapid para Java no impone ningún marco de registro a los clientes, sino que permite realizar registros a través de la interfaz SLF4J. SLF4J proporciona una abstracción para varios marcos de registro, lo que permite a los clientes conectar la implementación que prefieran al crear sus proyectos.
Sin un marco de registro conectado, el SDK (SLF4J) se establece de forma predeterminada como no operativo, de modo que se descarta cualquier solicitud de registro y se muestra un único mensaje de advertencia.
SLF4J: Failed to load class "org.slf4j.impl.StaticLoggerBinder".\
SLF4J: Defaulting to no-operation (NOP) logger implementation\
SLF4J: See http://www.slf4j.org/codes.html#StaticLoggerBinder for further details.Declaración de dependencias del proyecto
Un cliente puede conectar un marco de registro concreto declarándolo dependencia del proyecto. SLF4J está diseñado para usar un solo marco a la vez y emitirá un mensaje de advertencia si encuentra varios marcos.
Simple Logger
Java Util Logging
Logback
Log4j2
Formato de registro
Los marcos de registro son compatibles con formatos y diseños de registro personalizados e incluir en el registro detalles como la marca de tiempo y el nombre de la persona que lo ha registrado ayuda a solucionar problemas del SDK. Además, los mensajes de registro se anotan con el prefijo ExpediaGroupSDK, por lo que puede usarse para filtrarlos.
13:36:59.287 [DefaultDispatcher-worker-1] INFO c.e.s.c.c.c.ConfigurationCollector MDC= - ExpediaSDK: Successfully loaded [endpoint] from [runtime configuration]Niveles de registro
Si quieres realizar un seguimiento de los datos de solicitudes y respuestas que se originan y se reciben en el SDK, puedes establecer tu nivel de registro como "INFO"; de esta forma, se registrarán con el encabezado y el contenido del cuerpo del mensaje. No obstante, este nivel puede generar una cantidad importante de datos de registro. Si estableces el nivel de registro en "WARN" o "ERROR", solo se registrarán las excepciones y errores que incluyan un id. de transacción que puedas compartir con Expedia Group en caso de experimentar un comportamiento inesperado.
Si estás intentando solucionar un problema, puedes establecer el nivel de registro en "DEBUG" para obtener más información detallada sobre la solicitud y la respuesta; los registros de este nivel incluyen datos más extensos sobre los eventos del cliente OkHttp y el id. de transacción.
Ejemplos de mensajes de registro en nivel "DEBUG":
17:40:08.490 [DefaultDispatcher-worker-3] DEBUG com.expediagroup.sdk.core.client.OkHttpEventListener - ExpediaSDK: Call start for transaction-id: [aff4c00d-6f79-4690-8f60-dd1aaccbfaee]
17:40:08.496 [OkHttp https://test.ean.com/...] DEBUG com.expediagroup.sdk.core.client.OkHttpEventListener - ExpediaSDK: Connect start for transaction-id: [aff4c00d-6f79-4690-8f60-dd1aaccbfaee]
17:40:08.508 [OkHttp https://test.ean.com/...] DEBUG com.expediagroup.sdk.core.client.OkHttpEventListener - ExpediaSDK: Connect end for transaction-id: [aff4c00d-6f79-4690-8f60-dd1aaccbfaee]
17:40:08.508 [OkHttp https://test.ean.com/...] DEBUG com.expediagroup.sdk.core.client.OkHttpEventListener - ExpediaSDK: Connection acquired for transaction-id: [aff4c00d-6f79-4690-8f60-dd1aaccbfaee]
17:40:08.510 [OkHttp https://test.ean.com/...] DEBUG com.expediagroup.sdk.core.client.OkHttpEventListener - ExpediaSDK: Sending request headers start for transaction-id: [aff4c00d-6f79-4690-8f60-dd1aaccbfaee]
17:40:08.510 [OkHttp https://test.ean.com/...] DEBUG com.expediagroup.sdk.core.client.OkHttpEventListener - ExpediaSDK: Sending request headers end for transaction-id: [aff4c00d-6f79-4690-8f60-dd1aaccbfaee]Trazabilidad
El SDK genera un transaction ID único para cada llamada de API, lo cual resulta útil para resolver problemas rastreando las solicitudes completas. Los id. de transacción se añaden a los encabezados de solicitud y respuesta, y se registran en mensajes de error en caso de excepción.