Google menggunakan teknologi AI untuk menerjemahkan konten ke dalam bahasa pilihan Anda. Terjemahan AI mungkin mengandung kesalahan.

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 tetap aktif untuk Pemroses Pesan Apigee Edge.

Waktu tunggu tetap aktif di Message Processor memungkinkan satu koneksi TCP mengirim dan menerima beberapa permintaan/respons HTTP dari/ke server backend, bukan membuka koneksi baru untuk setiap pasangan permintaan/respons.

Nilai default properti waktu tunggu tetap aktif di Message Processor adalah 60 detik. Periode waktu tunggu ini berlaku untuk server backend yang dikonfigurasi dalam konfigurasi endpoint target dan dalam kebijakan ServiceCallout proxy API Anda.

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

Nama properti Lokasi Deskripsi

Nama properti	Lokasi	Deskripsi
`keepalive.timeout.millis`	Proxy API: Endpoint target Kebijakan terkait `ServiceCallout`	Ini adalah waktu tidak ada aktivitas maksimum yang memungkinkan Message Processor mengirim dan menerima beberapa permintaan/respons HTTP melalui satu koneksi TCP, bukan membuka koneksi baru untuk setiap pasangan permintaan/respons. Secara default, properti ini mengambil nilai yang ditetapkan untuk properti `HTTPClient.keepalive.timeout.millis` di Pemroses Pesan, dengan nilai default-nya 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, maka waktu tetap aktif hanya untuk server target tertentu tersebut yang akan terpengaruh.
`HTTPClient.keepalive.timeout.millis`	Message Processor	Ini adalah waktu tidak ada aktivitas maksimum yang memungkinkan Message Processor mengirim dan menerima beberapa permintaan/respons HTTP melalui satu koneksi TCP, bukan membuka koneksi baru untuk setiap pasangan permintaan/respons. Properti ini digunakan untuk semua proxy API yang berjalan di Message Processor ini. Nilai default properti ini adalah `60` detik. Anda dapat mengubah properti ini seperti yang dijelaskan dalam Mengonfigurasi waktu tunggu tetap aktif di Pemroses Pesan di bawah, atau Anda dapat menimpa nilai ini dengan menetapkan properti `keepalive.timeout.millis`di tingkat proxy API.

keepalive.timeout.millis

Proxy API:

Endpoint target
Kebijakan terkait ServiceCallout

Ini adalah waktu tidak ada aktivitas maksimum yang memungkinkan Message Processor mengirim dan menerima beberapa permintaan/respons HTTP melalui satu koneksi TCP, bukan membuka koneksi baru untuk setiap pasangan permintaan/respons.

Secara default, properti ini mengambil nilai yang ditetapkan untuk properti HTTPClient.keepalive.timeout.millis di Pemroses Pesan, dengan nilai default-nya 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, maka waktu tetap aktif hanya untuk server target tertentu tersebut yang akan terpengaruh.

HTTPClient.keepalive.timeout.millis

Message Processor

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

Nilai default properti ini adalah 60 detik.

Anda dapat mengubah properti ini seperti yang dijelaskan dalam Mengonfigurasi waktu tunggu tetap aktif di Pemroses Pesan di bawah, atau Anda dapat menimpa nilai ini dengan menetapkan properti keepalive.timeout.millisdi tingkat proxy API.

Sebelum memulai

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

Jika Anda belum memahami waktu tunggu tetap aktif, lihat deskripsi properti keepalive.timeout.millis di Spesifikasi Properti Transportasi TargetEndpoint.
Jika Anda belum memahami cara mengonfigurasi properti untuk Edge di Private Cloud, baca Cara mengonfigurasi Edge.

Mengonfigurasi waktu tunggu tetap aktif di proxy API

Waktu tunggu tetap aktif dapat dikonfigurasi di proxy API di tempat berikut:

Endpoint target
Kebijakan terkait ServiceCallout

Mengonfigurasi waktu tunggu tetap aktif di endpoint target proxy API

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

Catatan: Mengonfigurasi waktu tunggu tetap aktif di endpoint target proxy API Anda akan menggantikan nilai default (60 detik) dengan nilai baru dan hanya memengaruhi proxy API tertentu tempat konfigurasi dilakukan. Proxy API lainnya akan terus menggunakan nilai waktu tunggu tetap aktif default sebesar 60 detik.

Di UI Edge, pilih proxy API tertentu tempat Anda ingin mengonfigurasi nilai waktu tunggu tetap aktif yang baru.
Pilih endpoint target spesifik yang ingin Anda ubah.
Tambahkan properti keepalive.timeout.millis dengan nilai yang sesuai di bawah elemen <HTTPTargetConnection> dalam konfigurasi TargetEndpoint.

