Halaman ini diterjemahkan oleh Cloud Translation API.

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

Waktu tunggu tetap aktif pada Pemroses Pesan memungkinkan koneksi TCP tunggal 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 keep alive di Pemroses Pesan 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 keep-alive untuk Pemroses Pesan dapat ditingkatkan atau diturunkan dari nilai default 60 detik berdasarkan kebutuhan Anda. Ini dapat dikonfigurasi dengan cara berikut:

Di proxy API
- Di endpoint target
- Di kebijakan ServiceCallout
Pada Pemroses Pesan

Properti berikut mengontrol waktu tunggu keep alive pada Prosesor Pesan:

Nama properti Lokasi Deskripsi

Nama properti	Lokasi	Deskripsi
`keepalive.timeout.millis`	Proxy API: Endpoint target Kebijakan `ServiceCallout`	Ini adalah waktu tidak ada aktivitas maksimum di mana Pemroses Pesan mengizinkan satu koneksi TCP untuk mengirim dan menerima beberapa permintaan/respons HTTP, bukan membuka koneksi baru untuk setiap pasangan permintaan/respons. Secara default, properti ini menggunakan nilai yang ditetapkan untuk properti `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` dalam proxy API spesifik, waktu keep alive hanya untuk server target spesifik tersebut yang akan terpengaruh.
`HTTPClient.keepalive.timeout.millis`	Message Processor	Ini adalah waktu tidak ada aktivitas maksimum di mana Pemroses Pesan mengizinkan satu koneksi TCP 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 dalam Mengonfigurasi waktu tunggu keep alive di Prosesor Pesan di bawah, atau Anda dapat menimpa nilai ini dengan menyetel properti `keepalive.timeout.millis` pada level proxy API.

keepalive.timeout.millis

Proxy API:

Endpoint target
Kebijakan ServiceCallout

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

Secara default, properti ini menggunakan nilai yang ditetapkan untuk properti 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 dalam proxy API spesifik, waktu keep alive hanya untuk server target spesifik tersebut yang akan terpengaruh.

HTTPClient.keepalive.timeout.millis

Message Processor

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 dalam Mengonfigurasi waktu tunggu keep alive di Prosesor Pesan di bawah, atau Anda dapat menimpa nilai ini dengan menyetel properti keepalive.timeout.millis pada level proxy API.

Sebelum memulai

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

Jika Anda tidak terbiasa dengan waktu tunggu keep alive, lihat deskripsi properti keepalive.timeout.millis di Spesifikasi Properti Transport TargetEndpoint.
Jika Anda tidak terbiasa mengonfigurasi properti untuk Edge di Private Cloud, baca Cara mengonfigurasi Edge.

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 tetap aktif di endpoint target proxy API Anda. Waktu tunggu keep alive dapat dikonfigurasi melalui properti keepalive.timeout.millis, yang mewakili nilai waktu tunggu keep alive dalam milidetik.

Catatan: Mengonfigurasi waktu tunggu keep alive di endpoint target proxy API Anda akan mengganti nilai default (60 detik) dengan nilai baru dan hanya memengaruhi proxy API tertentu tempat nilai tersebut dikonfigurasi. Proxy API lainnya tetap menggunakan nilai waktu tunggu keep-alive default, yaitu 60 detik.

Di UI Edge, pilih proxy API tertentu tempat Anda ingin mengonfigurasi nilai waktu tunggu keep alive yang baru.
Pilih endpoint target tertentu yang ingin Anda ubah.
Tambahkan properti keepalive.timeout.millis dengan nilai yang sesuai di bagian elemen <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 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 yang 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 boleh literal. Anda tidak dapat menetapkan nilai menggunakan variabel.
Simpan perubahan yang dibuat pada proxy API Anda.

Mengonfigurasi waktu tunggu keep alive di kebijakan ServiceCallout proxy API

Bagian ini menjelaskan cara mengonfigurasi waktu tunggu keep alive dalam 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.

Catatan: Mengonfigurasi waktu tunggu keep alive dalam kebijakan ServiceCallout proxy API akan mengganti nilai default (60 detik) dengan nilai baru dan hanya memengaruhi kebijakan ServiceCallout tertentu tempat nilai dikonfigurasi. Kebijakan ServiceCallout dan Proxy API lainnya tetap menggunakan nilai waktu tunggu keep-live default sebesar 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 keep alive untuk kebijakan ServiceCallout.

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

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

Tambahkan properti keepalive.timeout.millis dengan nilai yang sesuai di bagian elemen <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 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 yang 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 dibuat pada proxy API Anda.

Mengonfigurasi waktu tunggu keep alive di Prosesor Pesan

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

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

Di mesin Message Processor, buka file berikut di editor. Jika belum ada, maka buatlah.
```
/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 dengan TIME_IN_MILLISECONDS:
```
conf/http.properties+HTTPClient.keepalive.timeout.millis=TIME_IN_MILLISECONDS
```
Misalnya, untuk mengubah waktu tunggu keep alive di Prosesor 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 ini:
```
chown apigee:apigee /opt/apigee/customer/application/message-processor.properties
```

Mulai ulang Prosesor Pesan seperti yang ditunjukkan di bawah ini:

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

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

Memverifikasi waktu tunggu keep alive di Pemroses Pesan

Bagian ini menjelaskan cara memverifikasi bahwa waktu tunggu keep alive telah berhasil diubah di Pemroses Pesan.

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

Pada mesin Message Processor, telusuri properti HTTPClient.keepalive.timeout.millis dalam direktori /opt/apigee/edge-message-processor/conf dan periksa apakah properti tersebut telah ditetapkan dengan nilai baru, seperti yang ditunjukkan di bawah ini:
```
grep -ri "HTTPClient.keepalive.timeout.millis" /opt/apigee/edge-message-processor/conf
```
Jika nilai waktu tunggu keep-alive baru berhasil ditetapkan pada Pemroses Pesan, perintah di atas akan menampilkan nilai baru dalam file http.properties.

Contoh hasil dari perintah di atas setelah Anda mengonfigurasi waktu tunggu keep alive menjadi 30 detik adalah sebagai berikut:
```
/opt/apigee/edge-message-processor/conf/http.properties:HTTPClient.keepalive.timeout.millis=30000
```
Pada 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 ke 30 detik pada 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 keep alive di Prosesor Pesan dengan benar. Jika Anda melewatkan langkah apa pun, ulangi semua langkah lagi dengan benar.
Jika Anda masih tidak dapat mengubah waktu tunggu keep alive, hubungi Dukungan Apigee Edge Google Cloud.