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 |
---|---|---|
keepalive.timeout.millis |
Proxy API:
|
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 Jika properti ini diubah dengan nilai waktu tunggu baru untuk server target yang digunakan di endpoint target atau kebijakan |
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 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 |
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.
- 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 konfigurasiTargetEndpoint
.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 untuk30
detik adalah30000
.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>
- 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.
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 konfigurasiTargetEndpoint
.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 untuk30
detik adalah30000
.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 baru30000
dihttp.properties
. Hal ini menunjukkan bahwa waktu tunggu keep alive berhasil dikonfigurasi ke30
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.