Arquivo plugin-cfg.xml
O arquivo plugin-cfg.xml contém informações sobre configuração que determina a forma como o plug-in do servidor da web encaminha solicitações.
WebSphere Application Server tradicional
É possível criar dois tipos de arquivos plugin-cfg.xml: application-centric e topology-centric.

Um arquivo de configuração centrado em aplicativos tem um aplicativo que é mapeado para ambas as definições do servidor da web e do servidor de aplicativos. As mudanças feitas no plug-in usando o console administrativo persistem no arquivo plugin-cfg.xml na geração. A configuração centrada em aplicativos oferece maior flexibilidade e suporte para funções dinâmicas, tais como o Intelligent Management.
Um arquivo centralizado na topologia representa tudo o que é definido no ambiente. Geralmente, esse arquivo plugin-cfg.xml é usado quando você não tem servidores da Web definidos.
- Se o arquivo plugin-cfg.xml existir dentro do diretório app_server_root\dmgr\cells, o processo de geração de plug-in ignorará os valores atualizados do painel do console administrativo e usará os valores existentes dentro do arquivo XML. Nesse caso, você deverá atualizar manualmente o arquivo XML para que esses valores persistam.
- Se o arquivo plugin-cfg.xml não existir dentro do diretório app_server_root\dmgr\cells, o processo de geração de plug-in criará o arquivo plugin-cfg.xml. O processo persiste os valores mais recentes que estão configurados no no console administrativo.


