Mengonfigurasi waktu tunggu koneksi pada Pemroses Pesan

Anda sedang melihat dokumentasi Apigee Edge.
Buka Dokumentasi Apigee X.
info

Dokumen ini menjelaskan cara mengonfigurasi waktu tunggu koneksi untuk Pemroses Pesan Edge Apigee.

Waktu tunggu koneksi menyatakan waktu tunggu yang ditunggu Pemroses Pesan untuk dibuat dengan server target. Nilai default properti waktu tunggu koneksi pada Pemroses Pesan adalah 3 detik. Periode waktu tunggu ini berlaku untuk server backend yang dikonfigurasi di konfigurasi endpoint target dan Kebijakan ServiceCallout proxy API Anda.

Waktu tunggu koneksi untuk Pemroses Pesan dapat ditingkatkan atau diturunkan dari nilai default 3 detik berdasarkan kebutuhan Anda. Hal ini dapat dikonfigurasi dengan cara berikut:

  • Di proxy API
    • Di endpoint target
    • Dalam kebijakan ServiceCallout
  • Di Pemroses Pesan

Properti berikut mengontrol waktu tunggu koneksi pada Pemroses Pesan:

Nama properti Lokasi Deskripsi
connect.timeout.millis Proxy API:
  • Endpoint target
  • Kebijakan ServiceCallout

Ini adalah waktu maksimum saat Pemroses Pesan menunggu untuk terhubung dengan server target.

Secara default, properti ini menggunakan nilai yang ditetapkan untuk HTTPClient.connect.timeout.millis di Pemroses Pesan, dengan nilai defaultnya adalah 3 detik.

Jika properti ini diubah dengan nilai waktu tunggu baru untuk server target yang dikaitkan dengan proxy API, maka hanya waktu koneksi yang terpengaruh untuk server target tersebut.

HTTPClient.connect.timeout.millis Message Processor

Ini adalah waktu maksimum saat Pemroses Pesan menunggu untuk terhubung ke server target.

Properti ini digunakan untuk semua proxy API yang berjalan di Pemroses Pesan ini.

Nilai default properti ini adalah 3 detik.

Anda dapat mengubah properti ini seperti dijelaskan di Konfigurasi waktu tunggu koneksi pada Pemroses Pesan di bawah, atau Anda dapat menimpa nilai ini dengan menetapkan properti connect.timeout.millis di level proxy API.

Sebelum memulai

Sebelum menggunakan langkah-langkah dalam dokumen ini, pastikan Anda memahami topik berikut:

Mengonfigurasi waktu tunggu koneksi di proxy API

Waktu tunggu koneksi dapat dikonfigurasi di proxy API di tempat berikut:

  • Endpoint target
  • Kebijakan ServiceCallout

Mengonfigurasi waktu tunggu koneksi di endpoint target proxy API

Bagian ini menjelaskan cara mengonfigurasi waktu tunggu koneksi di endpoint target proxy API Anda. Waktu tunggu koneksi dapat dikonfigurasi melalui properti connect.timeout.millis, yang menunjukkan nilai waktu tunggu koneksi dalam milidetik.

  1. Pada UI Edge, pilih proxy API tertentu tempat Anda ingin mengonfigurasi nilai waktu tunggu koneksi habis.
  2. Pilih endpoint target tertentu yang ingin Anda ubah.
  3. Tambahkan properti connect.timeout.millis dengan nilai yang sesuai di bagian <HTTPTargetConnection> dalam konfigurasi TargetEndpoint.

    Misalnya, untuk mengubah waktu tunggu koneksi menjadi 5 detik, tambahkan blok kode berikut:

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

    Karena properti connect.timeout.millis dalam milidetik, nilai untuk 5 detik adalah 5000.

    Contoh berikut menunjukkan cara mengonfigurasi waktu tunggu koneksi di endpoint target untuk konfigurasi proxy API Anda:

    Contoh konfigurasi endpoint target menggunakan URL untuk server backend

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

    Contoh konfigurasi endpoint target menggunakan server target

    <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. Simpan perubahan yang dibuat pada proxy API Anda.

Mengonfigurasi waktu tunggu koneksi dalam kebijakan ServiceInfo proxy API

Bagian ini menjelaskan cara mengonfigurasi waktu tunggu koneksi di ServiceCallout kebijakan proxy API Anda. Waktu tunggu koneksi dapat dikonfigurasi melalui Properti connect.timeout.millis, yang mewakili nilai waktu koneksi di dalam milidetik.

