Mesaj İşleyicilerde bağlantı zaman aşımını yapılandırma

Apigee Edge belgelerini görüntülüyorsunuz.
Apigee X belgelerine gidin.
bilgi

Bu belgede, Apigee Edge Mesaj İşleyicileri için bağlantı zaman aşımının nasıl yapılandırılacağı açıklanmaktadır.

Bağlantı zaman aşımı, Mesaj İşleyici'nin hedef sunucuyla bağlantı kurmak için bekleyeceği süreyi gösterir. Mesaj İşleyici'deki bağlantı zaman aşımı özelliğinin varsayılan değeri 3 saniyedir. Bu zaman aşımı süresi, hedef uç nokta yapılandırmasında ve API proxy'nizin ServiceCallout politikasında yapılandırılan arka uç sunucuları için geçerlidir.

Mesaj İşleyicileri için bağlantı zaman aşımı, ihtiyaçlarınıza göre varsayılan değerden (3 saniye) uzatılabilir veya azaltılabilir. Aşağıdaki şekillerde yapılandırılabilir:

  • API proxy'sinde
    • Hedef uç noktasında
    • ServiceCallout politikasında
  • Mesaj İşleyici Hakkında

Aşağıdaki özellikler İleti İşleyicileri'nde bağlantı zaman aşımını denetler:

Mülk adı Konum Açıklama
connect.timeout.millis API proxy'si:
  • Hedef uç nokta
  • ServiceCallout politikası

Bu, İleti İşleyici'nin hedef sunucuya bağlanmak için beklediği maksimum süredir.

Varsayılan olarak bu özellik, Mesaj İşleyici'de HTTPClient.connect.timeout.millis özelliği için ayarlanan değeri alır. Burada varsayılan değer 3 saniyedir.

Bu özellik, API proxy'si ile ilişkilendirilmiş hedef sunucu için yeni bir zaman aşımı değeriyle değiştirilirse yalnızca söz konusu hedef sunucunun bağlantı süresi etkilenir.

HTTPClient.connect.timeout.millis Mesaj İşleyici

Bu, İleti İşleyici'nin hedef sunucuya bağlanmak için beklediği maksimum süredir.

Bu özellik, bu Mesaj İşleyicide çalışan tüm API proxy'leri için kullanılır.

Bu özelliğin varsayılan değeri 3 saniyedir.

Bu özelliği, aşağıdaki Mesaj İşleyicilerinde bağlantı zaman aşımını yapılandırma bölümünde açıklandığı şekilde değiştirebilir veya API proxy düzeyinde connect.timeout.millis özelliğini ayarlayarak bu değerin üzerine yazabilirsiniz.

Başlamadan önce

Bu belgedeki adımları kullanmadan önce aşağıdaki konuları anladığınızdan emin olun:

API proxy'sinde bağlantı zaman aşımını yapılandırma

Bağlantı zaman aşımı, API proxy'sinde aşağıdaki yerlerde yapılandırılabilir:

  • Hedef uç nokta
  • ServiceCallout politikası

API proxy'sinin hedef uç noktasında bağlantı zaman aşımını yapılandırma

Bu bölümde, API proxy'nizin hedef uç noktasında bağlantı zaman aşımının nasıl yapılandırılacağı açıklanmaktadır. Bağlantı zaman aşımı, bağlantı zaman aşımı değerini milisaniye cinsinden temsil eden connect.timeout.millis özelliği aracılığıyla yapılandırılabilir.

  1. Edge kullanıcı arayüzünde, yeni bağlantı zaman aşımı değerini yapılandırmak istediğiniz API proxy'sini seçin.
  2. Değiştirmek istediğiniz belirli hedef uç noktasını seçin.
  3. TargetEndpoint yapılandırmasındaki <HTTPTargetConnection> öğesi altında, uygun bir değerle connect.timeout.millis özelliğini ekleyin.

    Örneğin, bağlantı zaman aşımını 5 saniye olarak değiştirmek için aşağıdaki kod bloğunu ekleyin:

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

    connect.timeout.millis özelliği milisaniye cinsinden olduğundan 5 saniye değeri 5000 şeklindedir.

    Aşağıdaki örneklerde, API proxy'nizin hedef uç nokta yapılandırmasında bağlantı zaman aşımının nasıl yapılandırılacağı gösterilmektedir:

    Arka uç sunucu için URL kullanan örnek hedef uç nokta yapılandırması

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

    Hedef sunucu kullanılan örnek hedef uç nokta yapılandırması

    <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. API proxy'nizde yapılan değişiklikleri kaydedin.

API proxy'sinin ServiceÇağrı politikasında bağlantı zaman aşımını yapılandırma

Bu bölümde, API proxy'nizin ServiceCallout politikasında bağlantı zaman aşımını nasıl yapılandıracağınız açıklanmaktadır. Bağlantı zaman aşımı, bağlantı süresi değerini milisaniye cinsinden temsil eden connect.timeout.millis özelliği aracılığıyla yapılandırılabilir.

