Konfigurowanie limitu czasu utrzymywania aktywności na procesorach wiadomości

Przeglądasz dokumentację Apigee Edge.
Przejdź do Dokumentacja Apigee X.
informacje.

Ten dokument wyjaśnia, jak skonfigurować limit czasu utrzymywania aktywności w Apigee Edge Procesory wiadomości.

Limit czasu utrzymywania aktywności na procesorze wiadomości umożliwia pojedyncze połączenie TCP do wysyłania odbiera wiele żądań/odpowiedzi HTTP z/do serwera backendu, zamiast otwierać nowy połączenia dla każdej pary żądania/odpowiedzi.

Domyślna wartość właściwości limitu czasu utrzymywania aktywności w procesorze wiadomości to 60 s. Ten czas oczekiwania dotyczy skonfigurowanych serwerów backendu w konfiguracji docelowego punktu końcowego oraz w zasadzie ServiceCallout na koncie Proxy API.

Limit czasu utrzymywania aktywności procesorów wiadomości można zwiększyć lub zmniejszyć w stosunku do wartości domyślnej co najmniej 60 s w zależności od potrzeb. Można go skonfigurować na następujące sposoby:

  • Na serwerze proxy API
    • W docelowym punkcie końcowym
    • W zasadzie ServiceCallout
  • Na procesorze wiadomości

Te właściwości kontrolują limit czasu utrzymywania aktywności na procesorach wiadomości:

Nazwa usługi Lokalizacja Opis
keepalive.timeout.millis Serwer proxy interfejsu API:
  • Docelowy punkt końcowy
  • ServiceCallout zasada

Jest to maksymalny czas bezczynności, podczas którego procesor wiadomości zezwala na pojedynczy port TCP do wysyłania i odbierania wielu żądań/odpowiedzi HTTP zamiast otwierania nowego połączenia dla każdej pary żądania/odpowiedzi.

Domyślnie właściwość ta przyjmuje wartość ustawioną dla parametru w usłudze HTTPClient.keepalive.timeout.millis w procesorze wiadomości, gdzie wartość domyślna to 60 s.

Jeśli ta właściwość zostanie zmodyfikowana o nową wartość limitu czasu serwera docelowego używanego w docelowy punkt końcowy lub zasada ServiceCallout w określonym serwerze proxy interfejsu API, wpływa na czas utrzymywania aktywności tylko dla tego konkretnego serwera docelowego.

HTTPClient.keepalive.timeout.millis procesor komunikatów

Jest to maksymalny czas bezczynności, podczas którego procesor wiadomości zezwala na pojedynczy port TCP do wysyłania i odbierania wielu żądań/odpowiedzi HTTP, zamiast otwierać nowe połączenie dla każdej pary żądania/odpowiedzi.

Ta właściwość jest używana na potrzeby wszystkich serwerów proxy interfejsu API działających w tym procesorze wiadomości.

Wartość domyślna tej właściwości wynosi 60 s.

Możesz ją zmodyfikować, postępując zgodnie z Konfigurowanie limitu czasu utrzymywania aktywności w procesorach wiadomości poniżej. Możesz też zastąpić tę wartość, ustawiając właściwość keepalive.timeout.millis na poziomie serwera proxy interfejsu API.

Zanim zaczniesz

Przed użyciem kroków opisanych w tym dokumencie upewnij się, że rozumiesz następujące tematy:

.

Konfigurowanie limitu czasu utrzymywania aktywności na serwerze proxy interfejsu API

Limit czasu utrzymywania aktywności można skonfigurować na serwerze proxy API w tych miejscach:

  • Docelowy punkt końcowy
  • ServiceCallout zasada

Konfigurowanie limitu czasu utrzymywania aktywności w docelowym punkcie końcowym serwera proxy interfejsu API

Ta sekcja wyjaśnia, jak skonfigurować limit czasu utrzymywania aktywności w docelowym punkcie końcowym Proxy API. Limit czasu utrzymywania aktywności można skonfigurować za pomocą właściwości keepalive.timeout.millis, który reprezentuje wartość limitu czasu utrzymywania aktywności w milisekund.

.
  1. W interfejsie Edge wybierz konkretny serwer proxy interfejsu API, w którym chcesz skonfigurować nowy limit czasu utrzymywania aktywności.
  2. Wybierz konkretny docelowy punkt końcowy, który chcesz zmienić.
  3. Dodaj właściwość keepalive.timeout.millis z odpowiednią wartością w polu <HTTPTargetConnection> w konfiguracji TargetEndpoint.

    Aby na przykład zmienić limit czasu utrzymywania aktywności na 30 s, dodaj parametr następujący blok kodu:

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

    Właściwość keepalive.timeout.millis jest podawana w milisekundach, więc wartość dla 30 s to 30000.

    Poniższe przykłady pokazują, jak skonfigurować limit czasu utrzymywania aktywności w docelowym punkcie końcowym konfiguracja Twojego serwera proxy interfejsu API:

    Przykładowa konfiguracja docelowego punktu końcowego z użyciem adresu URL serwera backendu

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

    Przykładowa konfiguracja docelowego punktu końcowego przy użyciu serwera docelowego

    <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>
    
  4. Zapisz zmiany wprowadzone na serwerze proxy interfejsu API.

Konfigurowanie utrzymywania limitu czasu aktywności w zasadzie Serviceobjaśnienia serwera proxy interfejsu API

Ta sekcja wyjaśnia, jak skonfigurować limit czasu utrzymywania aktywności w Zasada ServiceCallout serwera proxy interfejsu API. Limit czasu utrzymywania aktywności może być konfigurowanej za pomocą właściwości the keepalive.timeout.millis, która reprezentuje limit czasu utrzymywania aktywności w milisekundach.

