![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
![[z/OS]](../images/ngzos.gif)
Formato del archivo de registro personalizado
Cuando una solicitud se procesa, puede crear conjuntos de reglas para especificar qué datos deben incluirse en el archivo de registro, el orden de visualización, la lógica condicional de filtrado de solicitudes y el número y los nombres de los archivos de registro.
Objetos de propiedad personalizada
Los objetos de propiedad personalizada se pueden utilizar en el nivel de conjunto de reglas, de regla y de acción. Las reglas determinan las condiciones de acuerdo a las que se ejecutan las acciones del registro. Se utiliza un campo de expresión para determinar las solicitudes y respuestas para registrar. Esta expresión utiliza los operandos del lenguaje HTTP estándar, y el operando response.code para filtrar por códigos de respuesta HTTP, como 404 o 503. Por ejemplo, response.code = 200 filtra todas las respuestas del código de respuesta 200. El operando HTTP targetserver se utiliza para mostrar al servidor donde la solicitud se envió con un formato de WebSphere Application Server. El operando del registro personalizado de HTTP service.time es el marco de tiempo entre cuando se envía la solicitud al servidor de aplicaciones y cuando se recibe una respuesta del servidor de aplicaciones. El operando del registro personalizado de HTTP response.time es el marco de tiempo entre el momento en que la solicitud se recibe en el ODR y el momento en que la respuesta de solicitud se envía desde el ODR. Para obtener más información, consulte el tema sobre los operandos de registro personalizado HTTP.
La prioridad de regla determina el orden de la evaluación de la regla. Las acciones de registro específicas se producen cuando las reglas coinciden. Las acciones de registro tienen un campo continue. Cuando continue se establece en true, se pueden ejecutar acciones de registro subsiguientes. No obstante, si continue se establece en false, una vez que ha finalizado la acción de registro, no se lleva a cabo ninguna acción de registro subsiguiente. Utilice el script manageODR.py para crear un clúster de ODR y gestionar el registro personalizado. Para obtener más información, consulte el tema sobre el script manageODR.py.
Conjunto de reglas
- name
- Especifica el nombre del conjunto de reglas. (String, necesario)
- tipo
- Especifica el tipo de conjunto de reglas. (Serie, identificador de protocolo como, por ejemplo, HTTP)
- continueDefault
- Determina el valor predeterminado de continuar. (Boolean, necesario)
- properties
- Opcional.
- regla
- Obligatoria
regla
- name
- Especifica el nombre de la regla. (Serie, exclusiva dentro del conjunto de reglas)
- priority
- Obligatorio, entero (exclusivo dentro del conjunto de reglas)=
- expression
- Serie, obligatorio.
- action
- Necesario.
- properties
- Opcional.
Acción
- name
- Especifica el nombre de la acción. (Serie, exclusiva dentro de la regla)
- priority
- Opcional, entero (exclusivo dentro de la regla).
- tipo
- Serie, obligatorio, registro
- value
- Obligatorio.(Serie, contiene una serie de logFormats delimitados por
@. Por ejemplo:
value="custom01.log %a%z@custom02.log @(#) 10 1.7@(#)Z"
- continue
- Opcional, booleano. Si no está establecido, valores predeterminados para el valor continueDefault; true, false.
- properties
- Opcional.
customProperties
- name
- Especifica el nombre de la propiedad personalizada. (Serie)
- value
- Obligatorio.(Serie)
- continue
- Opcional, booleano. Si no está establecido, toma el valor predeterminado continueDefault; true, false.
Formato de la acción de registro
El atributo del valor de la acción contiene un conjunto de argumentos para indicar el nombre de archivo y el formato del registro. Para crear varios registros en el atributo del valor, delimite los argumentos con un signo @. El primer argumento de la acción de registro es el nombre del archivo de registro, relativo al directorio de registros del ODR. Los siguientes argumentos son parámetros para especificar qué información incluir en el registro. Los datos se muestran en el orden en que se especifican los parámetros.
Parámetro | Descripción |
---|---|
%a | Dirección IP remota. |
%A | Dirección - IP local. |
%B | Bytes enviados, excluidas cabeceras HTTP. |
%b | Bytes enviados, excluidas cabeceras HTTP. En el formato CLF, es decir, un '-' en lugar de un cero cuando no se envía ningún byte. |
%{FOOBAR}C | El contenido de la cookie en la solicitud enviada al servidor. |
%{FOOBAR}i | El contenido de Foobar: líneas de cabecera de la solicitud enviada al servidor. |
% I | Bytes recibidos, incluidas la solicitud y cabeceras, no puede ser cero. |
%{FOOBAR}e | El contenido del argumento de depuración ("-D") FOOBAR especificado para la JVM del proceso del ODR. |
%h | Host remoto. |
%H | El protocolo de solicitud HTTP o HTTPS. |
%m | El método de solicitud. |
%{FOOBAR}o | El contenido de Foobar, las líneas de cabecera de la respuesta. |
%O | Bytes enviados, incluidas las cabeceras; el número no puede ser cero. |
%p | El puerto canónico del servidor que sirve la solicitud. |
%q | La serie de consulta, con el prefijo ?, si existe una serie de consulta. De lo contrario, se trata de una serie vacía. |
%r | La primera línea de la solicitud. |
%R | Tiempo de respuesta en milisegundos. El tiempo combinado dedicado en ODR y servidor de aplicaciones. |
%s | Estado, código de respuesta HTTP, es decir, 503, 404, 200. |
%t | El tiempo, en el formato de tiempo de formato de registro común, formato inglés estándar. |
%{format}t | El tiempo, en la forma proporcionada por el formato, que debe ser un formato strftime(3). Probablemente, localizado. |
%T | El tiempo que se tarda en servir la solicitud, en milisegundos. |
%U | La vía de acceso del URL solicitado, sin incluir ninguna serie. |
%v | El ServerName canónico del servidor que sirve la solicitud. |
%z | Dirección IP de destino. |
%Z | Nombre de servidor de destino (célula/nodo/servidor). |