![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
![[z/OS]](../images/ngzos.gif)
Formato de Arquivo de Log Customizado
Quando uma solicitação é processada, você pode criar conjuntos de regras para especificar quais dados devem ser incluídos nos logs, a ordem de exibição, a lógica condicional para filtrar quais solicitações são incluídas e o número do arquivo de log e nomes.
Objetos de Propriedade Customizada
Objetos de propriedade customizada podem ser usados no nível do conjunto de regras, de regra e da ação. Regras determinam as condições com base nas quais as ações de log são executadas. Um campo de expressão é usado para determinar os pedidos e as respostas ao log. Esta expressão usa operandos da linguagem HTTP padrão e o operando response.code para filtrar por códigos de resposta HTTP, como 404 ou 503. Por exemplo, response.code = 200 filtra todas as respostas para código de resposta 200. O operando HTTP targetserver é usado para mostrar o servidor para onde o pedido foi enviado em um formato do WebSphere Application Server. O operando de log customizado HTTP service.time é o intervalo de tempo entre o envio do pedido ao servidor de aplicativos e o recebimento de uma resposta do servidor de aplicativos. O operando de log customizado response.time é o espaço de tempo entre quando a solicitação é recebida no ODR e quando a resposta da solicitação é enviada do ODR. Para obter informações adicionais, leia sobre operandos de log customizados de HTTP.
A prioridade da regra determina a ordem da avaliação da regra. Ações de log específicas ocorrem quando as regras são correspondidas. As ações de log têm um campo continuar. Quando continue estiver configurado como true, as ações de log subsequentes poderão ser executadas. No entanto, se continue estiver configurado como false, uma vez que a ação de log for concluída, nenhuma ação de log subsequente será executada. Utilize o script manageODR.py para criar cluster e ODRs e para gerenciar a criação de log customizado. Para obter mais informações, leia sobre o script manageODR.py.
Conjunto de Regras
- name
- Especifica o nome do conjunto de regras. (Cadeia, necessário)
- type
- Especifica o tipo do conjunto de regras. (Cadeia, identificador de protocolo, como HTTP)
- continueDefault
- Determina o valor padrão de continuar. (Booleano, obrigatório)
- properties
- Opcional
- regra
- Obrigatório
regra
- name
- Especifica o nome da regra. (Cadeia, exclusiva dentro do conjunto de regras)
- priority
- Necessário, número inteiro (exclusivo dentro do conjunto de regras)
- expression
- Cadeia, requerido.
- ação
- Obrigatório.
- properties
- Opcional
Ação
- name
- Especifica o nome da ação. (Cadeia, exclusiva dentro da regra)
- priority
- Opcional, número inteiro (exclusivo dentro da regra).
- type
- Cadeia, necessário, log
- value
- Necessário. (Cadeia, contém uma série de logFormats delimitados por @. Por exemplo:
value="custom01.log %a%z@custom02.log @(#) 10 1.7@(#)Z"
- continue
- Opcional, booleano. Se não estiver configurado, será padronizado para o valor continueDefault; verdadeiro, falso.
- properties
- Opcional
customProperties
- name
- Especifica a propriedade customizada do nome. (Cadeia)
- value
- Necessário. (Sequência)
- continue
- Opcional, booleano. Se não estive configurado, é definido como padrão para o valor continueDefault; true, false.
Formato da Ação de Log
O valor de atributo ação contém um conjunto de argumentos para indicar o nome do arquivo e o formato do log. Para criar vários logs no atributo de valor, delimite os argumentos com um @. O primeiro argumento para a ação de log é o nome do arquivo de log, relativo ao diretório de logs do ODR. Os seguintes argumentos são parâmetros para especificar quais informações colocar no log. Os dados são mostrados na ordem na qual os parâmetros são especificados.
Parâmetro | Description |
---|---|
%a | Endereço IP remoto. |
%A | Endereço IP local. |
%B | Bytes enviados, excluindo cabeçalhos HTTP. |
%b | Bytes enviados, excluindo cabeçalhos HTTP. No formato CLF, isto é, um '-' em vez de um zero quando nenhum byte é enviado. |
%{FOOBAR}C | O conteúdo do cookie no pedido enviado ao servidor. |
%{FOOBAR}i | O conteúdo do Foobar: linhas de cabeçalho na solicitação enviada ao servidor. |
% I | Bytes recebidos, incluindo pedido e cabeçalhos, não podem ser zero. |
%{FOOBAR}e | O conteúdo do argumento de depuração ("-D") FOOBAR especificado para o JVM do processo do ODR. |
%h | Host remoto. |
%H | O protocolo HTTP ou HTTPS do pedido. |
%m | O método do pedido. |
%{FOOBAR}o | O conteúdo do Foobar, linhas de cabeçalho na resposta. |
%O | Bytes enviados, incluindo cabeçalhos; o número não pode ser zero. |
%p | A porta canônica do servidor que entrega o pedido. |
%q | A sequência de consultas, com o ? prefixo, se uma sequência de consultas existir. Caso contrário, será uma cadeia vazia. |
%r | Primeira linha do pedido. |
%R | Tempo de resposta em milissegundos. Tempo combinado gasto no servidor ODR e de aplicativos. |
%s | Status, código de resposta de HTTP, isto é, 503, 404, 200. |
%t | Horário, em formato de hora, formato de log comum, formato de inglês padrão. |
%{format}t | O horário, no formulário fornecido pelo formato que deve ser um formato strftime(3). Localizado potencialmente. |
%T | O horário utilizado para entregar o pedido, em milissegundos. |
%U | O caminho da URL solicitado, não incluindo nenhuma cadeia de consultas. |
%v | O ServerName canônico do servidor que entrega o pedido. |
%z | Endereço IP de destino. |
%Z | Nome do servidor de destino (célula/nó/servidor). |