.

Aby skonfigurować limit czasu utrzymywania aktywności w zasadzie ServiceCallout za pomocą Właściwość keepalive.timeout.millis:

  1. W interfejsie Edge wybierz konkretny serwer proxy interfejsu API, w którym chcesz skonfigurować nowy wartość limitu czasu utrzymywania aktywności dla zasady ServiceCallout.
  2. Wybierz konkretną zasadę ServiceCallout, którą chcesz zmienić.
  3. Dodaj właściwość keepalive.timeout.millis z odpowiednią wartością w kolumnie <HTTPTargetConnection> w konfiguracji TargetEndpoint.

    Aby na przykład zmienić limit czasu utrzymywania aktywności na 30 s, dodaj parametr następujący blok kodu:

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

    Właściwość keepalive.timeout.millis jest podawana w milisekundach, więc wartość dla 30 s to 30000.

    W przykładach poniżej pokazujemy, jak skonfigurować limit czasu utrzymywania aktywności w Zasada ServiceCallout serwera proxy interfejsu API:

    Przykładowa konfiguracja zasady objaśnienia usługi z użyciem adresu URL serwera backendu

    <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>
    

    Przykładowa konfiguracja zasad objaśnienia usługi z użyciem serwera docelowego

    <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>
    
  4. Zapisz zmiany wprowadzone na serwerze proxy interfejsu API.

Konfigurowanie limitu czasu utrzymywania aktywności w procesorach wiadomości

Ta sekcja wyjaśnia, jak skonfigurować limit czasu utrzymywania aktywności na procesorach wiadomości. limit czasu utrzymywania aktywności można skonfigurować za pomocą właściwości HTTPClient.keepalive.timeout.millis, który reprezentuje limit czasu utrzymywania aktywności. w milisekundach w komponencie procesora wiadomości. Ponieważ właściwość została skomentowana do procesora wiadomości, musisz użyć specjalnej składni conf/http.properties+HTTPClient.keepalive.timeout.millis zgodnie z opisem w sekcji Ustaw token obecnie komentowany w Jak skonfigurować Edge

Aby skonfigurować limit czasu utrzymywania aktywności na procesorach wiadomości, wykonaj te czynności:

  1. Na komputerze z procesorem wiadomości otwórz poniższy plik w edytorze. Jeśli jeszcze nie istnieje, utwórz go.
    /opt/apigee/customer/application/message-processor.properties
    

    Aby na przykład otworzyć plik przy użyciu vi, wpisz:

    vi /opt/apigee/customer/application/message-processor.properties
    
  2. Dodaj do pliku właściwości wiersz w poniższym formacie, zastępując wartość TIME_IN_MILLISECONDS:
    conf/http.properties+HTTPClient.keepalive.timeout.millis=TIME_IN_MILLISECONDS
    

    Na przykład, aby zmienić limit czasu utrzymywania aktywności w procesorze wiadomości na 30 s, dodaj ten wiersz:

    conf/http.properties+HTTPClient.keepalive.timeout.millis=30000
    
  3. Zapisz zmiany.
  4. Upewnij się, że plik właściwości należy do użytkownika apigee, jak pokazano poniżej:
    chown apigee:apigee /opt/apigee/customer/application/message-processor.properties
    
  5. Ponownie uruchom procesor wiadomości, jak pokazano poniżej:
    /opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart
    
  6. Jeśli masz więcej niż jeden procesor wiadomości, powtórz powyższe kroki na wszystkich Procesory wiadomości.

Weryfikowanie limitu czasu aktywności procesorów wiadomości

W tej sekcji wyjaśniamy, jak sprawdzić, czy limit czasu utrzymywania aktywności został zmieniony na procesorach wiadomości.

Mimo że używasz specjalnej składni conf/http.properties+HTTPClient.keepalive.timeout.millis, aby ustawić utrzymanie aktywności upływ limitu czasu oczekiwania na procesor wiadomości, musisz sprawdzić, czy rzeczywista usługa W polu HTTPClient.keepalive.timeout.millis ustawiono nową wartość.

  1. Na komputerze z procesorem wiadomości wyszukaj właściwość HTTPClient.keepalive.timeout.millis w: /opt/apigee/edge-message-processor/conf i sprawdź, czy zawiera została ustawiona na nową wartość, jak pokazano poniżej:
    grep -ri "HTTPClient.keepalive.timeout.millis" /opt/apigee/edge-message-processor/conf
    
  2. Jeśli nowa wartość limitu czasu utrzymywania aktywności zostanie ustawiona w procesorze wiadomości, powyższe polecenie pokazuje nową wartość w pliku http.properties.

    Przykładowy wynik z powyższego polecenia po skonfigurowaniu limitu czasu utrzymywania aktywności do 30 s, wygląda tak:

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

    Zwróć uwagę na to, że w przykładowych danych wyjściowych powyżej W polu HTTPClient.keepalive.timeout.millis ustawiono nową wartość 30000 w: http.properties. Oznacza to, że element utrzymujący aktywność czas oczekiwania został skonfigurowany na 30 s na procesorze wiadomości.

  3. Jeśli nadal widzisz starą wartość właściwości HTTPClient.keepalive.timeout.millis, a następnie sprawdź, czy wszystkie są obserwowane czynności opisane w Konfigurowanie limitu czasu utrzymywania aktywności w procesorach wiadomości . Jeśli pominiesz jakiś krok, powtórz je poprawnie.
  4. Jeśli nadal nie możesz zmienić limitu czasu utrzymywania aktywności, skontaktuj się z Obsługa Apigee Edge Google Cloud.