Configura el tiempo de espera de conexión en Message Processor

Estás viendo la documentación de Apigee Edge.
Ve a la Documentación de Apigee X.
información

En este documento, se explica cómo configurar el tiempo de espera de conexión para los procesadores de mensajes de Apigee Edge.

El tiempo de espera de conexión representa el tiempo que el Message Processor espera para establecerse una conexión con el servidor de destino. El valor predeterminado de la propiedad Tiempo de espera de conexión en la El procesador de mensajes tiene una duración de 3 segundos. Este tiempo de espera se aplica al servidores de backend configurados en la configuración del extremo de destino y en La política ServiceCallout de tu proxy de API

El tiempo de espera de conexión de Message Processors se puede aumentar o disminuir del valor predeterminado de 3 segundos, según tus necesidades. Se puede configurar de las siguientes maneras:

  • En el proxy de API
    • En el extremo de destino
    • En la política ServiceCallout
  • En el Message Processor

Las siguientes propiedades controlan el tiempo de espera de conexión en Message Processor:

Nombre de la propiedad Ubicación Descripción
connect.timeout.millis Proxy de API:
  • Extremo de destino
  • Política de ServiceCallout

Este es el tiempo máximo que el Message Processor espera para conectarse con el servidor de destino.

De forma predeterminada, esta propiedad toma el valor establecido para el propiedad HTTPClient.connect.timeout.millis en Message Processor, donde el valor predeterminado es 3 segundos.

Si esta propiedad se modifica con un nuevo valor de tiempo de espera para el servidor de destino asociado con un proxy de API, el tiempo de conexión solo para ese servidor de destino

HTTPClient.connect.timeout.millis Message Processor

Este es el tiempo máximo que el Message Processor espera para conectarse al servidor de destino.

Esta propiedad se usa para todos los proxies de API que se ejecutan en este Message Processor.

El valor predeterminado de esta propiedad es de 3 segundos.

Puedes modificar esta propiedad como se explica en . Configura el tiempo de espera de conexión en Message Processors a continuación. De lo contrario, puedes reemplazar este valor. estableciendo la propiedad connect.timeout.millis a nivel del proxy de API.

Antes de comenzar

Antes de seguir los pasos de este documento, asegúrate de comprender los siguientes temas:

Configura el tiempo de espera de conexión en el proxy de API

El tiempo de espera de conexión se puede configurar en el proxy de API en los siguientes lugares:

  • Extremo de destino
  • Política de ServiceCallout

Configura el tiempo de espera de conexión en el extremo de destino del proxy de API

En esta sección, se explica cómo configurar el tiempo de espera de conexión en el extremo de destino del proxy de API. El tiempo de espera de conexión se puede configurar a través de la propiedad connect.timeout.millis. que representa el valor del tiempo de espera de conexión en milisegundos.

  1. En la IU de Edge, selecciona el proxy de API específico en el que deseas configurar el nuevo tiempo de espera de la conexión.
  2. Selecciona el extremo de destino específico que deseas modificar.
  3. Agrega la propiedad connect.timeout.millis con un valor apropiado en el El elemento <HTTPTargetConnection> en la configuración TargetEndpoint

    Por ejemplo, para cambiar el tiempo de espera de conexión a 5 segundos, agrega el siguiente bloque de código:

    <Properties>
      <Property name="connect.timeout.millis">5000</Property>
    </Properties>
    

    Como la propiedad connect.timeout.millis se encuentra en milisegundos, el valor de 5 segundos es 5000.

    En los siguientes ejemplos, se muestra cómo configurar el tiempo de espera de conexión en el extremo de destino actual del proxy de API:

    Ejemplo de configuración del extremo de destino con una URL para el servidor de backend

    <TargetEndpoint name="default">
      <HTTPTargetConnection>
        <URL>https://mocktarget.apigee.net/json</URL>
        <Properties>
          <Property name="connect.timeout.millis">5000</Property>
        </Properties>
      </HTTPTargetConnection>
    </TargetEndpoint>
    

    Ejemplo de configuración del extremo de destino con el servidor de destino

    <TargetEndpoint name="default">
      <HTTPTargetConnection>
        <LoadBalancer>
          <Server name="target1" />
          <Server name="target2" />
        </LoadBalancer>
        <Properties>
          <Property name="connect.timeout.millis">5000</Property>
        </Properties>
        <Path>/test</Path>
      </HTTPTargetConnection>
    </TargetEndpoint>
    
  4. Guarda los cambios realizados en tu proxy de API.

Configuración del tiempo de espera de conexión en la política Service conformidad del proxy de API

En esta sección, se explica cómo configurar el tiempo de espera de conexión en ServiceCallout política de tu proxy de API. El tiempo de espera de conexión se puede configurar con connect.timeout.millis, que representa el valor del tiempo de conexión en milisegundos.

