Os logs customizados fornecem a flexibilidade em relação aos dados que são capturados, a maneira na qual eles são exibidos e a habilidade de ter vários logs condicionais. É possível criar conjuntos de regras para especificar os dados a serem incluídos, a ordem como são exibidos, a lógica condicional para filtrar os pedidos que são incluídos e o número e os nomes dos arquivos de log.
Os objetos de propriedade customizada são permitidos no conjunto de regras, na regra e no nível da ação. As regras são usadas para determinar as condições sobre as 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, mais operandos response.code para filtrar por códigos de resposta HTTP, como 404, 503, e assim por diante. Por exemplo, response.code = 200 capturaria todas as respostas do 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 HTTP response.time é o intervalo de tempo entre o recebimento do pedido no ODR e o envio da resposta ao pedido pelo ODR. Consulte o tópico Operandos HTTP para obter informações sobre os operandos de log customizados HTTP.
As regras tem prioridades para determinar a ordem na qual elas devem ser avaliadas. Há ações de log que são executadas quando as regras são correspondidas. As ações de log têm um campo continuar. Quando continuar=verdadeiro, as ações de log subsequentes poderão ainda ser executadas. No entanto, se continuar=falso, quando essa ação de log for concluída, nenhuma ação de log subsequente será executada. Você pode usar o script manageODR.py para criar cluster e ODRs e para gerenciamento de log customizado. Para obter informações adicionais, consulte o tópico Script manageODR.py .
O atributo de valor da 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 que os parâmetros são especificados.
Parâmetro | Descrição |
---|---|
%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 de Foobar: linha(s) do cabeçalho no pedido enviado 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 de Foobar, linha(s) do 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 cadeia de consultas, precedida com um ponto de ? se uma cadeia 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). |