Misalnya, untuk mengubah Timeout 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 tetap aktif 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="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>
```
Catatan: Nilai properti hanya dapat berupa literal. Anda tidak dapat menetapkan nilai menggunakan variabel.
Simpan perubahan yang dilakukan pada proxy API Anda.

Mengonfigurasi waktu tunggu tetap aktif dalam kebijakan ServiceCallout proxy API

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

Catatan: Mengonfigurasi waktu tunggu tetap aktif dalam kebijakan ServiceCallout proxy API menggantikan nilai default (60 detik) dengan nilai baru dan hanya memengaruhi kebijakan ServiceCallout tertentu tempat kebijakan tersebut dikonfigurasi. Kebijakan ServiceCallout dan Proxy API lainnya akan terus menggunakan nilai waktu tunggu tetap aktif default 60 detik.

Izin yang diperlukan: Untuk melakukan tugas ini, Anda harus memiliki izin akses edit ke proxy API tertentu tempat Anda ingin mengonfigurasi waktu tunggu tetap aktif untuk kebijakan ServiceCallout.

Untuk mengonfigurasi waktu tunggu tetap aktif dalam kebijakan ServiceCallout menggunakan properti keepalive.timeout.millis:

Di UI Edge, pilih proxy API tertentu tempat Anda ingin mengonfigurasi nilai waktu tunggu tetap aktif baru untuk kebijakan ServiceCallout.
Pilih kebijakan ServiceCallout tertentu yang ingin Anda ubah.

Tambahkan properti keepalive.timeout.millis dengan nilai yang sesuai di bawah elemen <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 tetap aktif 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="keepalive.timeout.millis">30000</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="keepalive.timeout.millis">30000</Property>
    </Properties>
    <Path>/test</Path>
  </HTTPTargetConnection>
</ServiceCallout>

Simpan perubahan yang dilakukan pada proxy API Anda.

Mengonfigurasi waktu tunggu tetap aktif pada Pemroses Pesan

Bagian ini menjelaskan cara mengonfigurasi waktu tunggu tetap aktif di Pemroses Pesan. Waktu tunggu tetap aktif dapat dikonfigurasi melalui properti HTTPClient.keepalive.timeout.millis, yang merepresentasikan nilai waktu tunggu tetap aktif dalam milidetik pada komponen Message Processor. Karena properti ini dikomentari di Message Processor, Anda harus menggunakan sintaksis khusus conf/http.properties+HTTPClient.keepalive.timeout.millis seperti yang dijelaskan di bagian Menetapkan token yang saat ini dikomentari di Cara mengonfigurasi Edge.

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

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
```
Tambahkan baris dalam format berikut ke file properti, dengan mengganti nilai untuk TIME_IN_MILLISECONDS:
```
conf/http.properties+HTTPClient.keepalive.timeout.millis=TIME_IN_MILLISECONDS
```
Misalnya, untuk mengubah waktu tunggu tetap aktif di Pemroses Pesan menjadi 30 detik, tambahkan baris berikut:
```
conf/http.properties+HTTPClient.keepalive.timeout.millis=30000
```
Simpan perubahan.
Pastikan file properti dimiliki oleh pengguna apigee seperti yang ditunjukkan di bawah:
```
chown apigee:apigee /opt/apigee/customer/application/message-processor.properties
```

Mulai ulang Pemroses Pesan seperti yang ditunjukkan di bawah:

/opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart

Jika Anda memiliki lebih dari satu Pemroses Pesan, ulangi langkah-langkah di atas di semua Pemroses Pesan.

Memverifikasi waktu tunggu tetap aktif di Pemroses Pesan

Bagian ini menjelaskan cara memverifikasi bahwa waktu tunggu tetap aktif telah berhasil diubah di Pemroses Pesan.

Meskipun Anda menggunakan sintaksis khusus conf/http.properties+HTTPClient.keepalive.timeout.millis untuk menetapkan waktu tunggu tetap aktif di Pemroses pesan, Anda harus memverifikasi apakah properti sebenarnya HTTPClient.keepalive.timeout.millis telah ditetapkan dengan nilai baru.

Di mesin Message Processor, telusuri properti HTTPClient.keepalive.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.keepalive.timeout.millis" /opt/apigee/edge-message-processor/conf
```
Jika nilai waktu tunggu tetap aktif yang baru berhasil ditetapkan di Message Processor, maka perintah di atas akan menampilkan nilai baru dalam file http.properties.

Contoh hasil dari perintah di atas setelah Anda mengonfigurasi waktu tunggu tetap aktif ke 30 detik adalah sebagai berikut:
```
/opt/apigee/edge-message-processor/conf/http.properties:HTTPClient.keepalive.timeout.millis=30000
```
Dalam contoh output di atas, perhatikan bahwa properti HTTPClient.keepalive.timeout.millis telah ditetapkan dengan nilai baru 30000 di http.properties. Hal ini menunjukkan bahwa waktu tunggu keep-alive berhasil dikonfigurasi menjadi 30 detik di Pemroses Pesan.
Jika Anda masih melihat nilai lama untuk properti HTTPClient.keepalive.timeout.millis, pastikan Anda telah mengikuti semua 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.
Jika Anda masih tidak dapat mengubah waktu tunggu tetap aktif, hubungi Dukungan Apigee Edge Google Cloud.