connect.timeout.millis özelliğini kullanarak ServiceCallout politikasında bağlantı zaman aşımını yapılandırmak için:

  1. Edge kullanıcı arayüzünde, ServiceCallout politikası için yeni bağlantı zaman aşımı değerini yapılandırmak istediğiniz API proxy'sini seçin.
  2. Değiştirmek istediğiniz belirli ServiceCallout politikasını seçin.
  3. TargetEndpoint yapılandırmasındaki <HTTPTargetConnection> öğesi altında uygun bir değerle connect.timeout.millis özelliğini ekleyin.

    Örneğin, bağlantı zaman aşımını 5 saniye olarak değiştirmek için aşağıdaki kod bloğunu ekleyin:

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

    connect.timeout.millis özelliği milisaniye cinsinden olduğundan 5 saniye değeri 5000 şeklindedir.

    Aşağıdaki örneklerde, API proxy'nizin ServiceCallout politikasında bağlantı zaman aşımının nasıl yapılandırılacağı gösterilmektedir:

    Arka uç sunucu için URL kullanan örnek ServiceCaption politika yapılandırması

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

    Hedef sunucu kullanan örnek ServiceCallout politika yapılandırması

    <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. API proxy'nizde yapılan değişiklikleri kaydedin.

İleti İşleyicilerinde bağlantı zaman aşımını yapılandırma

Bu bölümde, İleti İşleyicilerinde bağlantı zaman aşımının nasıl yapılandırılacağı açıklanmaktadır. Bağlantı zaman aşımı, Edge'yi yapılandırma bölümünde açıklanan söz dizimine uygun olarak jeton kullanılarak Mesaj İşleyici bileşeninde bağlantı zaman aşımı değerini milisaniye cinsinden temsil eden conf_http_HTTPClient.connect.timeout.millis özelliği aracılığıyla yapılandırılabilir.

İleti İşleyicilerinde bağlantı zaman aşımını yapılandırmak için aşağıdakileri yapın:

  1. Message Processor makinesinde, aşağıdaki dosyayı bir düzenleyicide açın. Henüz yoksa oluşturun.
    /opt/apigee/customer/application/message-processor.properties
    

    Örneğin, dosyayı vi kullanarak açmak için aşağıdakini girin:

    vi /opt/apigee/customer/application/message-processor.properties
    
  2. Özellikler dosyasına aşağıdaki biçimde bir satır ekleyin ve TIME_IN_MILLISECONDS değeriyle değiştirin:
    conf_http_HTTPClient.connect.timeout.millis=TIME_IN_MILLISECONDS
    

    Örneğin, Mesaj İşleyici'deki bağlantı zaman aşımını 5 saniye olarak değiştirmek için aşağıdaki satırı ekleyin:

    conf_http_HTTPClient.connect.timeout.millis=5000
    
  3. Değişikliklerinizi kaydedin.
  4. Özellikler dosyasının aşağıda gösterildiği gibi apigee kullanıcısına ait olduğundan emin olun:
    chown apigee:apigee /opt/apigee/customer/application/message-processor.properties
    
  5. Mesaj İşleyici'yi aşağıda gösterildiği gibi yeniden başlatın:
    /opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart
    
  6. Birden fazla Mesaj İşleyiciniz varsa tüm Mesaj İşleyiciler için yukarıdaki adımları tekrarlayın.

İleti İşlemcilerde bağlantı zaman aşımını doğrulama

Bu bölümde, Mesaj İşleyicilerinde bağlantı zaman aşımının başarıyla değiştirildiğini nasıl doğrulayacağınız açıklanmaktadır.

İleti İşleyicide bağlantı zaman aşımını ayarlamak için conf_http_HTTPClient.connect.timeout.millis jetonunu kullansanız da, HTTPClient.connect.timeout.millis gerçek özelliğinin yeni değerle ayarlanıp ayarlanmadığını doğrulamanız gerekir.

  1. Mesaj İşleyici makinesinde, /opt/apigee/edge-message-processor/conf dizininde HTTPTransport.connect.timeout.millis özelliğini arayın ve aşağıda gösterildiği gibi yeni değerle ayarlanıp ayarlanmadığını kontrol edin:
    grep -ri "HTTPClient.connect.timeout.millis" /opt/apigee/edge-message-processor/conf
    
  2. Yeni bağlantı zaman aşımı değeri Mesaj İşleyici'de başarıyla ayarlanmışsa yukarıdaki komut, http.properties dosyasında yeni değeri gösterir.

    Bağlantı zaman aşımını 5 saniye olarak yapılandırdıktan sonra yukarıdaki komuttan alınan örnek sonuç şu şekildedir:

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

    Yukarıdaki örnek çıkışta, HTTPClient.connect.timeout.millis özelliğinin http.properties nesnesindeki yeni 5000 değeriyle ayarlandığına dikkat edin. Bu, bağlantı zaman aşımının Mesaj İşleyici'de 5 saniye olacak şekilde başarıyla yapılandırıldığını gösterir.

  3. HTTPClient.connect.timeout.millis mülkünün eski değerini görmeye devam ediyorsanız Mesaj İşleyicilerde bağlantı zaman aşımını yapılandırma başlıklı makalede açıklanan tüm adımları doğru şekilde uyguladığınızdan emin olun. Herhangi bir adımı atladıysanız tüm adımları doğru bir şekilde tekrar edin.
  4. Bağlantı zaman aşımını hâlâ değiştiremiyorsanız Google Cloud Apigee Edge Desteği ile iletişime geçin.