Registro binario y extensiones de rastreo SIP (Session Initiation Protocol) en Liberty
El registro binario proporciona una forma para que los desarrolladores añadan campos de extensión a registros de rastreo y registros y una forma correspondiente para que filtre los registros de rastreo y registros por valor de extensión.
Los registros de rastreo y los registros contienen campos para información como, por ejemplo, la hora cuándo se creó el registro y el contenido del mensaje que se registra. Estos campos son campos determinantes que están presentes en todos los registros y registros de rastreo. Por el contrario,los campos de extensión son campos que los desarrolladores de aplicaciones pueden añadir a registros y registros de rastreo, que puede utilizar como criterios de filtro al buscar contenido de registro y rastreo específico. Estas extensiones de registro y rastreo son visibles en el registro binario al configurar el formato de salida de texto para utilizar el formato avanzado, o son visibles al utilizar el mandato binaryLog en el formato avanzado.
- Administradores
El servidor de aplicaciones crea automáticamente un número de extensiones que puede utilizar para filtrar registros y registros de rastreo. También puede filtrar registros y registros de rastreo utilizando cualquier extensión añadida por los desarrolladores de aplicaciones. Puede utilizar la herramienta de línea de mandatos binaryLog para filtrar registros basándose en el contenido de extensiones de registro y registro de rastreo. Para obtener más información, consulte Opciones de mandato BinaryLog.
Por ejemplo, para ver todas las sesiones de aplicación SIP que ha procesado el contenedor SIP, puede utilizar el mandato binaryLog siguiente:binaryLog view archivobinario --includeExtension=SIPASId=* --format=advanced
- Desarrolladores
Los desarrolladores pueden utilizar el registro binario para añadir extensiones personalizadas a los registros y registros de rastreo a través de la API de contexto de registro, com.ibm.websphere.logging.hpel.LogRecordContext. Cuando el registro binario almacena registros y registros de rastreo, incluye cualquier extensión que está presente en el contexto del registro en la misma hebra. Por ejemplo, puede escribir un filtro de servlet para añadir parámetros de solicitud HTTP importantes al contexto de registro. Mientras se ejecuta ese servlet, la API HPEL añade estas extensiones a cualquier registro y registro de rastreo que se haya creado en la misma hebra.
Al igual que con otros campos de registro y registro de rastreo, los desarrolladores pueden acceder a las extensiones de registro utilizando la API HPEL. Esta API es útil cuando se escriben herramientas para leer en repositorios de registro y rastreo. Los desarrolladores también pueden utilizar la API de contexto de registro para acceder a extensiones en manejadores de registros personalizados, filtros y formateadores durante el tiempo de ejecución.
La tabla siguiente describe las extensiones de registro y rastreo, incluyendo el identificador que puede utilizar para filtrar distintos aspectos del rastreo.
Extensión | Descripción |
---|---|
appName | Especifica el nombre de la aplicación Java™ Platform, Enterprise Edition (Java EE) a la que se refiere el registro o registro de rastreo, si hay alguno. |
requestID | Especifica el ID exclusivo de la solicitud a la que se refiere cada registro o registro de rastreo, si hay alguno. Para que el servidor de aplicaciones añada la extensión requestID a los registros y registros de rastreo, debe habilitar el rastreo entre componentes (XCT), también conocido en la consola administrativa como correlación de registro y rastreo. Los ID de solicitud sólo se añaden para determinados tipos de solicitudes como, por ejemplo, solicitudes HTTP o JMS. |
SIPCallId | Especifica el identificador de llamada SIP que está procesando el servidor proxy SIP o el contenedor SIP. Esta información es común entre los servidores proxy SIP y contenedores SIP. Puede utilizar esta extensión para rastrear el flujo de la llamada SIP entre los distintos componentes. El servidor proxy SIP y el contenedor SIP añaden automáticamente este identificador a cada registro y registro de rastreo cuando está habilitado el rastreo HPEL. |
SIPASId | Especifica el ID de sesión de la aplicación SIP que está procesando el contenedor SIP. Esta información es común entre los contenedores SIP. Puede utilizar esta extensión para rastrear el fljo de llamada SIP. El contenedor SIP añade automáticamente este identificador a cada registro y registro de rastreo cuando está habilitado el registro HPEL. |
SIPSessionId | Especifica el ID de sesión de SIP que está procesando el contenedor SIP. Esta información es común entre los contenedores SIP. Puede utilizar esta extensión para rastrear el fljo de llamada SIP. El contenedor SIP añade automáticamente este identificador a cada registro y registro de rastreo cuando está habilitado el registro HPEL. |
SIPCallId2 | Especifica el segundo ID de la llamada SIP que está asociado a la misma sesión de aplicación SIP y la está procesnado el contenedor SIP. Esta información es común entre los contenedores SIP. Puede utilizar esta extensión para rastrear el fljo de llamada SIP. El contenedor SIP añade automáticamente este identificador a cada registro y registro de rastreo cuando está habilitado el registro HPEL. Si están asociadas más de dos ID de llamada SIP a una sola sesión de aplicación SIP, solo se registran los dos primeros ID. No se registran los ID adicionales. |
SIPSessionId2 | Especifica el segundo ID de sesión SIP que está asociado a la misma sesión de aplicación SIP y lo está procesando el contenedor SIP. Esta información es común entre los contenedores SIP. Puede utilizar esta extensión para rastrear el fljo de llamada SIP. El contenedor SIP añade automáticamente este identificador a cada registro y registro de rastreo cuando está habilitado el registro HPEL. Si se asocia más de dos ID de sesión SIP con una sola sesión de aplicación SIP, sólo se registrarán los dos primeros ID. No se registran los ID adicionales. |
thread | Especifica el nombre de hebra de la solicitud con el que se relaciona cada registro de registro cronológico o rastreo. |