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:
|
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
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 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 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 |
Sebelum memulai
Sebelum menggunakan langkah-langkah dalam dokumen ini, pastikan Anda memahami topik berikut:
- Jika Anda tidak terbiasa dengan waktu tunggu tetap aktif, lihat
keepalive.timeout.millis
deskripsi properti di Spesifikasi Properti Transpor 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 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.
- Pada UI Edge, pilih proxy API tertentu tempat Anda ingin mengonfigurasi nilai waktu tunggu yang aktif.
- Pilih endpoint target tertentu yang ingin Anda ubah.
-
Tambahkan properti
keepalive.timeout.millis
dengan nilai yang sesuai di bagian<HTTPTargetConnection>
dalam konfigurasiTargetEndpoint
.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 untuk30
detik adalah30000
.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>
- 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
:
- Pada UI Edge, pilih proxy API tertentu tempat Anda ingin mengonfigurasi
mempertahankan nilai waktu tunggu aktif untuk kebijakan
ServiceCallout
. - Pilih kebijakan
ServiceCallout
spesifik yang ingin Anda ubah. - Tambahkan properti
keepalive.timeout.millis
dengan nilai yang sesuai di bagian<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 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>
- 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:
- 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
- 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
- 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 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 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.
- 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
-
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 baru30000
dalamhttp.properties
. Hal ini menunjukkan bahwa fungsi tetap aktif waktu tunggu berhasil dikonfigurasi menjadi30
detik pada Pemroses Pesan. - 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. - Jika Anda masih tidak dapat mengubah waktu waktu tunggu keep alive, hubungi Dukungan Apigee Edge Google Cloud.