Vous consultez la documentation Apigee Edge.
Accédez à la
documentation**Apigee X**. info
Ce document explique comment configurer le délai avant expiration de la connexion pour les processeurs de messages Apigee Edge.
Le délai avant expiration de la connexion représente le temps pendant lequel le processeur de messages attend d'établir
une connexion avec le serveur cible. La valeur par défaut de la propriété de délai avant expiration de la connexion sur le
processeur de messages est de 3 secondes. Cette période de délai avant expiration s'applique aux
serveurs de backend configurés dans la configuration du point de terminaison cible et dans la
ServiceCallout de votre proxy d'API.
Le délai avant expiration de la connexion pour les processeurs de messages peut être augmenté ou diminué par rapport à la valeur par défaut de 3 secondes en fonction de vos besoins. Il peut être configuré de différentes manières :
- Dans le proxy d'API
- Dans le point de terminaison cible
- Dans la règle
ServiceCallout
- Sur le processeur de messages
Les propriétés suivantes contrôlent le délai avant expiration de la connexion sur les processeurs de messages :
| Nom de propriété | Emplacement | Description |
|---|---|---|
connect.timeout.millis |
Proxy d'API :
|
Il s'agit du délai maximal pendant lequel le processeur de messages attend de se connecter au serveur cible.
Par défaut, cette propriété prend la valeur définie pour la
Si cette propriété est modifiée avec une nouvelle valeur de délai avant expiration pour le serveur cible associé à un proxy d'API, seul le délai de connexion de ce serveur cible est affecté. |
HTTPClient.connect.timeout.millis |
Processeur de messages |
Il s'agit du délai maximal pendant lequel le processeur de messages attend de 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
Vous pouvez modifier cette propriété comme expliqué dans
Configurer le délai avant expiration de la connexion sur les processeurs de messages ci-dessous, ou vous pouvez remplacer cette valeur
en définissant la propriété |
Avant de commencer
Avant de suivre les étapes de ce document, assurez-vous de bien comprendre les sujets suivants :
- Si vous n'êtes pas familiarisé avec le délai avant expiration de la connexion, consultez la
connect.timeout.millisdescription de la propriété dans Spécification de la propriété de transport TargetEndpoint. - Si vous n'êtes pas familiarisé avec la configuration des propriétés pour Edge sur Private Cloud, consultez la page Configurer Edge.
Configurer le délai avant 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 emplacements suivants :
- Point de terminaison cible
- Règle
ServiceCallout
Configurer le délai avant expiration de la connexion dans le point de terminaison cible du proxy d'API
Cette section explique comment configurer le délai avant 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 avant expiration de la connexion en millisecondes.
- Dans l'interface utilisateur Edge, sélectionnez le proxy d'API spécifique dans lequel vous souhaitez configurer la nouvelle valeur de délai avant expiration de la connexion.
- Sélectionnez le point de terminaison cible spécifique que vous souhaitez modifier.
- Ajoutez la propriété
connect.timeout.millisavec une valeur appropriée sous l'<HTTPTargetConnection>élément dans laTargetEndpointconfiguration.Par exemple, pour modifier le délai avant expiration de la connexion sur
5secondes, ajoutez le bloc de code suivant :<Properties> <Property name="connect.timeout.millis">5000</Property> </Properties>
Étant donné que la propriété
connect.timeout.millisest exprimée en millisecondes, la valeur de5secondes est5000.Les exemples suivants montrent comment configurer le délai avant expiration de la connexion dans la configuration du point de terminaison cible de votre proxy d'API :
Exemple de configuration de point de terminaison cible à l'aide d'une URL pour le serveur de 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 à l'aide d'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> - Enregistrez les modifications apportées à votre proxy d'API.
Configurer le délai avant expiration de la connexion dans la règle ServiceCallout du proxy d'API
Cette section explique comment configurer le délai avant expiration de la connexion dans la ServiceCallout
règle de votre proxy d'API. Le délai avant expiration de la connexion peut être configuré via la
connect.timeout.millis propriété, qui représente la valeur du délai de connexion en
millisecondes.
Pour configurer le délai avant expiration de la connexion dans la règle ServiceCallout à l'aide de la
connect.timeout.millis propriété :
- Dans l'interface utilisateur Edge, sélectionnez le proxy d'API spécifique dans lequel vous souhaitez configurer la nouvelle
valeur de délai avant expiration de la connexion pour la règle
ServiceCallout. - Sélectionnez la règle
ServiceCalloutspécifique que vous souhaitez modifier. - Ajoutez la propriété
connect.timeout.millisavec une valeur appropriée sous l'<HTTPTargetConnection>élément dans laTargetEndpointconfiguration.Par exemple, pour modifier le délai avant expiration de la connexion sur
5secondes, ajoutez le bloc de code suivant :<Properties> <Property name="connect.timeout.millis">5000</Property> </Properties>
Étant donné que la propriété
connect.timeout.millisest exprimée en millisecondes, la valeur de5secondes est5000.Les exemples suivants montrent comment configurer le délai avant expiration de la connexion dans la
ServiceCalloutrègle de votre proxy d'API :Exemple de configuration de règle ServiceCallout à l'aide d'une URL pour le serveur 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>Exemple de configuration de règle ServiceCallout à l'aide d'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> - Enregistrez les modifications apportées à votre proxy d'API.
Configurer le délai avant expiration de la connexion sur les processeurs de messages
Cette section explique comment configurer le délai avant 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 la valeur du délai avant expiration de la connexion
en millisecondes sur le composant Processeur de messages, à l'aide du jeton conformément à la
syntaxe décrite dans
la section Configurer Edge.
Pour configurer le délai avant expiration de la connexion sur les processeurs de messages, procédez comme suit :
- Sur la machine du processeur de messages, ouvrez le fichier suivant dans un éditeur. S'il n'existe pas
déjà, créez-le.
/opt/apigee/customer/application/message-processor.properties
Par exemple, pour ouvrir le fichier à l'aide de
vi, saisissez la commande suivante :vi /opt/apigee/customer/application/message-processor.properties
- Ajoutez une ligne au format suivant au fichier de propriétés, en remplaçant
TIME_IN_MILLISECONDS par une valeur :
conf_http_HTTPClient.connect.timeout.millis=TIME_IN_MILLISECONDS
Par exemple, pour modifier le délai avant expiration de la connexion sur le processeur de messages sur
5secondes, ajoutez la ligne suivante :conf_http_HTTPClient.connect.timeout.millis=5000
- Enregistrez les modifications.
- 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
- Redémarrez le processeur de messages comme indiqué ci-dessous :
/opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart
- Si vous avez plusieurs processeurs de messages, répétez les étapes ci-dessus sur tous les processeurs de messages.
Vérifier le délai avant expiration de la connexion sur les processeurs de messages
Cette section explique comment vérifier que le délai avant 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éfinie avec la nouvelle valeur.
- Sur la machine du processeur de messages, recherchez la propriété
HTTPTransport.connect.timeout.millisdans le répertoire/opt/apigee/edge-message-processor/confet vérifiez si elle a été définie avec la nouvelle valeur, comme indiqué ci-dessous :grep -ri "HTTPClient.connect.timeout.millis" /opt/apigee/edge-message-processor/conf
- Si la nouvelle valeur de délai avant expiration de la connexion est correctement définie sur le processeur de messages, la
commande 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 avant expiration de la connexion sur
5secondes 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.millisa été définie avec la nouvelle valeur5000danshttp.properties. Cela indique que le délai avant expiration de la connexion est correctement configuré sur5secondes sur le processeur de messages. - Si l'ancienne valeur de la propriété
HTTPClient.connect.timeout.milliss'affiche toujours, vérifiez que vous avez correctement suivi toutes les étapes décrites dans la section Configurer le délai avant expiration de la connexion sur les processeurs de messages. Si vous avez manqué une étape, répétez-les toutes correctement. - Si vous ne parvenez toujours pas à modifier le délai avant expiration de la connexion, contactez l'assistance Google Cloud Apigee Edge.