Para configurar el tiempo de espera de conexión en la política ServiceCallout con la Propiedad connect.timeout.millis:

  1. En la IU de Edge, selecciona el proxy de API específico en el que deseas configurar el nuevo valor del tiempo de espera de conexión de la política ServiceCallout.
  2. Selecciona la política ServiceCallout específica que deseas modificar.
  3. Agrega la propiedad connect.timeout.millis con un valor adecuado en el El elemento <HTTPTargetConnection> en la configuración TargetEndpoint

    Por ejemplo, para cambiar el tiempo de espera de conexión a 5 segundos, agrega el siguiente bloque de código:

    <Properties>
      <Property name="connect.timeout.millis">5000</Property>
    </Properties>
    

    Como la propiedad connect.timeout.millis se encuentra en milisegundos, el valor de 5 segundos es 5000.

    En los siguientes ejemplos, se muestra cómo configurar el tiempo de espera de conexión en la Política ServiceCallout de tu proxy de API:

    Ejemplo de configuración de la política Service UX con una URL para el servidor de backend

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

    Ejemplo de configuración de la política Service UX con el 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="connect.timeout.millis">5000</Property>
        </Properties>
      <Path>/test</Path>
      </HTTPTargetConnection>
    </ServiceCallout>
    
  4. Guarda los cambios realizados en tu proxy de API.

Cómo configurar el tiempo de espera de conexión en Message Processor

En esta sección, se explica cómo configurar el tiempo de espera de conexión en Message Processor. El tiempo de espera de conexión se puede configurar a través de la propiedad conf_http_HTTPClient.connect.timeout.millis, que representa el tiempo de espera de conexión valor en milisegundos en el componente Message Processor, usando el token de acuerdo con el sintaxis descrita en Cómo configurar Edge

Para configurar el tiempo de espera de conexión en Message Processor, haz lo siguiente:

  1. En la máquina del procesador de mensajes, abre el siguiente archivo en un editor. Si no ya existen, entonces la crearás.
    /opt/apigee/customer/application/message-processor.properties
    

    Por ejemplo, para abrir el archivo con vi, haz lo siguiente: Ingresa lo siguiente:

    vi /opt/apigee/customer/application/message-processor.properties
    
  2. Agrega una línea con el siguiente formato al archivo de propiedades y sustituye un valor por TIME_IN_MILLISECONDS:
    conf_http_HTTPClient.connect.timeout.millis=TIME_IN_MILLISECONDS
    

    Por ejemplo, para cambiar el tiempo de espera de conexión en Message Processor a 5 segundos, haz lo siguiente: agrega la siguiente línea:

    conf_http_HTTPClient.connect.timeout.millis=5000
    
  3. Guarda los cambios.
  4. Asegúrate de que el archivo de propiedades sea propiedad del usuario de apigee, como se muestra a continuación:
    chown apigee:apigee /opt/apigee/customer/application/message-processor.properties
    
  5. Reinicia Message Processor como se muestra a continuación:
    /opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart
    
  6. Si tienes más de un Message Processor, repite los pasos anteriores en todos los mensajes Procesadores.

Cómo verificar el tiempo de espera de conexión en Message Processor

Esta sección explica cómo verificar que el tiempo de espera de la conexión se haya modificado correctamente en de los procesadores de mensajes.

Aunque uses el token conf_http_HTTPClient.connect.timeout.millis para configurar el tiempo de espera de conexión en Message Processor, debes verificar si la propiedad real Se estableció HTTPClient.connect.timeout.millis con el valor nuevo.

  1. En la máquina del procesador de mensajes, busca la propiedad. HTTPTransport.connect.timeout.millis en /opt/apigee/edge-message-processor/conf y verifica si tiene con el valor nuevo, como se muestra a continuación:
    grep -ri "HTTPClient.connect.timeout.millis" /opt/apigee/edge-message-processor/conf
    
  2. Si el nuevo valor de tiempo de espera de conexión se configura correctamente en Message Processor, el anterior, se muestra el valor nuevo en el archivo http.properties.

    El resultado de muestra del comando anterior después de configurar el tiempo de espera de la conexión para 5 segundos es lo siguiente:

    /opt/apigee/edge-message-processor/conf/http.properties:HTTPClient.connect.timeout.millis=5000
    

    En el resultado de ejemplo anterior, observa que la propiedad HTTPClient.connect.timeout.millis se estableció con el nuevo valor 5000 en http.properties. Esto indica que el tiempo de espera de conexión se haya configurado correctamente en 5 segundos en la Procesador.

  3. Si aún ves el valor anterior de la propiedad HTTPClient.connect.timeout.millis, haz lo siguiente: luego, verifica que hayas seguido todos los pasos descritos Cómo configurar el tiempo de espera de conexión en Message Processors correctamente. Si omitiste algún paso, vuelve a repetirlo correctamente.
  4. Si aún no puedes modificar el tiempo de espera de la conexión, comunícate con el equipo de Asistencia de Apigee Edge de Google Cloud.