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 Apigee Edge.

Waktu tunggu koneksi menunjukkan waktu yang digunakan Message Processor untuk menunggu pembentukan koneksi dengan server target. Nilai default properti waktu tunggu koneksi di Message Processor adalah 3 detik. Periode waktu tunggu ini berlaku untuk server backend yang dikonfigurasi dalam konfigurasi endpoint target dan dalam 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 Message Processor

Properti berikut mengontrol waktu tunggu koneksi di Pemroses Pesan:

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

Ini adalah waktu maksimum yang ditunggu oleh Message Processor untuk terhubung dengan server target.

Secara default, properti ini mengambil nilai yang ditetapkan untuk properti HTTPClient.connect.timeout.millis di Message Processor, dengan nilai default 3 detik.

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

HTTPClient.connect.timeout.millis Message Processor

Ini adalah waktu maksimum yang ditunggu oleh Message Processor untuk terhubung ke server target.

Properti ini digunakan untuk semua proxy API yang berjalan di Message Processor ini.

Nilai default properti ini adalah 3 detik.

Anda dapat mengubah properti ini seperti yang dijelaskan di Mengonfigurasi waktu tunggu koneksi di Pemroses Pesan di bawah, atau Anda dapat mengganti nilai ini dengan menyetel properti connect.timeout.millis di tingkat 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 lokasi berikut:

  • Endpoint target
  • Kebijakan terkait 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 merepresentasikan nilai waktu tunggu koneksi dalam milidetik.

  1. Di UI Edge, pilih proxy API tertentu tempat Anda ingin mengonfigurasi nilai waktu tunggu koneksi baru.
  2. Pilih endpoint target spesifik yang ingin Anda ubah.
  3. Tambahkan properti connect.timeout.millis dengan nilai yang sesuai di bawah elemen <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 konfigurasi endpoint target 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 dilakukan pada proxy API Anda.

Mengonfigurasi waktu tunggu koneksi dalam kebijakan ServiceCallout proxy API

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

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

  1. Di UI Edge, pilih proxy API tertentu tempat Anda ingin mengonfigurasi nilai waktu tunggu koneksi baru untuk kebijakan ServiceCallout.
  2. Pilih kebijakan ServiceCallout tertentu yang ingin Anda ubah.
  3. Tambahkan properti connect.timeout.millis dengan nilai yang sesuai di bawah elemen <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 ServiceCallout 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 ServiceCallout 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 dilakukan pada proxy API Anda.

Mengonfigurasi waktu tunggu koneksi di Pemroses Pesan

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

Untuk mengonfigurasi waktu tunggu koneksi di Pemroses Pesan, lakukan hal berikut:

  1. Di mesin Message Processor, buka file berikut di editor. Jika belum ada, buat.
    /opt/apigee/customer/application/message-processor.properties

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

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

    Misalnya, untuk mengubah waktu tunggu koneksi di Message Processor 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:
    /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 di semua Pemroses Pesan.

Memverifikasi waktu tunggu koneksi di Pemroses Pesan

Bagian ini menjelaskan cara memverifikasi bahwa waktu tunggu koneksi telah berhasil diubah di Prosesor Pesan.

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

  1. Di mesin Message Processor, telusuri properti HTTPTransport.connect.timeout.millis di direktori /opt/apigee/edge-message-processor/conf dan periksa apakah properti tersebut telah ditetapkan dengan nilai baru seperti yang ditunjukkan di bawah:
    grep -ri "HTTPClient.connect.timeout.millis" /opt/apigee/edge-message-processor/conf
    
  2. Jika nilai waktu tunggu koneksi baru berhasil ditetapkan di Message Processor, perintah di atas akan menampilkan nilai baru dalam file http.properties.

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

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

    Dalam 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 di Message Processor.

  3. Jika Anda masih melihat nilai lama untuk properti HTTPClient.connect.timeout.millis, maka pastikan Anda telah mengikuti semua langkah yang diuraikan dalam Mengonfigurasi waktu tunggu koneksi di 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.