Esta página foi traduzida pela API Cloud Translation.

Como configurar o tempo limite do sinal de atividade em processadores de mensagens

Esta é a documentação do Apigee Edge.
Acesse Documentação da Apigee X. informações

Neste documento, explicamos como configurar o tempo limite de sinal de atividade para o Apigee Edge Processadores de mensagens

O tempo limite de sinal de atividade no processador de mensagens permite que uma única conexão TCP envie e receber múltiplas solicitações/respostas HTTP de/para o servidor de back-end, em vez de abrir um novo para cada par de solicitação/resposta.

O valor padrão da propriedade de tempo limite de sinal de atividade no processador de mensagens é 60 segundos. Esse tempo limite é aplicável aos servidores de back-end configurados na configuração do endpoint de destino e na política ServiceCallout do proxy de API.

O tempo limite de sinal de atividade para processadores de mensagens pode ser aumentado ou diminuído do valor padrão de 60 segundos com base nas suas necessidades. Ele pode ser configurado das seguintes maneiras:

No proxy de API
- No endpoint de destino
- Na política ServiceCallout
No processador de mensagens

As seguintes propriedades controlam o tempo limite de sinal de atividade nos processadores de mensagens:

Nome da propriedade Local Descrição

Nome da propriedade	Local	Descrição
`keepalive.timeout.millis`	Proxy de API: Endpoint de destino `ServiceCallout` política	Esse é o tempo máximo de inatividade para o qual o processador de mensagens permite que um único TCP para enviar e receber várias solicitações/respostas HTTP, em vez de abrir uma nova para cada par de solicitação/resposta. Por padrão, essa propriedade usa o valor definido para o `HTTPClient.keepalive.timeout.millis` no processador de mensagens, em que o valor padrão é `60` segundos. Se essa propriedade for modificada com um novo valor de tempo limite para o servidor de destino usado no endpoint de destino ou a política `ServiceCallout` no proxy de API específico e, o tempo de sinal de atividade somente para esse servidor de destino específico é afetado.
`HTTPClient.keepalive.timeout.millis`	processador de mensagens	Esse é o tempo máximo de inatividade para o qual o processador de mensagens permite que um único TCP para enviar e receber várias solicitações/respostas HTTP, em vez de abrir uma uma nova conexão para cada par de solicitação/resposta. Essa propriedade é usada para todos os proxies de API em execução no processador de mensagens. O valor padrão dessa propriedade é de `60` segundos. Você pode modificar essa propriedade conforme explicado nas Como configurar o tempo limite de sinal de atividade em processadores de mensagens abaixo. Se preferir, substitua esse valor definindo a propriedade `keepalive.timeout.millis` no nível do proxy de API.

keepalive.timeout.millis

Proxy de API:

Endpoint de destino
ServiceCallout política

Esse é o tempo máximo de inatividade para o qual o processador de mensagens permite que um único TCP para enviar e receber várias solicitações/respostas HTTP, em vez de abrir uma nova para cada par de solicitação/resposta.

Por padrão, essa propriedade usa o valor definido para o HTTPClient.keepalive.timeout.millis no processador de mensagens, em que o valor padrão é 60 segundos.

Se essa propriedade for modificada com um novo valor de tempo limite para o servidor de destino usado no endpoint de destino ou a política ServiceCallout no proxy de API específico e, o tempo de sinal de atividade somente para esse servidor de destino específico é afetado.

HTTPClient.keepalive.timeout.millis

processador de mensagens

Esse é o tempo máximo de inatividade para o qual o processador de mensagens permite que um único TCP para enviar e receber várias solicitações/respostas HTTP, em vez de abrir uma uma nova conexão para cada par de solicitação/resposta.

Essa propriedade é usada para todos os proxies de API em execução no processador de mensagens.

O valor padrão dessa propriedade é de 60 segundos.

Você pode modificar essa propriedade conforme explicado nas Como configurar o tempo limite de sinal de atividade em processadores de mensagens abaixo. Se preferir, substitua esse valor definindo a propriedade keepalive.timeout.millis no nível do proxy de API.

Antes de começar

Antes de usar as etapas deste documento, é preciso entender os seguintes tópicos:

Se você não conhece o tempo limite do sinal de atividade, consulte keepalive.timeout.millis descrição da propriedade no especificação da propriedade de transporte do TargetEndpoint.
Se você não sabe como configurar propriedades para o Edge em uma nuvem privada, leia Como configurar o Edge

Como configurar o tempo limite de sinal de atividade no proxy de API

O tempo limite de sinal de atividade pode ser configurado no proxy de API nos seguintes locais:

