Configurer le délai avant expiration de la connexion sur les processeurs de message

<ph type="x-smartling-placeholder"></ph> Vous consultez la documentation Apigee Edge.
Accédez à la page Documentation sur Apigee X.
En savoir plus

<ph type="x-smartling-placeholder">

Ce document explique comment configurer le délai d'expiration de la connexion pour les processeurs de messages Apigee Edge.

Le délai d'expiration de la connexion représente le temps pendant lequel le processeur de messages attend pour établir avec le serveur cible. La valeur par défaut de la propriété du délai d'expiration de la connexion sur le Le processeur de messages dure 3 secondes. Ce délai avant expiration s'applique serveurs backend configurés dans la configuration du point de terminaison cible et dans Règle ServiceCallout de votre proxy d'API.

Le délai de connexion des processeurs de messages peut être augmenté ou réduit par rapport à la valeur par défaut de 3 secondes, en fonction de vos besoins. Vous pouvez le configurer de différentes manières:

  • Dans le proxy d'API <ph type="x-smartling-placeholder">
      </ph>
    • Sur le point de terminaison cible
    • Dans la règle ServiceCallout
  • Sur le processeur de messages
<ph type="x-smartling-placeholder">

Les propriétés suivantes contrôlent le délai d'expiration de la connexion sur les processeurs de messages:

Nom de propriété Lieu Description
connect.timeout.millis Proxy d'API: <ph type="x-smartling-placeholder">
    </ph>
  • Point de terminaison cible
  • ServiceCallout règle

Il s'agit de la durée maximale pendant laquelle le processeur de messages attend pour se connecter au serveur cible.

Par défaut, cette propriété prend la valeur définie pour l'attribut Propriété HTTPClient.connect.timeout.millis sur le processeur de messages, où la valeur par défaut est de 3 secondes.

Si cette propriété est modifiée avec une nouvelle valeur de délai avant expiration pour le serveur cible associé avec un proxy d'API, la durée de connexion uniquement pour ce serveur cible est affectée.

HTTPClient.connect.timeout.millis Processeur de messages

Il s'agit de la durée maximale pendant laquelle le processeur de messages attend pour se connecter au serveur cible.

Cette propriété est utilisée pour tous les proxys d'API exécutés sur ce processeur de messages.

La valeur par défaut de cette propriété est de 3 secondes.

Vous pouvez modifier cette propriété comme expliqué dans la section . Configurez le délai d'expiration de la connexion sur les processeurs de messages ci-dessous, ou remplacez cette valeur. en définissant la propriété connect.timeout.millis au niveau du proxy d'API.

Avant de commencer

Avant de suivre les étapes décrites dans ce document, assurez-vous de bien comprendre les points suivants:

Configurer le délai d'expiration de la connexion dans le proxy d'API

Le délai avant expiration de la connexion peut être configuré dans le proxy d'API aux endroits suivants:

  • Point de terminaison cible
  • ServiceCallout règle

Configuration du délai d'expiration de la connexion dans le point de terminaison cible du proxy d'API

Cette section explique comment configurer le délai d'expiration de la connexion dans le point de terminaison cible de votre proxy d'API. Le délai avant expiration de la connexion peut être configuré via la propriété connect.timeout.millis. qui représente la valeur du délai d'expiration de la connexion en millisecondes.

<ph type="x-smartling-placeholder"> <ph type="x-smartling-placeholder">
  1. Dans l'interface utilisateur Edge, sélectionnez le proxy d'API spécifique dans lequel vous souhaitez configurer le nouveau délai avant expiration de la connexion.
  2. Sélectionnez le point de terminaison cible spécifique que vous souhaitez modifier.
  3. Ajoutez la propriété connect.timeout.millis avec une valeur appropriée sous la propriété Élément <HTTPTargetConnection> dans la configuration TargetEndpoint.

    Par exemple, pour définir le délai d'expiration de la connexion sur 5 secondes, ajoutez la clé-valeur bloc de code suivant:

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

    La propriété connect.timeout.millis étant exprimée en millisecondes, la valeur de 5 secondes correspond à 5000.

    Les exemples suivants montrent comment configurer le délai avant expiration de la connexion sur le point de terminaison cible la configuration de votre proxy d'API:

    Exemple de configuration de point de terminaison cible utilisant une URL pour le serveur backend

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

    Exemple de configuration de point de terminaison cible avec un serveur cible

    <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>
    
    <ph type="x-smartling-placeholder">
  4. Enregistrez les modifications apportées à votre proxy d'API.

Configurer le délai d'expiration de la connexion dans la règle ServiceAccroche du proxy d'API

Cette section explique comment configurer le délai avant expiration de la connexion dans ServiceCallout de votre proxy d'API. Le délai avant expiration de la connexion peut être configuré via connect.timeout.millis, qui représente la valeur du temps de connexion dans millisecondes.

<ph type="x-smartling-placeholder"> <ph type="x-smartling-placeholder">

