Mengonfigurasi waktu tunggu tetap aktif di Prosesor Pesan

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

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

Waktu tunggu {i>keep alive<i} pada {i>Message Processor<i} memungkinkan koneksi TCP tunggal untuk mengirim dan menerima beberapa permintaan/respons HTTP dari/ke server backend, bukan membuka untuk setiap pasangan permintaan/respons.

Nilai default dari properti waktu tunggu tetap aktif di Pemroses Pesan adalah 60 detik. Periode waktu tunggu ini berlaku untuk server backend yang dikonfigurasi di konfigurasi endpoint target dan di kebijakan ServiceCallout Proxy API.

Waktu tunggu keep alive untuk Pemroses Pesan dapat ditingkatkan atau diturunkan dari nilai default dari 60 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 tetap aktif pada Pemroses Pesan:

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

Ini adalah waktu tidak ada aktivitas maksimum saat Pemroses Pesan mengizinkan satu TCP koneksi baru untuk mengirim dan menerima beberapa permintaan/respons HTTP, bukan membuka untuk setiap pasangan permintaan/respons.

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

Jika properti ini diubah dengan nilai waktu tunggu baru untuk server target yang digunakan di endpoint target atau kebijakan ServiceCallout di proxy API tertentu, lalu waktu {i>keep alive time<i} hanya untuk server target tertentu yang terpengaruh.

HTTPClient.keepalive.timeout.millis Message Processor

Ini adalah waktu tidak ada aktivitas maksimum saat Pemroses Pesan mengizinkan satu TCP koneksi baru untuk mengirim dan menerima beberapa permintaan/respons HTTP, bukan membuka koneksi baru untuk setiap pasangan permintaan/respons.

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

Nilai default properti ini adalah 60 detik.

Anda dapat mengubah properti ini seperti yang dijelaskan di Mengonfigurasi waktu tunggu keep alive di Pemroses Pesan di bawah, atau Anda dapat menimpa nilai ini dengan menyetel properti keepalive.timeout.millis di level proxy API.

Sebelum memulai

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

Mengonfigurasi waktu tunggu keep alive di proxy API

Waktu tunggu keep alive dapat dikonfigurasi di proxy API di tempat berikut:

  • Endpoint target
  • Kebijakan ServiceCallout

Mengonfigurasi waktu tunggu keep alive di endpoint target proxy API

Bagian ini menjelaskan cara mengonfigurasi waktu tunggu keep alive di endpoint target Proxy API. Waktu tunggu keep alive dapat dikonfigurasi melalui properti keepalive.timeout.millis, yang mewakili nilai waktu tunggu keep alive di dalam milidetik.

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

    Misalnya, untuk mengubah Waktu Tunggu tetap aktif menjadi 30 detik, tambahkan blok kode berikut:

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

    Karena properti keepalive.timeout.millis dalam milidetik, nilai untuk 30 detik adalah 30000.

    Contoh berikut menunjukkan cara mengonfigurasi waktu tunggu keep alive di 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="keepalive.timeout.millis">30000</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="keepalive.timeout.millis">30000</Property>
        </Properties>
        <Path>/test</Path>
      </HTTPTargetConnection>
    </TargetEndpoint>
    
  4. Simpan perubahan yang dibuat pada proxy API Anda.

Mengonfigurasi waktu tunggu keep alive di kebijakan ServiceInfo proxy API

Bagian ini menjelaskan cara mengonfigurasi waktu tunggu keep alive di Kebijakan ServiceCallout proxy API Anda. Waktu tunggu keep alive dapat dikonfigurasi melalui properti the keepalive.timeout.millis, yang mewakili nilai waktu tunggu keep alive dalam milidetik.

Untuk mengonfigurasi waktu tunggu keep alive dalam kebijakan ServiceCallout menggunakan Properti keepalive.timeout.millis:

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

    Misalnya untuk mengubah waktu tunggu keep alive menjadi 30 detik, tambahkan blok kode berikut:

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

    Karena properti keepalive.timeout.millis dalam milidetik, nilai untuk 30 detik adalah 30000.

    Contoh berikut menunjukkan cara mengonfigurasi waktu tunggu keep alive di Kebijakan ServiceCallout proxy API Anda:

    Contoh konfigurasi kebijakan ServiceKeterangan menggunakan URL untuk server backend

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

    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="keepalive.timeout.millis">30000</Property>
        </Properties>
        <Path>/test</Path>
      </HTTPTargetConnection>
    </ServiceCallout>
    
  4. Simpan perubahan yang dibuat pada proxy API Anda.

Mengonfigurasi waktu tunggu tetap aktif di Pemroses Pesan

Bagian ini menjelaskan cara mengonfigurasi waktu tunggu keep alive pada Pemroses Pesan. Tujuan waktu tunggu tetap aktif dapat dikonfigurasi melalui properti HTTPClient.keepalive.timeout.millis, yang merepresentasikan waktu tunggu keep alive dalam milidetik pada komponen Pemroses Pesan. Karena properti ini diberi komentar Pemroses Pesan, Anda perlu menggunakan {i>syntax<i} khusus conf/http.properties+HTTPClient.keepalive.timeout.millis seperti yang dijelaskan dalam bagian Tetapkan token yang saat ini diberi komentar di Cara mengonfigurasi Edge.

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

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

    Misalnya, untuk membuka file menggunakan vi, masukkan kode 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.properties+HTTPClient.keepalive.timeout.millis=TIME_IN_MILLISECONDS
    

    Misalnya, untuk mengubah waktu tunggu tetap aktif pada Pemroses Pesan menjadi 30 detik, tambahkan baris berikut:

    conf/http.properties+HTTPClient.keepalive.timeout.millis=30000
    
  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.

Memverifikasi waktu tunggu tetap aktif di Pemroses Pesan

Bagian ini menjelaskan cara memverifikasi bahwa waktu tunggu keep alive telah berhasil diubah pada Message Processors.

Meskipun Anda menggunakan {i>syntax<i} khusus conf/http.properties+HTTPClient.keepalive.timeout.millis untuk menyetel keep aktif waktu tunggu pada pemroses Pesan, Anda perlu memverifikasi apakah properti sebenarnya HTTPClient.keepalive.timeout.millis telah ditetapkan dengan nilai baru.

  1. Di mesin Pemroses Pesan, telusuri properti HTTPClient.keepalive.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.keepalive.timeout.millis" /opt/apigee/edge-message-processor/conf
    
  2. Jika nilai waktu tunggu keep alive yang baru berhasil disetel di Pemroses Pesan, maka perintah di atas akan menampilkan nilai baru dalam file http.properties.

    Contoh hasil dari perintah di atas setelah Anda mengonfigurasi waktu tunggu keep alive hingga 30 detik adalah sebagai berikut:

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

    Pada contoh {i>output<i} di atas, perhatikan bahwa properti HTTPClient.keepalive.timeout.millis telah ditetapkan dengan nilai baru 30000 dalam http.properties. Hal ini menunjukkan bahwa fungsi tetap aktif waktu tunggu berhasil dikonfigurasi menjadi 30 detik pada Pemroses Pesan.

  3. Jika Anda masih melihat nilai lama untuk properti HTTPClient.keepalive.timeout.millis, lalu verifikasi bahwa Anda telah mengikuti semua langkah-langkah yang diuraikan dalam Mengonfigurasi waktu tunggu tetap aktif di Pemroses Pesan dengan benar. Jika Anda melewatkan langkah apa pun, ulangi semua langkah dengan benar.
  4. Jika Anda masih tidak dapat mengubah waktu waktu tunggu keep alive, hubungi Dukungan Apigee Edge Google Cloud.