Untuk mengonfigurasi waktu tunggu koneksi dalam kebijakan ServiceCallout menggunakan Properti connect.timeout.millis:

  1. Pada UI Edge, pilih proxy API tertentu tempat Anda ingin mengonfigurasi nilai waktu tunggu koneksi untuk kebijakan ServiceCallout.
  2. Pilih kebijakan ServiceCallout spesifik yang ingin Anda ubah.
  3. Tambahkan properti connect.timeout.millis dengan nilai yang sesuai di bagian <HTTPTargetConnection> dalam konfigurasi TargetEndpoint.

    Misalnya untuk mengubah waktu tunggu koneksi menjadi 5 detik, tambahkan blok kode berikut:

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

    Karena properti connect.timeout.millis dalam milidetik, nilai untuk 5 detik adalah 5000.

    Contoh berikut menunjukkan cara mengonfigurasi waktu tunggu koneksi dalam Kebijakan ServiceCallout proxy API Anda:

    Contoh konfigurasi kebijakan ServiceInfo menggunakan URL untuk server 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>
    

    Contoh konfigurasi kebijakan ServiceInfo menggunakan server target

    <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. Simpan perubahan yang dibuat pada proxy API Anda.

Mengonfigurasi waktu tunggu koneksi pada Pemroses Pesan

Bagian ini menjelaskan cara mengonfigurasi waktu tunggu koneksi pada Pemroses Pesan. Waktu tunggu koneksi dapat dikonfigurasi melalui properti conf_http_HTTPClient.connect.timeout.millis, yang menunjukkan waktu tunggu koneksi habis nilai dalam milidetik pada komponen Pemroses Pesan, menggunakan token sesuai dengan yang dijelaskan dalam Cara mengonfigurasi Edge.

Untuk mengonfigurasi waktu tunggu koneksi pada Message Processors, lakukan hal berikut:

  1. Di komputer Message Processor, buka file berikut di editor. Jika tidak sudah ada, maka buatlah.
    /opt/apigee/customer/application/message-processor.properties
    

    Misalnya, untuk membuka file menggunakan vi, masukkan yang berikut:

    vi /opt/apigee/customer/application/message-processor.properties
    
  2. Tambahkan baris dalam format berikut ke {i>file<i} properti, dengan mengganti nilai dengan TIME_IN_MILLISECONDS:
    conf_http_HTTPClient.connect.timeout.millis=TIME_IN_MILLISECONDS
    

    Misalnya, untuk mengubah waktu tunggu koneksi pada Pemroses Pesan menjadi 5 detik, tambahkan baris berikut:

    conf_http_HTTPClient.connect.timeout.millis=5000
    
  3. Simpan perubahan.
  4. Pastikan file properti dimiliki oleh pengguna apigee seperti yang ditunjukkan di bawah:
    chown apigee:apigee /opt/apigee/customer/application/message-processor.properties
    
  5. Mulai ulang Pemroses Pesan seperti yang ditunjukkan di bawah ini:
    /opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart
    
  6. Jika Anda memiliki lebih dari satu Pemroses Pesan, ulangi langkah-langkah di atas pada semua Pemroses Pesan Prosesor.

Memverifikasi waktu tunggu koneksi pada Pemroses Pesan

Bagian ini menjelaskan cara memverifikasi bahwa waktu tunggu koneksi telah berhasil diubah di {i>Message Processors<i}.

Meskipun Anda menggunakan token conf_http_HTTPClient.connect.timeout.millis untuk menetapkan waktu tunggu koneksi pada Pemroses Pesan, Anda perlu memverifikasi apakah properti sebenarnya HTTPClient.connect.timeout.millis telah ditetapkan dengan nilai baru.

  1. Di mesin Pemroses Pesan, telusuri properti HTTPTransport.connect.timeout.millis dalam /opt/apigee/edge-message-processor/conf dan periksa untuk melihat apakah direktori tersebut dengan nilai baru seperti yang ditunjukkan di bawah ini:
    grep -ri "HTTPClient.connect.timeout.millis" /opt/apigee/edge-message-processor/conf
    
  2. Jika nilai waktu tunggu koneksi baru berhasil ditetapkan pada Pemroses Pesan, maka perintah di atas menunjukkan nilai baru dalam file http.properties.

    Contoh hasil dari perintah di atas setelah Anda mengonfigurasi waktu tunggu koneksi untuk 5 detik adalah sebagai berikut:

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

    Pada contoh output di atas, perhatikan bahwa properti HTTPClient.connect.timeout.millis telah ditetapkan dengan nilai baru 5000 di http.properties. Hal ini menunjukkan bahwa waktu tunggu koneksi berhasil dikonfigurasi menjadi 5 detik pada Pesan Pemroses.

  3. Jika Anda masih melihat nilai lama untuk properti HTTPClient.connect.timeout.millis, kemudian verifikasi bahwa Anda telah mengikuti semua langkah yang diuraikan dalam Mengonfigurasi waktu tunggu koneksi pada Pemroses Pesan dengan benar. Jika Anda melewatkan langkah apa pun, ulangi semua langkah dengan benar.
  4. Jika Anda masih tidak dapat mengubah waktu tunggu koneksi, hubungi Dukungan Apigee Edge Google Cloud.