Liberty
É possível gerar o arquivo plugin-cfg.xml para seu servidor Liberty ao chamar o MBean WebSphere:name=com.ibm.ws.jmx.mbeans.generatePluginConfig a partir do mesmo SDK Java que o do seu servidor.
Elementos e Atributos
O arquivo plugin-cfg.xml inclui os seguintes elementos e atributos. A menos que seja indicado de outras formas, é possível especificar cada elemento e atributo apenas uma vez no arquivo plugin-cfg.xml. O elemento Config é necessário.
- Configuração
- IgnoreDNSFailures
- RefreshInterval
- ASDisableNagle
IISDisableNagle
- VHostMatchingCompat
- AppServerPortPreference
- ResponseChunkSize
- AcceptAllContent
- ChunkedResponse
- ESIEnableToPassCookies
- GetDWLMTable
OS400ConvertQueryStringToJobCCSID
- Log
- Property Name="esiEnable" Value="true/false"
- Property Name="esiMaxCacheSize" Value="integer"
- Property Name="ESIInvalidationMonitor" Value="true/false"
- Property Name="FIPSEnable" Value="true/false"
- Property Name="PluginInstallRoot" Value="C:\IBM\WebSphere\Plugins"
- ServerCluster
- VirtualHostGroup
- UriGroup
- Route
- RequestMetrics
Configuração
Esse elemento, que é obrigatório, inicia o arquivo de configuração de plug-ins HTTP.
IgnoreDNSFailures
Especifica se o plug-in ignora falhas de DNS dentro de uma configuração ao iniciar. Quando configurado como true, o plug-in ignora falhas de DNS em uma configuração e inicia com êxito se pelo menos um servidor em cada cluster de servidor puder resolver o nome de host. Qualquer servidor, para o qual o nome do host não pode ser resolvido, é marcado como indisponível para que a configuração continue a existir. Não são feitas tentativas de resolver o nome de host durante o roteamento das solicitações. Se ocorrer uma falha de DNS, será gravada uma mensagem de log no arquivo de log do plug-in e a inicialização do plug-in continuará, em vez de fazer com que o servidor da Web não inicie. O valor padrão é false, o que significa que falhas de DNS farão com que o servidor da Web não inicie.
RefreshInterval
Especifica o intervalo de tempo, em segundos, no qual o plug-in verificará o arquivo de configuração para ser se atualizações ou mudanças ocorreram. O plug-in verifica no arquivo se ocorreram quaisquer modificações desde a última vez que a configuração do plug-in foi carregada.
ASDisableNagle
Especifica se o usuário deseja desativar o algoritmo de Nagle para a conexão entre o plug-in e o servidor de aplicativos. Por padrão. o algoritmo de Nagle é ativado.
O valor pode ser true ou false.
![[Windows]](../images/windows.gif)
IISDisableNagle
Especifica se o usuário deseja desativar o algoritmo de Nagle nos Microsoft Internet Information Services (IIS). Por padrão. o algoritmo de Nagle é ativado.
O valor pode ser true ou false.
VHostMatchingCompat
- true se a correspondência for feita fisicamente, utilizando o número da porta para a qual o pedido foi recebido.
- false se a correspondência precisar ser feita logicamente usando o número da porta contido no cabeçalho do host.
O valor padrão é false.
AppServerPortPreference
- hostHeader se o número da porta do cabeçalho do host do pedido HTTP que chega tiver de ser utilizado.
- webserverPort se o número da porta na qual o servidor da Web recebeu a solicitação for utilizado.
O valor padrão é hostHeader.
ResponseChunkSize
Especifica o tamanho máximo da parte a ser usado ao ler o corpo de resposta. Por exemplo,especifique Config ResponseChunkSize="N">, em que N é igual ao tamanho do chunk em kilobytes.
O plug-in lê o corpo de resposta em partes de 64 K até que todos os dados de resposta sejam lidos. Essa abordagem causa um problema de desempenho para pedidos cujo corpo de resposta contém grandes quantidades de dados.
Se o tamanho do conteúdo do corpo de resposta for desconhecido, um tamanho de buffer de N KBs será alocado e o corpo será lido em partes de N KB de tamanho, até que todo o corpo seja lido. Se o comprimento do conteúdo for conhecido, um tamanho de buffer com o comprimento do conteúdo ou N (o que for menor) será usado para ler o corpo de resposta.
O tamanho da parte padrão é de 64 K.
AcceptAllContent
- True se o conteúdo for esperado e estiver pronto para todas as solicitações
- False se o conteúdo for esperado e estiver pronto apenas para as solicitações POST e PUT.
O valor padrão é True.
ChunkedResponse
Especifica se o plug-in deve usar partes da resposta ao cliente quando o cabeçalho da resposta Transfer-Encoding: Chunked estiver presente na resposta.
Esse atributo aplica-se apenas aos servidores da web IIS, Oracle iPlanet e Lotus Domino. O IBM® HTTP Server manipula automaticamente as partes da resposta no cliente.
É possível especificar um dos valores a seguir para esse atributo:
- true se o plug-in deve truncar a resposta ao cliente quando há uma Codificação de Transferência : Cabeçalho da resposta truncado está presente na resposta.
- false se a resposta não dever ser truncada.
O valor padrão é false.
ESIEnableToPassCookies
Especifica se permitir o encaminhamento de cookies de sessão para WebSphere Application Server ao processar solicitações de inclusão de ESI. Se o valor for configurado como true, essa propriedade customizada será ativada. Se o valor for configurado como false, a propriedade customizada será desativada. Por padrão, o valor é configurado como false.
GetDWLMTable
Especifica se permitir um processo de plug-in recentemente criado para solicitar proativamente uma tabela de partições de WebSphere Application Server antes da manipulação de qualquer solicitação de HTTP. Essa propriedade customizada é utilizada apenas quando o gerenciamento de sessões memória a memória é configurado. Se o valor for configurado como true, essa propriedade customizada será ativada. Se o valor for configurado como false, a propriedade customizada será desativada. Por padrão, o valor é configurado como false.
![[IBM i]](../images/iseries.gif)
OS400ConvertQueryStringToJobCCSID
Especifica se a sequência de consultas para uma solicitação de HTTP é convertida na Página de Códigos de Tarefa do IBM HTTP Server ou na Página 37 de Códigos EBCDIC para processamento interno. O valor padrão é false, significando que a sequência de consultas deve ser convertida para a Página de Códigos 37 EBCDIC.
TrustedProxyEnable
Permite que o plug-in de servidor da Web interaja com os servidores proxy e balanceadores de carga que estão listados para a propriedade customizada TrustedProxyList. Quando essa propriedade é configurada para true, os servidores proxy e os balanceadores de carga nessa lista de proxies confiáveis poderão configurar valores para os cabeçalhos internos $WSRA e $WSRH. O cabeçalho interno $WSRA é o endereço IP do host remoto, que geralmente é o navegador ou um endereço interno obtido pelo Network Address Translation (N.A.T.). O cabeçalho interno $WSRH é o nome de host do host remoto. Estas informações do cabeçalho permitem que o plug-in de servidor da Web interaja com esse servidor proxy ou balanceador de carga específico.
Ao usar esta propriedade customizada, você também deve usar a propriedade customizada TrustedProxyList para especificar uma lista de servidores proxy e balanceadores de carga confiáveis. Além disso, você deve limpar a caixa de opção Remover Cabeçalhos Especiais no painel Roteamento de Pedido no console administrativo. Para obter informações adicionais, consulte a documentação sobre propriedades de roteamento de pedido do plug-in de servidor da Web.
TrustedProxyList
Especifica uma lista delimitada por vírgula de todos os servidores proxy ou balanceadores de carga que têm permissão para efetuar interface com esse plug-in de servidor da Web. Você deve usar essa propriedade com a configuração de propriedade customizada TrustedProxyEnable=true. Se a propriedade customizada TrustedProxyEnable estiver configurada comofalse, essa lista será ignorada.
SSLConsolidate
Especifica se o plug-in de servidor da Web precisa comparar a configuração de cada novo transporte SSL com a configuração de outros transportes SSL já definidos no arquivo de configuração. Ao configurar esta propriedade para true e o plug-in determinar que os valores do keyring e de CertLabel especificados para o novo transporte SSL corresponderem aos valores especificados para um transporte SSL já definido, o plug-in usará o ambiente SSL existente em vez de criar um novo ambiente SSL. A criação de poucos ambientes SSL significa que o plug-in requer menos memória e o tempo de inicialização do plug-in diminui, otimizando assim o ambiente geral de GSkit.
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
SSLPKCSDriver
Especifica o nome completo do módulo carregável que faz interface com um coprocessador SSL opcional. O nome completo deve incluir o caminho de diretório e o nome do módulo.
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
SSLPKCSPassword
Especifica a senha para o coprocessador SSL com o qual o módulo, especificado para a propriedade customizada SSLPKCSDriver, está estabelecendo interface.
Se você estiver usando um IBM HTTP Server, poderá usar o programa sslstash para criar um arquivo que contenha essa senha. Nessa situação, você pode especificar o nome completo desse arquivo, em vez da senha real, como o valor para essa propriedade customizada.
Log
Descreve o local e o nível de mensagens de log gravadas pelo plug-in. Se um elemento de log não for especificado no arquivo de configuração, em alguns casos, mensagens de log serão gravadas para o log de erros do servidor da Web.
Por exemplo, você pode especificar a seguinte linha de código:
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
![[IBM i]](../images/iseries.gif)
<Log LogLevel="Error" Name="/opt/WebSphere/AppServer60/logs/http_plugin.log"/>
![[z/OS]](../images/ngzos.gif)
<Log LogLevel="Error" Name="/log_directory/file_name"/>
- Nome
Especifica o caminho completo para o arquivo de log no qual o plug-in grava mensagens de erro. Especifique exatamente um atributo para cada log.
Se o arquivo não existir, um será criado. Se ele existir, será aberto no modo Anexar e as mensagens de log de plug-in anteriores permanecerão.
Para Usuários de Transição: Um registro de data e hora e o ID do processo não são mais anexados ao nome que é especificado para o arquivo de log do plug-in a partir da Versão 7. Portanto, um único arquivo de log de plug-in do servidor da web é criado ao invés de diversos arquivos de log que são diferenciados por data.trns
- LogLevel
Especifica o nível de detalhes das mensagens de log que o plug-in grava no log. Especifique zero ou um dos seguintes valores para cada log.
Valor do Nível de Log Descrição do Nível de Log Rastreio Todas as etapas do processo de pedido são registradas em detalhes. Estatísticas O servidor selecionado para cada pedido e outras informações de equilíbrio de carga relacionadas ao tratamento do pedido são registrados. Aviso Todas as mensagens de aviso e erro que resultam do processamento de solicitações anormais que são registradas Erro Apenas mensagens de erro que resultam do processamento de solicitações anormais são registradas Depuração Todas as etapas críticas executadas no processamento de pedidos são registradas. Detalhe Todas as informações sobre pedidos e respostas são registradas. Se um valor LogLevel não for especificado para o elemento Log, o valor padrão, Erro, será usado.
Evitar Problemas: Tenha cuidado ao definir o nível como Rastreio. Várias mensagens são registradas nesse nível, o que pode consumir rapidamente espaço em disco. Não use uma configuração Rastreio em um ambiente que funciona normalmente, pois isso afeta adversamente o desempenho.gotcha
Evitar Problemas: Tenha cuidado ao definir o nível como Rastreio. Várias mensagens são registradas nesse nível, o que pode consumir rapidamente o sistema de arquivos. Não use uma configuração Rastreio em um ambiente que funciona normalmente, pois isso afeta adversamente o desempenho.gotcha
Property Name="esiEnable" Value="true/false"
Ativa ou desativa o processador Edge Side Include (ESI). Se o processador ESI estiver desativado, os outros elementos do ESI nesse arquivo são ignorados.
É possível configurar Value como true ou false. Por padrão, o processador ESI é desativado com seu valor configurado como false.
Property Name="esiMaxCacheSize" Value="integer"
Especifica, em unidades de 1 KB, o tamanho máximo do cache. O tamanho máximo padrão do cache é 1024 KB (1 MB). Se o cache estiver cheio, a primeira entrada excluída do cache será a entrada mais próxima de seu prazo de expiração.
Property Name="ESIInvalidationMonitor" Value="true/false"
Especifica se o processador ESI recebe invalidações do servidor de aplicativos.
É possível configurar Value como true ou false. Por padrão, essa propriedade é definida como false.
Property Name="FIPSEnable" Value="true/false"
Especifica se Federal Information Processing Standard (FIPS) está ativado para fazer conexões Secure Sockets Layer (SSL) com o servidor de aplicativos. Configure essa propriedade como true, se o FIPS estiver ativado no servidor de aplicativos.
É possível configurar o valor Value como true ou false. Por padrão, essa propriedade é definida como false.
Property Name="PluginInstallRoot" Value="C:\IBM\WebSphere\Plugins"
Especifica o caminho da instalação para o plug-in. Essa propriedade será obrigatória se o Global Security Kit (GSKit) estiver sendo usado, pois WebSphere Application Server suporta a instalação local do GSKit em vez de uma instalação global. O valor de atributo é configurado como um caminho completo para a raiz de instalação do plug-in.
Os nomes suportados reconhecidos pelo transporte são keyring, stashfile e password. Por padrão, esta propriedade é configurada como none.
ServerCluster
Especifica um grupo de servidores que são geralmente configurados para atender aos mesmos tipos de solicitações. Especifique um ou mais clusters para cada configuração.
No caso mais simples, o cluster contém apenas uma definição de servidor. No caso no qual mais de um servidor está definido, a carga do plug-in é equilibrada nos servidores definidos usando um algoritmo Round Robin ou aleatório. O algoritmo padrão é Round Robin.
O seguinte código é um exemplo de um elemento ServerCluster.
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
![[IBM i]](../images/iseries.gif)
<ServerCluster Name="Servers">
<ClusterAddress Name="ClusterAddr">
<Transport Hostname="192.168.1.2" Port="9080" Protocol="HTTP"/>
<Transport Hostname="192.168.1.2" Port="9443" Protocol="HTTPS">
<Property Name="Keyring" value="c:/WebSphere/AppServer/keys/keyring.kdb"/>
<Property Name="Stashfile" value="c:/WebSphere/AppServer/keys/keyring.sth"/>
</Transport>
</ClusterAddress>
<Server Name="Server1">
<Transport Hostname="192.168.1.3" Port="9080" Protocol="HTTP"/>
<Transport Hostname="192.168.1.3" Port="9443" Protocol="HTTPS">
<Property Name="Keyring" value="c:/WebSphere/AppServer/keys/keyring.kdb"/>
<Property Name="Stashfile" value="c:/WebSphere/AppServer/keys/keyring.sth"/>
</Transport>
</Server>
<Server Name=Server2>
<Transport Hostname="192.168.1.4" Port="9080" Protocol="HTTP"/>
<Transport Hostname="192.168.1.4" Port="9443" Protocol="HTTPS">
<Property Name="Keyring" value="c:/WebSphere/AppServer/keys/keyring.kdb"/>
<Property Name="Stashfile" value="c:/WebSphere/AppServer/keys/keyring.sth"/>
</Transport>
</Server>
<Server Name="Server3">
<Transport Hostname="192.168.1.5" Port="9080" Protocol="HTTP"/>
<Transport Hostname="192.168.1.5" Port="9443" Protocol="HTTPS">
<Property Name="Keyring" value="c:/WebSphere/AppServer/keys/keyring.kdb"/>
<Property Name="Stashfile" value="c:/WebSphere/AppServer/keys/keyring.sth"/>
</Transport>
</Server>
<PrimaryServers>
<Server Name="Server1"/>
<Server Name="Server2"/>
</PrimaryServers>
<BackupServers>
<Server Name="Server3"/>
</BackupServers>
</ServerCluster>
![[z/OS]](../images/ngzos.gif)
<ServerCluster CloneSeparatorChange="false"
LoadBalance="Round Robin" Name="Cluster1"
PostSizeLimit="10000000" RemoveSpecialHeaders="true"
RetryInterval="60">
<Server
CloneID="BA36BEC1EB243D8B000000E4000000030926301B"
ConnectTimeout="0" ExtendedHandshake="false"
LoadBalanceWeight="2" MaxConnections="0"
Name="SY1_ClusterMember1" WaitForContinue="false">
<Transport Hostname="BOSSXXXX.PLEX1.L2.IBM.COM" Port="9084" Protocol="http"/>
<Transport Hostname="BOSSXXXX.PLEX1.L2.IBM.COM" Port="0" Protocol="https">
<Property Name="Keyring" value="safkeyring:///mzjring1/"/>
<Property Name="Stashfile" value=""""/>
<Property Name="certLabel" Value="selfsigned"/>
</Transport>
</Server>
<Server CloneID="BA36BED017FDF40E000000E4000000030926301B"
ConnectTimeout="0" ExtendedHandshake="false"
LoadBalanceWeight="2" MaxConnections="0"
Name="SY1_ClusterMember2" WaitForContinue="false">
<Transport Hostname="BOSSXXXX.PLEX1.L2.IBM.COM" Port="9085" Protocol="http"/>
<Transport Hostname="BOSSXXXX.PLEX1.L2.IBM.COM" Port="0" Protocol="https">
<Property Name="Keyring" value="safkeyring:///mzjring1/">
<Property Name="Stashfile" value=""""/>
<Property Name="certLabel" Value="selfsigned"/>
</Transport>
</Server>
<PrimaryServers>
<Server Name="SY1_ClusterMember1"/>
<Server Name="SY1_ClusterMember2"/>
</PrimaryServers>
</ServerCluster>

