[AIX Solaris HP-UX Linux Windows][z/OS]

Configurando o rastreio no plug-in do WebSphere

Configurando o rastreio, é possível definir quais informações de rastreio reunir de seu ambiente.

Sobre Esta Tarefa

Configure o rastreio no servidor da web para coletar níveis de log específicos de seu ambiente. Os logs são registrados no arquivo de log de plug-in padrão plugins_root/logs/web_server_name/http_plugin.log. Para obter informações adicionais sobre a criação de log do plug-in, leia sobre as propriedades do plug-in do WebSphere.

Existem dois tipos de processamento no plug-in: processamento de solicitação e processamento de controle. O processamento de solicitação consiste em qualquer lógica necessária para processar uma solicitação de HTTP ou a resposta HTTP a partir do servidor de origem. O processamento de controle é qualquer processamento que não cai na categoria de processamento de solicitação. Por exemplo, toda a comunicação com o serviço REST para descobrir informações de roteamento é considerada processamento de controle.

Para a configuração de rastreio, a hierarquia de precedência se aplica:
  • Hierarquia de rastreio padrão
    1. Se a especificação de rastreio padrão for configurada, será usada a especificação de rastreio de controle.
    2. Se nenhuma especificação de rastreio padrão for configurada, será usado o nível de rastreio NOTICE.
  • Hierarquia de rastreio de solicitação
    1. Se uma regra corresponder a uma solicitação, a especificação de rastreio dessa regra será usada.
    2. Se a regra não corresponder à solicitação, e a propriedade DefaultRequestTraceSpec for configurada, a especificação de rastreio na propriedade DefaultRequestTraceSpec será usada.
    3. Se a regra não corresponder à solicitação, a propriedade DefaultRequestTraceSpec não será configurada, mas se a especificação de rastreio de controle for configurada, em seguida, a especificação de rastreio de controle será usada.
    4. Se nenhuma dessas especificações for configurada, será usado o nível de rastreio NOTICE.

Use o construtor de subexpressão para construir condições de regra complexa da subexpressão usando AND, OR, NOT e agrupamento parentético. O construtor de regra valida a regra ao aplicar as mudanças, e alerta para os parênteses incompatíveis e operadores de lógica não suportados.

O operando faz parte da regra de classificação que o tempo de execução usa para corresponder uma regra a uma tarefa. Por exemplo, se você especificar um tipo de protocolo igual a HTTP, o tempo de execução procurará uma tarefa que tenha um tipo de protocolo de HTTP. A lista a seguir inclui opções de operandos:

Tabela 1. Operandos de Solicitação de HTTP
Operando Sintaxe Descrição

Host Virtual

virtualhost

Destino do host virtual da solicitação, que é usado para configurar aplicativos da web para um nome do host específico.

Porta virtual

numeric

Destino da porta virtual da solicitação, que é usado para configurar aplicativos da web para uma porta específica.

URI

uri

Identificador Uniforme de Recursos

Ajuda a identificar o caminho da solicitação: se a URL for http://host:port/path?p1=v1, o caminho será path.

ID do Usuário

userid Retorna o ID do usuário para o usuário autenticado que enviou a solicitação.

ID do Grupo

groupingid Retorna uma lista de nomes de grupos para o usuário autenticado que enviou a solicitação.

Nome do parâmetro de consulta da solicitação

queryparm$<name> O nome e do valor de um cabeçalho.
Por exemplo, a expressão queryparm$timezone='EST' testa uma solicitação para ver se a solicitação contém um parâmetro de consulta de HTTP nomeado timezone com um valor de EST. Para testar a presença ou a ausência de um parâmetro de consulta, use uma das formas a seguir:
queryparm$timezone IS NOT NULL 
queryparm$timezone IS NULL

Nome do cabeçalho da solicitação

header$<name> O nome e do valor de um cabeçalho.
Por exemplo, a expressão header$Host='localhost' testa uma solicitação para ver se ela contém um cabeçalho do host HTTP com um valor de localhost. Para testar a presença ou ausência do cabeçalho do host, use uma das expressões a seguir:
header$Host IS NOT NULL 
header$Host IS NULL

