Sie lesen gerade die Dokumentation zu Apigee Edge.
Zur Dokumentation zu
Apigee X. info
In diesem Dokument wird erläutert, wie Sie das Zeitlimit für Verbindungen für die Apigee Edge Message Processor konfigurieren.
Das Zeitlimit für Verbindungen gibt an, wie lange der Message Processor wartet, um eine Verbindung zum Zielserver herzustellen. Der Standardwert des Zeitlimits für Verbindungen auf dem
Message Processor beträgt 3 Sekunden. Dieses Zeitlimit gilt für die
Back-End-Server, die in der Zielendpunktkonfiguration und in der
ServiceCallout Richtlinie Ihres API-Proxys konfiguriert sind.
Das Zeitlimit für Verbindungen für Message Processor kann je nach Bedarf vom Standardwert von 3 Sekunden erhöht oder verringert werden. Es kann auf folgende Arten konfiguriert werden:
- Im API-Proxy
- Im Zielendpunkt
- In der
ServiceCallout-Richtlinie
- Auf dem Message Processor
Die folgenden Properties steuern das Zeitlimit für Verbindungen auf den Message Processors:
| Property-Name | Standort | Beschreibung |
|---|---|---|
connect.timeout.millis |
API-Proxy:
|
Dies ist die maximale Zeit, die der Message Processor wartet, um eine Verbindung zum Zielserver herzustellen.
Standardmäßig wird für diese Property der Wert festgelegt, der für die
Wenn diese Property mit einem neuen Zeitlimitwert für den Zielserver geändert wird, der mit einem API-Proxy verknüpft ist, wirkt sich dies nur auf die Verbindungszeit für diesen Zielserver aus. |
HTTPClient.connect.timeout.millis |
Message Processor |
Dies ist die maximale Zeit, die der Message Processor wartet, um eine Verbindung zum Zielserver herzustellen. Diese Property wird für alle API-Proxys verwendet, die auf diesem Message Processor ausgeführt werden.
Der Standardwert dieser Property ist
Sie können diese Property entweder wie unter
Zeitlimit für Verbindungen auf Message Processors konfigurieren beschrieben ändern oder diesen Wert
durch Festlegen der |
Hinweis
Bevor Sie die Schritte in diesem Dokument ausführen, sollten Sie mit den folgenden Themen vertraut sein:
- Wenn Sie mit dem Zeitlimit für Verbindungen nicht vertraut sind, lesen Sie die
connect.timeout.millisBeschreibung der Property unter Spezifikation des TargetEndpoint Transport-Attributs. - Wenn Sie nicht wissen, wie Sie Properties für Edge in Private Cloud konfigurieren, lesen Sie den Artikel Edge konfigurieren.
Zeitlimit für Verbindungen im API-Proxy konfigurieren
Das Zeitlimit für Verbindungen kann an den folgenden Stellen im API-Proxy konfiguriert werden:
- Zielendpunkt
ServiceCallout-Richtlinie
Zeitlimit für Verbindungen im Zielendpunkt des API-Proxys konfigurieren
In diesem Abschnitt wird erläutert, wie Sie das Zeitlimit für Verbindungen im Zielendpunkt Ihres API-Proxys konfigurieren.
Das Zeitlimit für Verbindungen kann über die Property connect.timeout.millis,
konfiguriert werden, die den Wert des Zeitlimits für Verbindungen in Millisekunden darstellt.
- Wählen Sie in der Edge-UI den API-Proxy aus, in dem Sie den neuen Wert für das Zeitlimit für Verbindungen konfigurieren möchten.
- Wählen Sie den Zielendpunkt aus, den Sie ändern möchten.
- Fügen Sie der
TargetEndpointKonfiguration unter dem<HTTPTargetConnection>Element die Propertyconnect.timeout.millismit einem geeigneten Wert hinzu.Wenn Sie das Zeitlimit für Verbindungen beispielsweise auf
5Sekunden ändern möchten, fügen Sie den folgenden Codeblock hinzu:<Properties> <Property name="connect.timeout.millis">5000</Property> </Properties>
Da die
connect.timeout.millisProperty in Millisekunden angegeben wird, ist der Wert für5Sekunden5000.Die folgenden Beispiele zeigen, wie Sie das Zeitlimit für Verbindungen in der Zielendpunkt Konfiguration Ihres API-Proxys konfigurieren:
Beispiel für eine Zielendpunktkonfiguration mit einer URL für den Back-End-Server
<TargetEndpoint name="default"> <HTTPTargetConnection> <URL>https://mocktarget.apigee.net/json</URL> <Properties> <Property name="connect.timeout.millis">5000</Property> </Properties> </HTTPTargetConnection> </TargetEndpoint>Beispiel für eine Zielendpunktkonfiguration mit einem Zielserver
<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> - Speichern Sie die Änderungen, die Sie an Ihrem API-Proxy vorgenommen haben.
Zeitlimit für Verbindungen in der ServiceCallout-Richtlinie des API-Proxys konfigurieren
In diesem Abschnitt wird erläutert, wie Sie das Zeitlimit für Verbindungen in der ServiceCallout
-Richtlinie Ihres API-Proxys konfigurieren. Das Zeitlimit für Verbindungen kann über die
connect.timeout.millis Property konfiguriert werden, die den Wert für die Verbindungszeit in
Millisekunden darstellt.
So konfigurieren Sie das Zeitlimit für Verbindungen in der ServiceCallout Richtlinie mit der
connect.timeout.millis Property:
- Wählen Sie in der Edge-UI den API-Proxy aus, in dem Sie den neuen
Wert für das Zeitlimit für Verbindungen für die
ServiceCalloutRichtlinie konfigurieren möchten. - Wählen Sie die
ServiceCallout-Richtlinie aus, die Sie ändern möchten. - Fügen Sie der
TargetEndpointKonfiguration unter dem<HTTPTargetConnection>Element die Propertyconnect.timeout.millismit einem geeigneten Wert hinzu.Wenn Sie das Zeitlimit für Verbindungen beispielsweise auf
5Sekunden ändern möchten, fügen Sie den folgenden Codeblock hinzu:<Properties> <Property name="connect.timeout.millis">5000</Property> </Properties>
Da die
connect.timeout.millisProperty in Millisekunden angegeben wird, ist der Wert für5Sekunden5000.Die folgenden Beispiele zeigen, wie Sie das Zeitlimit für Verbindungen in der
ServiceCalloutRichtlinie Ihres API-Proxys konfigurieren:Beispiel für eine ServiceCallout-Richtlinienkonfiguration mit einer URL für den Back-End-Server
<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>Beispiel für eine ServiceCallout-Richtlinienkonfiguration mit einem Zielserver
<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> - Speichern Sie die Änderungen, die Sie an Ihrem API-Proxy vorgenommen haben.
Zeitlimit für Verbindungen auf Message Processors konfigurieren
In diesem Abschnitt wird erläutert, wie Sie das Zeitlimit für Verbindungen auf den Message Processors konfigurieren.
Das Zeitlimit für Verbindungen kann über die Property
conf_http_HTTPClient.connect.timeout.millis konfiguriert werden, die den Wert des Zeitlimits für Verbindungen
in Millisekunden auf der Message Processor-Komponente darstellt. Verwenden Sie dazu das Token gemäß der
Syntax unter
Edge konfigurieren.
So konfigurieren Sie das Zeitlimit für Verbindungen auf den Message Processors:
- Öffnen Sie auf dem Message Processor-Computer die folgende Datei in einem Editor. Wenn sie noch nicht
vorhanden ist, erstellen Sie sie.
/opt/apigee/customer/application/message-processor.properties
Geben Sie beispielsweise Folgendes ein, um die Datei mit
vi, zu öffnen:vi /opt/apigee/customer/application/message-processor.properties
- Fügen Sie der Property-Datei eine Zeile im folgenden Format hinzu und ersetzen Sie
TIME_IN_MILLISECONDS durch einen Wert:
conf_http_HTTPClient.connect.timeout.millis=TIME_IN_MILLISECONDS
Wenn Sie das Zeitlimit für Verbindungen auf dem Message Processor beispielsweise auf
5Sekunden ändern möchten, fügen Sie die folgende Zeile hinzu:conf_http_HTTPClient.connect.timeout.millis=5000
- Speichern Sie die Änderungen.
- Achten Sie darauf, dass die Property-Datei dem Nutzer
apigeegehört, wie unten gezeigt:chown apigee:apigee /opt/apigee/customer/application/message-processor.properties
- Starten Sie den Message Processor neu, wie unten gezeigt:
/opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart
- Wenn Sie mehr als einen Message Processor haben, wiederholen Sie die obigen Schritte für alle Message Processors.
Zeitlimit für Verbindungen auf Message Processors prüfen
In diesem Abschnitt wird erläutert, wie Sie prüfen, ob das Zeitlimit für Verbindungen auf den Message Processors erfolgreich geändert wurde.
Obwohl Sie das Token conf_http_HTTPClient.connect.timeout.millis verwenden, um
das Zeitlimit für Verbindungen auf dem Message Processor festzulegen, müssen Sie prüfen, ob die tatsächliche Property
HTTPClient.connect.timeout.millis mit dem neuen Wert festgelegt wurde.
- Suchen Sie auf dem Message Processor-Computer im Verzeichnis
/opt/apigee/edge-message-processor/confnach der PropertyHTTPTransport.connect.timeout.millisund prüfen Sie, ob sie mit dem neuen Wert festgelegt wurde, wie unten gezeigt:grep -ri "HTTPClient.connect.timeout.millis" /opt/apigee/edge-message-processor/conf
- Wenn der neue Wert für das Zeitlimit für Verbindungen auf dem Message Processor erfolgreich festgelegt wurde, wird der
neue Wert im obigen Befehl in der Datei
http.propertiesangezeigt.Das Beispielergebnis des obigen Befehls, nachdem Sie das Zeitlimit für Verbindungen auf
5Sekunden konfiguriert haben, sieht so aus:/opt/apigee/edge-message-processor/conf/http.properties:HTTPClient.connect.timeout.millis=5000
In der obigen Beispielausgabe sehen Sie, dass die Property
HTTPClient.connect.timeout.millisinhttp.propertiesmit dem neuen Wert5000festgelegt wurde. Das bedeutet, dass das Zeitlimit für Verbindungen auf dem Message Processor erfolgreich auf5Sekunden konfiguriert wurde. - Wenn Sie immer noch den alten Wert für die Property
HTTPClient.connect.timeout.millis, dann prüfen Sie, ob Sie alle Schritte unter Zeitlimit für Verbindungen auf Message Processors konfigurieren korrekt ausgeführt haben. Wenn Sie einen Schritt ausgelassen haben, wiederholen Sie alle Schritte noch einmal korrekt. - Wenn Sie das Zeitlimit für Verbindungen immer noch nicht ändern können, wenden Sie sich an den Google Cloud Apigee Edge-Support.