O pacote z/OS PTF UK35083 inclui a mudança da interface SSL para o z/OS HTTP Server, Versão 5.3, que corresponde a essa mudança de plug-in de servidor da web. Portanto, você deve aplicar esse PTF ao seu sistema antes que a interface SSL do novo plug-in do servidor da Web possa funcionar corretamente.
Você também deve incluir a opção SSLMODE=MULTI no arquivo httpd.conf para o IBM HTTP Server para z/OS, Versão 5.3. A opção SSLMODE=ON não é suportada na Versão 7.0 ou superior.
Se a opção SSLMode multi não for especificada no arquivo httpd.conf ou se você não possuir o pacote z/OS PTF UK35083 aplicado ao sistema, poderá receber a mensagem de erro IMW0584W. Essa mensagem indica que o modo SSL, que é especificado para o Servidor HTTP, não é compatível com o modo SSL para o plug-in de servidor da web usado com o IBM HTTP Server para z/OS, Versão 5.3. Em qualquer uma dessas situações, resultados imprevisíveis poderão ocorrer.
- Se você usar um arquivo kdb com um arquivo stash no Sistema de Arquivo Hierárquico (HFS), especifique os elementos Property
Name=keyring e Property Name=stashfile, como mostrado no exemplo anterior.
Evitar Problemas: O formato dos valores especificados para esses elementos é diferente do que foi especificado em versões anteriores do produto.gotcha
- Se você usar um conjunto de chaves System Authorization Facility (SAF), em vez de um arquivo kdb, deverá criar as seguintes duas propriedades de plug-in customizadas a partir do console administrativo:
- KeyringLocation
- Especifique o local do diretório do conjunto de chaves SAF como o valor para esta propriedade. Ao salvar esta mudança na configuração, esse local de diretório se torna o valor da propriedade do conjunto de chaves no arquivo plugin-cfg.xml.
- StashfileLocation
- Especifique """"(null) como o valor para esta propriedade. Ao salvar esta mudança na configuração, """"(null) se torna o valor da propriedade stashfile no arquivo plugin-cfg.xml
Consulte Propriedades de Configuração do Plug-in do Servidor da Web para obter instruções sobre como criar KeyringLocation e StashfileLocation a partir do console administrativo.
Use o seguinte exemplo para o conjunto de chaves SAF:<Transport Hostname="appserver.example.com" Port="9443" Protocol="https"> <Property name="keyring" value="safkeyring:///SAF_keyring_name"/> <Property Name="stashfile" value=""""/> </Transport>
- Nome
Especifica o nome lógico ou administrativo que será usado para este grupo de servidores. Especifique um atributo para cada ServerCluster.
- LoadBalance
Os seguintes valores podem ser especificados para este atributo:
Round Robin
Aleatório
A implementação de Round Robin possui um ponto inicial aleatório. O primeiro servidor de aplicativos será selecionado aleatoriamente. Round Robin será utilizado para selecionar servidores de aplicativos daí em diante. Essa implementação garante que em diversos servidores da web baseados no processo, todos os processos não são iniciados enviando a primeira solicitação ao mesmo Servidor de Aplicativos.
A implementação Random também possui um ponto inicial aleatório. No entanto, com essa implementação, todos os servidores subsequentes também são selecionados aleatoriamente. Portanto, o mesmo servidor pode ser selecionado repetidamente, enquanto outros servidores permanecem inativos.
O tipo de equilíbrio de carga padrão é Round Robin.
- IgnoreAffinityRequests
Especifica se o plug-in ignora o número de pedidos de afinidade feitos para um servidor ao selecionar os servidores com base no algoritmo Round Robin. Especifique zero ou um atributo para cada ServerCluster. O valor é true ou false. Se o valor for configurado para false, o número de pedidos de afinidade feitos também será considerado no processo de seleção do servidor.
O valor padrão é false, o que significa que o número de solicitações de afinidade feitas é usado no algoritmo Round Robin.
Para Usuários de Transição: Para os usuários em transição: Esta é uma mudança em relação às versões anteriores do produto. O valor padrão é true nas versões anteriores do WebSphere Application Server.trns
- RetryInterval
Especifica um valor de número inteiro para a duração de tempo decorrida a partir da hora em que um servidor é marcado como inativo até a hora em que o plug-in tenta uma conexão novamente. O padrão é 60 segundos. Especifique zero ou um atributo para cada ServerCluster.
- RemoveSpecialHeaders
O plug-in inclui cabeçalhos especiais no pedido antes que ele seja redirecionado para o servidor de aplicativos. Esses cabeçalhos armazenam informações sobre a solicitação usada pelo aplicativo. Por padrão, o plug-in remove esses cabeçalhos das solicitações recebidas antes de incluir os cabeçalhos que o plug-in deve incluir. Especifique zero ou um atributo para cada ServerCluster.
O valor pode ser true ou false. Definir o atributo como false introduz um risco de segurança potencial por não remover cabeçalhos de pedidos de entrada.
- CloneSeparatorChange
Informa ao plug-in para esperar o caractere mais (+) como o separador de clone. Alguns dispositivos interativos não podem manipular o caractere de dois pontos (:) utilizado para separar IDs de clone em conjunto com afinidade de sessão. É preciso alterar as configurações dos servidores de aplicativos de modo que um servidor de aplicativos também separe IDs de clone com o caractere de mais. Especifique zero ou um atributo para cada ServerCluster.
O valor pode ser true ou false.
- PostSizeLimit
O número máximo de blocos de KBs (1024 byte) do conteúdo da solicitação permitido para que o plug-in tente enviar a solicitação para um servidor de aplicativos. Se for recebido um pedido maior que esse tamanho, o plug-in falhará o pedido. O valor padrão é -1 byte, o que indica que não há limite para o tamanho da postagem. Especifique zero ou um atributo para cada ServerCluster.
- PostBufferSize
Especifica, em KBs, o tamanho máximo do buffer usado quando o conteúdo de uma solicitação de HTTP é lido. Se o servidor de aplicativos que recebe inicialmente uma solicitação não puder processar essa solicitação, os dados contidos nesse buffer serão enviados para outro servidor de aplicativos. Ele tentará então fazer com que o servidor de aplicativos processe a solicitação. É possível configurar essa opção como zero, se não desejar que as solicitações que possuem conteúdo sejam armazenadas em buffer e, em seguida, tentadas novamente.
Esta opção aprimora a disponibilidade do plug-in. Quando essa opção estiver configurada como um valor diferente de zero, os pacotes pendentes que contêm uma carga útil serão reenviados, se o servidor de aplicativos selecionado não responder.
Tipicamente, as solicitações POST e PUT transportam uma carga útil, mas outras solicitações também poderão transportar uma carga útil. Mesmo que uma solicitação POST ou PUT não tenha uma carga útil, ela será tentada, se o valor especificado para essa opção não for zero.
O valor padrão é 0. Especifique zero ou um atributo para cada ServerCluster.
- ServerIOTimeoutRetry
Especifica um limite para o número de vezes que o plug-in de HTTP tentar novamente uma solicitação de HTTP que tenha atingido o tempo limite, devido ao ServerIOTimeout. O valor padrão, -1, indica que nenhum limite adicional se aplica ao número de novas tentativas. Um valor 0 indica que não há novas tentativas. As novas tentativas não sempre limitadas pelo número de servidores disponíveis no cluster.
Importante: Esta diretiva não se aplica às falhas de conexão ou aos tempos limites, devido ao plug-in de HTTP ConnectTimeout. - Servidor Especifica uma instância do WebSphere Application Server que está configurada para manipular solicitações roteadas para ela, com base nas regras de configuração de plug-in. O servidor corresponde a um servidor de aplicativos em execução na máquina local ou em uma máquina remota. Especifique zero ou um atributo para cada ServerCluster.
- Nome
Especifica o nome administrativo ou lógico do servidor. Especifique exatamente um atributo para cada Server.
- CloneID
Se esse ID exclusivo estiver presente no cabeçalho de cookie de HTTP de uma solicitação, ou se a URL estiver usando a regravação de URL, o plug-in roteará a solicitação para este servidor específico, desde que todas as outras regras de roteamento sejam atendidas. Se um CloneID não estiver especificado no servidor, a afinidade de sessão não será ativada para esse servidor. Pode haver zero ou um atributo para cada Server.
Esse atributo é usado com a afinidade de sessão. Quando este atributo é definido, o plug-in verifica o cabeçalho do cookie ou URL de entrada quanto a JSESSIONID. Se JSESSIONID for localizado, o plug-in procurará por um ou mais IDs de clone. Se forem localizados IDs de clone e for feita uma correspondência ao valor especificado para esse atributo então, o pedido será enviado a esse servidor em vez de ser utilizado o equilíbrio de carga pelo cluster.
Boas Práticas: Se você não estiver usando a afinidade de sessão, remova esses IDs de clone da configuração, pois existe processamento de solicitação incluído no plug-in quando esses valores são configurados. Se os IDs de clone não estiverem no plug-in, assume-se que a afinidade de sessão não esteja ativada, e a solicitação terá balanceamento de carga no cluster.bprac
- WaitForContinue
Especifica se usar o suporte HTTP 1.1 100 Continue antes de enviar o conteúdo da solicitação para o servidor de aplicativos. Os valores de atributos possíveis são true ou false. O valor padrão é false; o plug-in não aguarda pela resposta 100 Continue do servidor de aplicativos antes de enviar o conteúdo da solicitação, pois ela é uma ocorrência de desempenho. Especifique zero ou um atributo para cada Server.
Essa propriedade será ignorada para solicitações POST, para evitar uma falha de ocorrência se o servidor de aplicativos fechar uma conexão devido a um tempo limite keep-alive.
Ative essa função true ao configurar o plug-in para funcionar com determinados tipos de firewalls de proxy.
- LoadBalanceWeight
Especifica o peso associado a este servidor quando o plug-in executa um balanceamento de carga Round Robin com peso. Especifique zero ou um atributo para cada Server. O valor inicial de um servidor pode ser qualquer inteiro entre 0 e 20. No entanto, especifique zero apenas para um servidor que não esteja executando.
O valor LoadBalanceWeight para cada servidor é diminuído para cada solicitação processada por esse servidor. Depois que o peso de um determinado servidor em um cluster de servidores chega a zero, apenas os pedidos com afinidade de sessão são roteados para esse servidor. Quando todos os servidores no cluster atingirem um peso zero, os pesos de todos os servidores no cluster serão reconfigurados e o algoritmo reiniciará.
Boas Práticas: Quando um servidor não estiver executando, configure o peso desse servidor para zero. O plug-in poderá, então, redefinir os pesos dos servidores que ainda estão em execução e manter o equilíbrio de carga adequado.bprac
- ConnectTimeout
Ativa o plug-in para executar conexões não bloqueadoras com o servidor de aplicativos. As conexões não bloqueadoras são benéficas quando o plug-in é incapaz de entrar em contato com o destino para determinar se a porta está ou não disponível. Especifique zero ou um atributo para cada Server.
Se um valor ConnectTimeout não for especificado ou configurado como 0, o plug-in executará uma conexão de bloqueio na qual o plug-in permanece até que um sistema operacional atinja o tempo limite (mais de 2 minutos, dependendo da plataforma) e permitirá que o plug-in marque o servidor como indisponível. Um valor 0 faz com que o plug-in execute uma conexão de bloqueio. Um valor maior do que 0 especifica o número de segundos que o plug-in deve aguardar por uma conexão bem-sucedida. Se uma conexão não ocorrer após esse intervalo de tempo, o plug-in marcará o servidor como indisponível e executará failover em um dos outros servidores definidos no cluster.
O valor padrão é 5.
- ExtendedHandshake
É usado quando um firewall proxy está entre o plug-in e o servidor de aplicativos. Nesses casos, o plug-in não está efetuando failover, conforme esperado. Especifique zero ou um atributo para cada Server.
O plug-in marca um servidor como inativo quando o método connect() falha. No entanto, quando um firewall proxy está entre o plug-in e o servidor de aplicativos, o método connect() será bem-sucedido, apesar de o servidor de aplicativos de backend estar inativo. Isso faz com que o plug-in não efetue failover corretamente para outros servidores de aplicativos.
O plug-in executa algum protocolo de reconhecimento com o servidor de aplicativos para assegurar que ele tenha iniciado antes de enviar o pedido. Esse cenário ativa o plug-in para failover no caso de inatividade do servidor de aplicativos.
O valor pode ser true ou false.
- MaxConnections
Especifica o número máximo de conexões pendentes para um servidor de aplicativos que podem fluir por um processo do servidor da Web a qualquer momento. Especifique um elemento para cada Server.
Por exemplo, no seguinte cenário:- O servidor de aplicativos está entre cinco nós que estão executando um IBM HTTP Server.
- Cada nó inicia dois processos.
- O atributo MaxConnections está definido para 50.
Nesse exemplo, o servidor de aplicativos poderia obter até 500 conexões. Multiplique o número de nós, 5, pelo número de processos, 2, e depois multiplique esse número pelo número especificado para o atributo MaxConnections, 50, para um total de 500 conexões.
Esse atributo não é necessário no sistema operacional z/OS. O controlador do z/OS que funciona com o Workload Manager (WLM), manipula novas conexões dinamicamente.
Por padrão, MaxConnections está definido para -1. Se esse atributo estiver configurado para zero ou -1, não haverá limite para o número de conexões pendentes para servidores de aplicativos.
- Transport
Especifica o transporte para solicitações de leitura e gravação para uma determinada instância do WebSphere Application Server. O transporte fornece as informações necessárias para determinar o local do servidor de aplicativos para o qual a solicitação é enviada. O plug-in não pode reconhecer quando vários transportes estão definidos para usar o mesmo protocolo. O transporte que o plug-in seleciona não pode ser predito. O plug-in sempre seleciona o primeiro transporte que ele encontra em seu processamento. Especifique um ou mais elementos para cada Server.
É possível configurar o servidor para ter um transporte não seguro e um que use SSL. Nessa configuração, uma correspondência do protocolo de solicitação recebida é executada para determinar o transporte adequado para usar ao enviar a solicitação para o servidor de aplicativos.
- Nome do Host
Especifica o nome de host ou endereço IP da máquina na qual a instância do WebSphere Application Server está executando. Existe exatamente um atributo para cada Transport.
- Porta
Especifica a porta na qual a instância do WebSphere Application Server está atendendo. Existe exatamente um atributo para cada Transport.
- Protocolo
Especifica o protocolo para usar ao se comunicar usando este transporte -- HTTP ou HTTPS. Existe exatamente um atributo para cada Transport.
- Nome do Host
- PropertyEspecifique zero, um ou mais elementos para cada Transport. Quando o protocolo do transporte é configurado para HTTPS, use esse elemento para fornecer os diversos parâmetros de inicialização, como senha, conjunto de chaves e arquivo stash. Por exemplo, a parte do arquivo plugin-cfg.xml que contém esses elementos pode se assemelhar ao seguinte código:
<Transport Hostname="192.168.1.2" Port="9443" Protocol="HTTPS"> <Property Name="keyring" value="c:/WebSphere/AppServer/keys/keyring.kdb"/> <Property Name="stashfile" value="c:/WebSphere/AppServer/keys/keyring.sth"/> <Property Name="password" value="WebAS"/>
- Nome
Especifica o nome da propriedade que está sendo definida. Os nomes suportados reconhecidos pelo transporte são keyring, stashfile e password.
Especifique exatamente um atributo para cada Property.Evitar Problemas: O único nome que pode ser especificado para o plug-in de HTTP do WebSphere para z/OS é senha. Se você especificar keyring e stashfile, eles serão ignorados.gotcha
- Valor
Especifica o valor da propriedade que está sendo definida. Especifique exatamente um atributo para cada Property.
- Nome
- ServerIOTimeout
Permite que o plug-in configure um valor de tempo limite, em segundos, para enviar solicitações e ler respostas do servidor de aplicativos.
Se você configurar o atributo ServerIOTimeout como um valor positivo, esta tentativa de contactar o servidor será encerrada quando ocorrer o tempo limite. No entanto, o servidor não é considerado indisponível e futuras solicitações ainda serão enviadas para o servidor no qual ocorreu o tempo limite indisponível.
Se você configurar o atributo ServerIOTimeout para um valor negativo, o servidor será considerado indisponível sempre que ocorrer um tempo limite e nenhuma solicitação futura será enviada para o servidor no qual ocorreu o tempo limite.
Se um valor não estiver configurado para o atributo ServerIOTimeout, o plug-in, por padrão, usará a E/S bloqueada para gravar as solicitações no, e ler as respostas a partir do, servidor de aplicativos sem atingir o tempo limite da conexão TCP. Por exemplo, é possível especificar a seguinte configuração:
<Server Name="server1" ServerIOTimeout=300>
Neste caso, se um servidor de aplicativos parar de responder a pedidos, o plug-in esperará 300 segundos (5 minutos) antes de expirar a conexão TCP. Configurar o atributo ServerIOTimeout para um valor razoável permitirá que o plug-in atinja o tempo limite de conexão mais brevemente e transfira solicitações para outro servidor de aplicativos quando possível.
Ao selecionar um valor para esse atributo, lembre-se de que, às vezes, isso pode levar alguns minutos até que um servidor de aplicativos processe uma solicitação. A configuração do valor muito baixo do atributo ServerIOTimeout pode fazer com que o plug-in envie uma resposta de erro de servidor falsa ao cliente.
O valor padrão é 900, que é equivalente a 15 minutos.
Evitar Problemas: O ServerIOTimeout limita a quantia de tempo que o plug-in aguarda até que cada operação de leitura ou gravação seja retornada. O ServerIOTimeout não representa um tempo limite para a solicitação geral.gotcha
Para obter recomendações adicionais sobre como configurar o atributo ServerIOTimeout, consulte a nota técnica de configuração do plug-in do servidor da web no webite de Suporte da IBM.
Nem todas as solicitações e respostas de leitura no servidor de aplicativos exigem as mesmas regras para atingir o tempo limite do ServerIOTimeout, ServerIOTimeoutRetry, e Extended Handshake / 100 Continue. Nem toda a URL se comporta da mesma forma e, quando processada, pode haver a necessidade de atingir mais rápido o tempo limite de uma solicitação, ou não repetir uma solicitação para cada servidor. É possível designar URLs específicas que usarão um ServerIOTimeout modificado, ServerIOTimeoutRetry ou tempo limite abreviado para ExtendedHandshake ou 100-Continues. Outras URLs (não tão modificadas) continuam a usar os valores especificados dentro do arquivo Plugin-cfg.xml.
Para designar uma URL para o processamento deste tempo limite modificado, modifique o arquivo httpd.conf usando as diretivas SetEnvIf. Como as propriedades disponíveis no arquivo Plugin-cfg.xml, o websphere-serveriotimeout e o websphere-serveriotimeoutretry podem aceitar os mesmos valores. É possível configurar o WebSphere-shorten-handshake apenas para um "1". Isto informará o plug-in para usar o valor ConnectTimeout como o tempo de espera para respostas ExtendedHandshake ou 100-Continue. Por exemplo,SetEnvIf Request_URI "\.jsp$" websphere-serveriotimeout=10 SetEnvIf Request_URI "\.jsp$" websphere-serveriotimeoutretry=-1 SetEnvIf Request_URI "\.jsp$" websphere-shorten-handshake=1
- Nome
- wsServerIOTimeout
Esse atributo configura um valor de tempo limite, em segundos, para ações pendentes de leitura e gravação entre o plug-in de servidor da web e um aplicativo WebSocket. Quando o valor especificado é excedido, os recursos mantidos por um servidor de aplicativos não respondente são liberados.
O valor padrão é 30 segundos.
- wsServerIdleTimeout
Esse atributo configura um valor de tempo limite, em segundos, em que uma conexão entre o plug-in de servidor da web e um aplicativo WebSocket pode permanecer inativa. Quando o valor especificado é excedido, recursos mantidos pelo servidor de aplicativos são liberados.
O valor padrão é 900 segundos.
- ClusterAddress
Um ClusterAddress é como um elemento de servidor no qual é possível especificar os mesmos atributos e elementos de um elemento do servidor. A diferença é que você pode definir apenas um deles em um ServerCluster. Utilize um ClusterAddress quando não quiser que o plug-in execute nenhum tipo de equilíbrio de carga porque já existe algum tipo de equilibrador de carga entre o plug-in e o servidor de aplicativos.
Evitar Problemas: Se você incluir uma tag ClusterAddress, deverá incluir o atributo Name nessa tag. O plug-in usa o atributo Name para associar o endereço do cluster com o host e porta corretos. Se você não especificar o atributo Name, o plug-in designará ao endereço de cluster o nome especificado para o servidor que está usando o mesmo host e porta.
gotcha<ClusterAddress Name="MyClusterAddr"> <Transport Hostname="192.168.1.2" Port="9080" Protocol="HTTP"/> <Transport Hostname="192.168.1.2" Port="9443" Protocol="HTTPS"> </ClusterAddress>
Se for recebido um pedido que não tenha a afinidade estabelecida, o plug-in o roteará para o endereço do cluster, quando definido. Se a afinidade tiver sido estabelecida, o plug-in roteará o pedido diretamente para o clone, ignorando completamente o endereço do cluster. Se nenhum endereço de cluster estiver definido para o cluster do servidor, a carga do plug-in é balanceada pelos servidores na lista de servidores primários.
Poder haver zero ou um elemento para cada ServerCluster.
- PrimaryServers
Especifica uma lista de servidores à qual o plug-in roteia os pedidos para esse cluster. Se não for especificada uma lista de servidores primários, o plug-in roteia os pedidos para os servidores definidos para o cluster de servidores. Especifique zero ou um atributo para cada ServerCluster.
- BackupServers
Especifica uma lista de servidores para os quais solicitações são enviadas se todos os servidores especificados na lista de servidores primários estiverem indisponíveis. O plug-in não faz balanceamento de carga nos servidores de backup, mas atravessam a lista em ordem até que nenhum servidor permaneça na lista ou até que uma solicitação seja enviada com êxito e uma resposta seja recebida de um servidor de aplicativos. Especifique zero ou um atributo para cada ServerCluster.
VirtualHostGroup
Especifica um grupo de nomes de hosts virtuais especificados no cabeçalho de host de HTTP. Use essa propriedade para agrupar definições de hosts virtuais configuradas para manipular tipos de solicitações semelhantes.
O seguinte exemplo mostra um elemento VirtualHostGroup e os elementos e atributos associados:
<VirtualHostGroup Name="Hosts">
<VirtualHost Name="www.x.com"/>
<VirtualHost Name="www.x.com:443"/>
<VirtualHost Name="*:8080"/>
<VirtualHost Name="www.x.com:*"/>
<VirtualHost Name="*:*"/>
</VirtualHostGroup>
- Nome
Especifica o nome lógico ou administrativo que será usado para este grupo de hosts virtuais. Especifique exatamente um atributo para cada VirtualHostGroup.
- VirtualHost
Especifica o nome usado para uma máquina virtual ou real para determinar se solicitações recebidas devem ser manipuladas pelo WebSphere Application Server. Use esse elemento para especificar nomes de host que estão no cabeçalho Host de HTTP que devem ser vistos para solicitações que precisam ser manipuladas pelo servidor de aplicativos. É possível especificar nomes de hosts e portas específicos para solicitações recebidas ou especificar um asterisco (*) do nome de host, da porta ou de ambos.
Pode haver um ou mais elementos para cada VirtualHostGroup.
- Nome
Especifica o nome no cabeçalho Host de HTTP que corresponde ao nome em VirtualHost. Especifique exatamente um atributo para cada VirtualHost.
O valor é uma combinação de nome de host ou endereço IP e porta, separados por dois pontos.
É possível configurar o plug-in para rotear pedidos para o servidor de aplicativos com base no cabeçalho Host de HTTP e porta de entrada para o pedido. O atributo Name especifica essas combinações.
Pode-se utilizar um caractere curinga para esse atributo. As únicas soluções aceitáveis são um asterisco (*) para o nome do host, um asterisco para a porta ou um asterisco para ambos. Um asterisco para ambos significa que qualquer solicitação corresponde a essa regra. Se nenhuma porta for especificada na definição, a porta HTTP padrão 80 será assumida.
- Nome
UriGroup
Especifica um grupo de URIs que são especificados na linha de solicitação de HTTP. O mesmo servidor de aplicativos deve ser capaz de tratar dos URIs. A rota compara o URI recebido com os URIs no grupo para determinar se o servidor de aplicativos manipulada a solicitação.
O seguinte exemplo mostra um elemento UriGroup e os elementos e atributos associados:
<UriGroup Name="Uris">
<Uri Name="/servlet/snoop/">
<Uri Name="/webapp/*/">
<Uri Name="*.jsp/">
</UriGroup>
- Nome
Especifica o nome lógico ou administrativo para este grupo de URIs. Especifique exatamente um atributo para cada UriGroup.
- Uri
Especifica o caminho virtual para o recurso que é atendido pelo WebSphere Application Server. Cada URI especifica as URLs recebidas que o servidor de aplicativos precisa para manipular. Pode-se utilizar um caractere curinga nessas definições. Pode haver um ou mais atributos para cada UriGroup.
- Nome
Especifica a sequência real para especificar na linha de solicitação de HTTP para corresponder com êxito a esse URI. Pode-se utilizar um caractere curinga na definição do URI. É possível especificar regras como *.jsp ou /servlet/* para que sejam manipuladas por WebSphere Application Server. Ao montar seu aplicativo, se você especificar Entrega de Arquivos Ativada, então, apenas um URI curinga será gerado para o aplicativo da web, independente de quaisquer mapeamentos de servlet explícitos. Se você especificar Servir Servlets pelo Nome de Classe, a seguinte URI será gerada: <Uri Name="Web_application_URI/servlet/*">
Existe exatamente um atributo para cada URI.
- AffinityCookie
Especifica o nome do cookie que o plug-in usa ao tentar determinar se a solicitação recebida tem afinidade de sessão. O valor padrão é JSESSIONID.
Consulte a descrição do atributo CloneID para obter informações adicionais sobre a afinidade da sessão.
Pode haver zero ou um atributo para cada URI.
- AffinityURLIdentifier
Especifica o nome do identificador que o plug-in usa ao tentar determinar se a solicitação recebida tem afinidade especificada no URL para um determinado clone. O valor padrão é jsessionid.
Consulte a descrição do atributo CloneID para obter informações adicionais sobre a afinidade da sessão.
Pode haver zero ou um atributo para cada URI.
- Nome
Route
Especifica uma regra de roteamento de solicitação pela qual o plug-in determinará se uma solicitação recebida deve ser manipulada pelo WebSphere Application Server.
Uma definição de rota é o elemento central da configuração do plug-in. Especifica como o plug-in manipula solicitações, com base em determinadas características da solicitação. A definição de rota contém os outros elementos principais: um ServerCluster obrigatório e um VirtualHostGroup, UriGroup ou ambos.
Usando as informações definidas em VirtualHostGroup e UriGroup para roteamento, o plug-in determina se a solicitação recebida para o servidor da Web é enviada para o elemento ServerCluster definido nesse roteamento.
Veja o seguinte exemplo deste elemento:
<Route VirtualHostGroup="Hosts" UriGroup="Uris" ServerCluster="servers"/>
- VirtualHostGroup
Especifica o grupo de hosts virtuais usados na determinação de rota. O cabeçalho do host recebido e a porta do servidor são correspondidos para determinar se essa solicitação é manipulada pelo servidor de aplicativos.
É possível omitir essa propriedade a partir da definição de rota. Se ela não estiver presente, cada solicitação corresponderá durante a parte de correspondência do host virtual de determinação de rota.
Poderá haver zero ou um atributo para cada Rota.
- UriGroup
Especifica o grupo de URIs para usar para determinar a rota. Selecione zero ou um grupo para cada Route. O URI recebido para a solicitação é correspondido com os URIs definidos nesse grupo para determinar se essa solicitação é manipulada pelo servidor de aplicativos.
É possível omitir essa propriedade a partir da definição de rota. Se ela não estiver presente, cada solicitação corresponderá durante a parte de correspondência do URI de determinação de rota.
- ServerCluster
Especifica o cluster que recebe as solicitações que corresponderam com êxito à rota. Selecione exatamente um cluster para cada Route.
O cluster é usado para manipular essa solicitação. Se a correspondência do URI e do host virtual for bem-sucedida para essa rota, a solicitação será enviada para um dos servidores definidos nesse cluster.
RequestMetrics
Usado para determinar se métricas de solicitação estão ativadas e como filtrar as solicitações com base no protocolo da Internet (IP) e nos filtros de Identificadores Uniformes de Recursos (URI) quando as métricas de solicitação são ativadas.
Veja o seguinte exemplo deste elemento:
<RequestMetrics armEnabled="false" loggingEnabled="true"
rmEnabled="false" traceLevel="PERF_DEBUG">
- armEnabled
Especifica se o agente ARM 4 está ativado no plug-in. Quando ele estiver configurado como true, o agente ARM 4 será chamado.
Evitar Problemas: Para i servidor da Web SunOne (iPlanet), a seguinte diretiva deverá ser incluída no arquivo obj.conf para ativar o suporte ARM 4:
Se essa diretiva não estiver incluída, o procedimento arm_stop nunca será chamado.gotchaAddLog fn="as_term"
Selecione zero ou um atributo para RequestMetrics
- loggingEnabled
Especifica se o log das métricas de solicitação está ativada no plug-in. Quando estiver configurado como true e traceLevel não estiver configurado como NONE, o tempo de resposta da solicitação e outras informações sobre ela serão registrados. Quando definido como false, não haverá nenhum registro de pedido. O valor de loggingEnabled depende do valor especificado para a propriedade de sistema, com.ibm.websphere.pmi.reqmetrics.loggingEnabled. Quando a propriedade do sistema não está presente, loggingEnable é definido como true. Especifique exatamente um atributo para RequestMetrics.
- rmEnabled
Especifica se as métricas de solicitação estão ativadas no plug-in. Quando estiver configurado como true, o plug-in, métricas de solicitação, inspecionará e registrará o registro de rastreio da solicitação no arquivo de log de plug-in. Essa ação é executada se um pedido transmitir os filtros. Quando esse atributo estiver configurado como false, o restante dos atributos das métricas de solicitação será ignorado. Especifique exatamente um atributo para RequestMetrics.
- traceLevel
Indica quanta informação está registrada quando o atributo rmEnabled está configurado como true. Quando esse atributo é definido como NONE, nenhum registro de pedido é executado. Quando esse atributo não estiver configurado como NONE, e loggingEnabled estiver configurado como true, o tempo de resposta da solicitação e outras informações sobre ela serão registrados após sua conclusão. Especifique exatamente um atributo para RequestMetrics.
- filters
Quando rmEnabled for true, os filtros controlam quais pedidos serão rastreados. Especifique zero, um ou dois atributos para RequestMetrics.
- enable
Quando enable for true, o tipo de filtro estará ativado e os pedidos deverão passar pelo filtro. Especifique exatamente um atributo para cada Filter.
- type
Há dois tipos de filtros: SOURCE_IP (por exemplo, endereço IP do cliente) e URI. Para o tipo de filtro SOURCE_IP, os pedidos são filtrados com base em um endereço IP conhecido. É possível especificar uma máscara para um endereço IP utilizando o asterisco (*). Se o asterisco for utilizado, o asterisco deve sempre ser o último caractere da máscara, por exemplo, 127.0.0.*, 127.0.*, 127*. Por motivos de desempenho, o padrão compara caractere por caractere, até que um asterisco seja localizado no filtro, uma diferença ocorra ou seja constatado que os filtros são uma correspondência exata.
Para o tipo de filtro URI, os pedidos são filtrados com base no URI do pedido HTTP de entrada. As regras para correspondência de padrões são as mesmas que para a correspondência de filtros de endereço SOURCE_IP.
Se a URI e os filtros do endereço IP do cliente estiverem ativados, as métricas de solicitação requererão uma correspondência para os dois tipos de filtro. Se nenhum estiver ativado, todos os pedidos serão considerados como uma correspondência.
Existe exatamente um atributo para cada Filter.
- filterValues
Especifica as informações de filtro detalhadas. Especifique um ou vários atributos para cada filtro.
- value
Especifica o valor do filtro para o tipo de filtro correspondente. Esse valor pode ser um endereço IP ou um URI. Especifique exatamente um atributo para cada filterValue.
- value
- enable