Nome do cabeçalho do cookie

cookie$<name> O nome de um cookie.
Por exemplo, a expressão cookie$My_Cookie_Name='My_Cookie_Value' testa uma solicitação para ver se ela contém um cookie nomeado My_Cookie_Name com um valor de My_Cookie_Value. Para testar a presença ou a ausência de um determinado cookie, use uma das expressões a seguir:
cookie$MyCookieName IS NOT NULL 
cookie$MyCookieName IS NULL

Método de HTTP

HTTPMethod O método de HTTP para a solicitação. Os valores possíveis são POST, GET, PUT e DELETE.

Host do cliente

clienthost O nome completo do host do cliente. Esse valor é o nome do host do comando Internet Protocol (IP). Essa operando não suporta operadores numéricos, como >, >=, <, <=.

Cliente IPV4

clientipv4 O endereço IP do cliente que usa o tipo de endereço quádruplo pontilhado do Internet Protocol versão 4 (IPv4) n.n.n.n.

Cliente IPV6

clientipv6 O tipo de endereço do Internet Protocol versão 6 (IPv6) de 128 bits de x:x:x:x:x:x:x:x seguindo a Solicitação de Comentários 1924 (RFC 1924) do computador cliente.

Host do servidor

serverhost O nome completo do host do servidor. Esse operando não suporta operadores numéricos, como >, >=, <, <=.

Servidor IPV4

serveripv4 O endereço IP do computador servidor que usa o tipo de endereço quádruplo pontilhado IPv4 n.n.n.n.

Servidor IPV6

serveripv6 O tipo de endereço IPv6 de 128 bits de x:x:x:x:x:x:x:x seguindo RFC 1924 do computador servidor.

Port

port A porta de atendimento na qual a solicitação foi recebida.

Protocolo

protocol O protocolo de comunicações que transmite a solicitação. Os protocolos suportados atualmente são HTTP, HTTPS, SOAP e SOAPS.

Tempo

time

Usado para definir a data e hora do dia que uma solicitação específica deve ser cumprida. Dois campos opcionais são StartTime e EndTime. Se uma solicitação for recebida fora da janela definida, a solicitação não será processada.

Os campos Horário de Início e Horário de Término, cada um têm o formato a seguir: dayOfWeek/dayOfMonth/month/year::hour:minute:second.

Por exemplo, quinta-feira, 11 de abril de 2007 às 13h03min45s é especificado como:

Qui/11/Abr/2007::13h03min45s

Qualquer campo pode usar um curinga com o valor *.

Por exemplo, o primeiro dia de cada mês é especificado como */1.

Os valores dayofWeek são Dom, Seg, Ter, Qua, Qui, Sex, Sáb e os valores dayOfMonth variam de 1 a 31.

O valor month é um valor não numérico que representa os doze meses: Jan, Fev, Mar, Abr, Mai, Jun, Jul, Ago, Set, Out, Nov, Dez.

O valor year é composto dos quatro dígitos do ano. Por exemplo, 2007.

O valor hour é a hora do dia no relógio de 24 horas. Por exemplo, 8h é representado como ::8. O minute e second são números inteiros que variam de 0 a 59.

A barra (/) é usada para separar parâmetros de data, os dois pontos duplos (::) é usado para separar os parâmetros de data e os dois ponto (:) é usado para separar os parâmetros de hora do dia. O resultado booleano da regra inteira, na qual o operando time é usado, determina a ação de roteamento executada.

Porcentagem

percentage$<val> O operando de porcentagem é avaliado como true, uma porcentagem fixa do tempo.

Por exemplo, percentage$50 é avaliada como true na média de 50% do tempo.

Crescimento

rampup$<startTime>$<completionTime>

  

O operando rampup é avaliado como true uma porcentagem variável do tempo. Ela é sempre avaliad como false antes de <startTime> e como true após <completionTime>. Conforme o tempo progride de <startTime> para <completionTime>, ele é avaliado como true, uma porcentagem linearmente crescente.

O formato de <startTime> e <completionTime> é dia/mês/ano::hora:min:seg.