Endpoint de destino
ServiceCallout política

Como configurar o tempo limite de sinal de atividade no endpoint de destino do proxy de API

Esta seção explica como configurar o tempo limite de sinal de atividade no endpoint de destino da sua proxy de API. O tempo limite de sinal de atividade pode ser configurado pela propriedade keepalive.timeout.millis, que representa o valor de tempo limite de sinal de atividade em milésimos de segundo.

Observação: configurar o tempo limite de sinal de atividade no endpoint de destino do o proxy de API substituirá o valor padrão (60 segundos) pelo novo valor. e afeta apenas o proxy de API específico em que está configurado. O restante dos proxies de API continue usando o valor padrão de tempo limite de sinal de atividade de 60 segundos.

Na interface do Edge, selecione o proxy de API específico em que você quer configurar o novo valor de tempo limite de sinal de atividade.
Selecione o endpoint de destino específico que você quer modificar.
Adicione a propriedade keepalive.timeout.millis com um valor apropriado no <HTTPTargetConnection> na configuração TargetEndpoint.

Por exemplo, para mudar o tempo limite de sinal de atividade para 30 segundos, adicione o seguinte bloco de código:
```
<Properties>
  <Property name="keepalive.timeout.millis">30000</Property>
</Properties>
```
Como a propriedade keepalive.timeout.millis está em milissegundos, o valor de 30 segundos é 30000.

Os exemplos a seguir mostram como configurar o tempo limite de sinal de atividade no endpoint de destino do proxy de API:

Exemplo de configuração de endpoint de destino usando um URL para o servidor de back-end
```
<TargetEndpoint name="default">
  <HTTPTargetConnection>
    <URL>https://mocktarget.apigee.net/json</URL>
    <Properties>
      <Property name="keepalive.timeout.millis">30000</Property>
    </Properties>
  </HTTPTargetConnection>
</TargetEndpoint>
```
Exemplo de configuração do endpoint de destino usando o servidor de destino
```
<TargetEndpoint name="default">
  <HTTPTargetConnection>
    <LoadBalancer>
      <Server name="target1" />
      <Server name="target2" />
    </LoadBalancer>
    <Properties>
      <Property name="keepalive.timeout.millis">30000</Property>
    </Properties>
    <Path>/test</Path>
  </HTTPTargetConnection>
</TargetEndpoint>
```
Observação: os valores de propriedade podem ser apenas literais. Não é possível definir valores usando variáveis.
Salve as alterações feitas no proxy de API.

Como configurar o tempo limite de sinal de atividade na política ServiceCall do proxy de API

Esta seção explica como configurar o tempo limite de sinal de atividade no ServiceCallout do proxy de API. O tempo limite do sinal de atividade pode ser configurado pela propriedade the keepalive.timeout.millis, que representa o valor de tempo limite de sinal de atividade em milissegundos.

Observação : configurar o tempo limite de sinal de atividade na política ServiceCallout de o proxy de API substitui o valor padrão (60 segundos) pelo novo valor e afeta apenas a política ServiceCallout específica em que ela está configurada. A o restante das políticas ServiceCallout e dos proxies de API continuam usando o valor de tempo limite de sinal de atividade de 60 segundos.

Permissões necessárias:para executar essa tarefa, é necessário ter permissões de acesso para editar a proxy de API específico em que você gostaria de configurar o tempo limite de sinal de atividade para o política ServiceCallout.

Para configurar o tempo limite do sinal de atividade na política ServiceCallout usando o Propriedade keepalive.timeout.millis:

Na interface do Edge, selecione o proxy de API específico em que você quer configurar o novo o valor de tempo limite de sinal de atividade para a política ServiceCallout.
Selecione a política ServiceCallout específica que você quer modificar.

Adicione a propriedade keepalive.timeout.millis com um valor apropriado no <HTTPTargetConnection> na configuração TargetEndpoint.

Por exemplo, para mudar o tempo limite de sinal de atividade para 30 segundos, adicione o seguinte bloco de código:

<Properties>
  <Property name="keepalive.timeout.millis">30000</Property>
</Properties>

Como a propriedade keepalive.timeout.millis está em milissegundos, o valor de 30 segundos é 30000.

Os exemplos a seguir mostram como configurar o tempo limite de sinal de atividade no Política ServiceCallout do proxy de API:

Exemplo de configuração de política de Service callout usando um URL para o servidor de back-end

<ServiceCallout name="Service-Callout-1">
  <DisplayName>Service Callout-1</DisplayName>
  <HTTPTargetConnection>
    <Properties>
      <Property name="keepalive.timeout.millis">30000</Property>
    </Properties>
    <URL>https://mocktarget.apigee.net/json</URL>
  </HTTPTargetConnection>