Pour configurer le délai d'expiration de la connexion dans la règle ServiceCallout à l'aide de la méthode Propriété connect.timeout.millis:

  1. Dans l'interface utilisateur Edge, sélectionnez le proxy d'API spécifique dans lequel vous souhaitez configurer le nouveau valeur du délai avant expiration de la connexion pour la règle ServiceCallout.
  2. Sélectionnez la règle ServiceCallout spécifique que vous souhaitez modifier.
  3. Ajoutez la propriété connect.timeout.millis avec une valeur appropriée sous la propriété Élément <HTTPTargetConnection> dans la configuration TargetEndpoint.

    Par exemple, pour définir le délai d'expiration de la connexion sur 5 secondes, ajoutez le bloc de code suivant:

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

    La propriété connect.timeout.millis étant exprimée en millisecondes, la valeur de 5 secondes correspond à 5000.

    Les exemples suivants montrent comment configurer le délai avant expiration de la connexion dans le Règle ServiceCallout de votre proxy d'API:

    Exemple de configuration de la règle ServiceAccroche avec une URL pour le serveur 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>
    

    Exemple de configuration d'une règle ServiceAccroche avec un serveur cible

    <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>
    
    <ph type="x-smartling-placeholder">
  4. Enregistrez les modifications apportées à votre proxy d'API.

Configurer le délai d'expiration de la connexion sur les processeurs de messages

Cette section explique comment configurer le délai d'expiration de la connexion sur les processeurs de messages. Le délai avant expiration de la connexion peut être configuré via la propriété conf_http_HTTPClient.connect.timeout.millis, qui représente le délai avant expiration de la connexion. en millisecondes sur le composant de processeur de messages, en utilisant le jeton décrit à la section Comment configurer Edge

<ph type="x-smartling-placeholder"> <ph type="x-smartling-placeholder">

Pour configurer le délai d'expiration de la connexion sur les processeurs de messages, procédez comme suit:

  1. Sur le processeur de messages, ouvrez le fichier suivant dans un éditeur. Si ce n'est pas le cas existent déjà, alors créez-les.
    /opt/apigee/customer/application/message-processor.properties
    

    Par exemple, pour ouvrir le fichier avec vi, procédez comme suit : saisissez la commande suivante:

    vi /opt/apigee/customer/application/message-processor.properties
    
  2. Ajoutez une ligne au format suivant au fichier de propriétés, en remplaçant une valeur par TIME_IN_MILLISECONDS:
    conf_http_HTTPClient.connect.timeout.millis=TIME_IN_MILLISECONDS
    

    Par exemple, pour modifier le délai d'expiration de la connexion sur le processeur de messages à 5 secondes, ajoutez la ligne suivante:

    conf_http_HTTPClient.connect.timeout.millis=5000
    
  3. Enregistrez les modifications.
  4. Assurez-vous que le fichier de propriétés appartient à l'utilisateur apigee, comme indiqué ci-dessous:
    chown apigee:apigee /opt/apigee/customer/application/message-processor.properties
    
  5. Redémarrez le processeur de messages comme indiqué ci-dessous:
    /opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart
    
  6. Si vous disposez de plusieurs processeurs de messages, répétez les étapes ci-dessus sur tous les messages Processeurs.

Vérifier le délai d'expiration de la connexion sur les processeurs de messages

Cette section explique comment vérifier que le délai d'expiration de la connexion a bien été modifié sur les processeurs de messages.

Même si vous utilisez le jeton conf_http_HTTPClient.connect.timeout.millis pour définir le délai avant expiration de la connexion sur le processeur de messages, vous devez vérifier si la propriété réelle HTTPClient.connect.timeout.millis a été défini avec la nouvelle valeur.

  1. Sur le processeur de messages, recherchez la propriété HTTPTransport.connect.timeout.millis dans la /opt/apigee/edge-message-processor/conf et vérifiez s'il contient a été définie avec la nouvelle valeur, comme indiqué ci-dessous:
    grep -ri "HTTPClient.connect.timeout.millis" /opt/apigee/edge-message-processor/conf
    
  2. Si la nouvelle valeur du délai avant expiration de la connexion est correctement définie sur le processeur de messages, alors le ci-dessus affiche la nouvelle valeur dans le fichier http.properties.

    L'exemple de résultat de la commande ci-dessus après avoir configuré le délai d'expiration de la connexion sur 5 seconde est le suivant:

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

    Dans l'exemple de résultat ci-dessus, notez que la propriété HTTPClient.connect.timeout.millis a été définie avec la nouvelle valeur 5000 dans http.properties. Cela indique que le délai avant expiration de la connexion est correctement configuré sur 5 secondes sur l'écran du message Processeur.

  3. Si l'ancienne valeur de la propriété HTTPClient.connect.timeout.millis s'affiche toujours, Vérifiez ensuite que vous avez suivi toutes les étapes décrites dans Configurer le délai d'expiration de la connexion sur les processeurs de messages correctement. Si vous avez manqué une étape, répétez toutes les étapes correctement.
  4. Si vous ne pouvez toujours pas modifier le délai avant expiration de la connexion, contactez l'assistance Apigee Edge de Google Cloud.