em que day é o dia do mês, month é um dos 12 meses: Jan, Fev, Mar, Abr, Mai, Jun, Jul, Ago, Set, Out, Nov, Dez, year é o ano com quatro dígitos, hour é a hora com dois dígitos do relógio de 24 horas, min é o valor de dois dígitos para minuto e sec é o valor de dois dígitos para minuto.

Por exemplo,

rampup$01/Jan/2007::08:00:00$01/Jan/2007::17:00:00 é iniciado para ser avaliado ocasionalmente como true às 8h em 1º de jan, 2007 e é sempre avaliado como true aprimorando o tempo de conclusão às 17h do mesmo dia.

Dependendo do operador escolhido, insira um valor para a subexpressão que deseja criar. Todos os operadores são avaliados como valores booleanos. Os operadores não fazem distinção entre maiúsculas e minúsculas: AND é equivalente a AnD.

Tabela 2. Operadores de Especificação de Rastreio
Operador Descrição
Igual a Ignorar Maiúsculas e Minúsculas (EQUALSIGNORECASE) Operador Igual a ignorar maiúsculas e minúsculas. As maiúsculas e minúsculas das sequências são ignoradas. 'ABC' EQUALSIGNORECASE 'abc' é true. ('ABC' = 'abc') é false.
Não Igual (< >) O operador de não igual expressa que o valor do operando não é igual ao valor inserido.
Em (IN)
  • Para string IN list of strings será avaliada como true se a primeira sequência corresponder exatamente (fazendo distinção entre maiúsculas e minúsculas) à segunda sequência. Por exemplo:
    • 'adrian' in ('keith','eric','kalyan','david', 'adrian and etc') é false.
    • 'adrian' in ('tom','adrian') é true.
    • 'adrian' in ('Tom','Adrian') é false.
  • integer IN list of integers:
    • 1 in (1,2,3,4,5) é true.
    • 6 in (1,2,3,4,5) é false.
Semelhante (LIKE)

Expressa a correspondência de padrões para valores do operando de sequência. O valor deve conter o caractere curinga (%) na posição em que se espera que a correspondência de padrões seja iniciada.

Por exemplo, a expressão:
host LIKE %blanca
corresponde à palavrablanca e a qualquer outra palavra que termina com blanca, enquanto a expressão:
host LIKE %blanca
corresponde à palavra blanca e a qualquer outra palavra que inicia com blanca. A expressão:
host LIKE %blanca
corresponde à palavra blanca e a qualquer palavra que tenha o token blanca integrado nela.
Semelhante a Ignorar Maiúsculas e Minúsculas (LIKEIGNORECASE) Este operador expressa a correspondência de padrões para os valores do operando de sequência. As maiúsculas e minúsculas das sequências são ignoradas.
Não É Nulo (IS NOT NULL) Uma validação da consulta mostra que o parâmetro solicitado existe.
Concatenar (+) Este operador avalia 'abc'+'def' como 'abcdef'.
Semelhante em (LIKEIN) Este operador expressa string likein (string1, string2, string3,...) será avaliado como true se a sequência anterior a likein corresponder a uma ou mais sequências (stringN).
É Nulo (IS NULL) Uma validação da consulta mostra que o parâmetro solicitado não existe. Testes para um operando que possui um valor NULL.
Igual ( = ) O operador de igualdade expressa uma correspondência de distinção entre maiúsculas e minúsculas.
Maior que (>) Avaliado como o resultado lógico padrão.
Maior que ou Igual a (>=) Avaliado como o resultado lógico padrão.
Menor que (<) Avaliado como o resultado lógico padrão.
Menor que ou Igual a (<=) Avaliado como o resultado lógico padrão.
Entre (BETWEEN) Usado com AND para selecionar um intervalo de valores, inclusive do primeiro valor (baixo) e do último valor (alto). Juntos, eles operam sobre valores de números e datas.

Procedimento

Resultados

Você configurou o rastreio em seu plug-in do WebSphere.

Ícone que indica o tipo de tópico Tópico de Tarefa



Ícone de registro de data e hora Última atualização: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=twve_plugintrace
Nome do arquivo: twve_plugintrace.html