</ServiceCallout>

Exemplo de configuração da política Servicecall usando o servidor de destino

<ServiceCallout enabled="true" name="Service-Callout-1">
  <DisplayName>Service Callout-1</DisplayName>
  <Response>calloutResponse</Response>
  <HTTPTargetConnection>
    <LoadBalancer>
      <Server name="target1" />
      <Server name="target2" />
    </LoadBalancer>
    <Properties>
      <Property name="keepalive.timeout.millis">30000</Property>
    </Properties>
    <Path>/test</Path>
  </HTTPTargetConnection>
</ServiceCallout>

Salve as alterações feitas no proxy de API.

Como configurar o tempo limite de sinal de atividade em processadores de mensagens

Esta seção explica como configurar o tempo limite de sinal de atividade nos processadores de mensagens. A o tempo limite de sinal de atividade pode ser configurado pela propriedade HTTPClient.keepalive.timeout.millis, que representa o tempo limite de sinal de atividade em milissegundos no componente Processador de mensagens. Como essa propriedade é comentada o processador de mensagens, você precisa usar a sintaxe especial conf/http.properties+HTTPClient.keepalive.timeout.millis, conforme descrito na seção Defina um token que está atualmente comentado em Como configurar o Edge.

Para configurar o tempo limite de sinal de atividade nos processadores de mensagens, faça o seguinte:

Na máquina do processador de mensagens, abra o arquivo a seguir em um editor. Se ainda não existir, crie-o.
```
/opt/apigee/customer/application/message-processor.properties
```
Por exemplo, para abrir o arquivo usando vi, digite o seguinte:
```
vi /opt/apigee/customer/application/message-processor.properties
```
Adicione uma linha no seguinte formato ao arquivo de propriedades, substituindo um valor por TIME_IN_MILLISECONDS:
```
conf/http.properties+HTTPClient.keepalive.timeout.millis=TIME_IN_MILLISECONDS
```
Por exemplo, para alterar o tempo limite de sinal de atividade no processador de mensagens para 30 segundos, adicione a seguinte linha:
```
conf/http.properties+HTTPClient.keepalive.timeout.millis=30000
```
Salve as alterações.
Verifique se o arquivo de propriedades pertence ao usuário apigee, conforme mostrado abaixo:
```
chown apigee:apigee /opt/apigee/customer/application/message-processor.properties
```

Reinicie o processador de mensagens conforme mostrado abaixo:

/opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart

Se você tiver mais de um processador de mensagens, repita as etapas acima em todos Processadores de mensagens

Como verificar o tempo limite de sinal de atividade em processadores de mensagens

Esta seção explica como verificar se o tempo limite do sinal de atividade foi modificado nos processadores de mensagens.

Mesmo que você use a sintaxe especial conf/http.properties+HTTPClient.keepalive.timeout.millis para ativar o sinal de atividade tempo limite no processador de mensagens, você precisa verificar se a propriedade HTTPClient.keepalive.timeout.millis foi definido com o novo valor.

Na máquina do processador de mensagens, pesquise a propriedade HTTPClient.keepalive.timeout.millis no /opt/apigee/edge-message-processor/conf e verifique se ele tem foi definido com o novo valor, conforme mostrado abaixo:
```
grep -ri "HTTPClient.keepalive.timeout.millis" /opt/apigee/edge-message-processor/conf
```
Se o novo valor de tempo limite de sinal de atividade for definido com sucesso no Processador de Mensagens, o comando acima mostra o novo valor no arquivo http.properties.

O resultado da amostra do comando acima depois que você configurou o tempo limite de sinal de atividade para 30 segundos é o seguinte:
```
/opt/apigee/edge-message-processor/conf/http.properties:HTTPClient.keepalive.timeout.millis=30000
```
No exemplo de saída acima, observe que a propriedade HTTPClient.keepalive.timeout.millis foi definido com o novo valor 30000 em http.properties. Isso indica que o sinal de atividade O tempo limite foi configurado para 30 segundos no processador de mensagens.
Se o valor antigo da propriedade ainda estiver aparecendo HTTPClient.keepalive.timeout.millis e verifique se você seguiu todas as as etapas descritas Como configurar o tempo limite de sinal de atividade em processadores de mensagens corretamente. Se você tiver pulado alguma etapa, repita-a corretamente.
Se mesmo assim você não conseguir modificar o tempo limite do sinal de atividade, entre em contato Suporte do Apigee Edge do Google Cloud.