Anda sedang melihat dokumentasi Apigee Edge.
Buka dokumentasi
Apigee X. info
Dokumen ini menjelaskan cara mengonfigurasi waktu tunggu koneksi untuk Pemroses Pesan Apigee Edge.
Waktu tunggu koneksi menunjukkan waktu yang digunakan Message Processor untuk menunggu pembentukan koneksi dengan server target. Nilai default properti waktu tunggu koneksi di
Message Processor adalah 3 detik. Periode waktu tunggu ini berlaku untuk
server backend yang dikonfigurasi dalam konfigurasi endpoint target dan dalam
kebijakan ServiceCallout proxy API Anda.
Waktu tunggu koneksi untuk Pemroses Pesan dapat ditingkatkan atau diturunkan dari nilai default 3 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 koneksi di Pemroses Pesan:
| Nama properti | Lokasi | Deskripsi |
|---|---|---|
connect.timeout.millis |
Proxy API:
|
Ini adalah waktu maksimum yang ditunggu oleh Message Processor untuk terhubung dengan server target.
Secara default, properti ini mengambil nilai yang ditetapkan untuk
properti Jika properti ini diubah dengan nilai waktu tunggu baru untuk server target yang terkait dengan proxy API, maka waktu koneksi hanya untuk server target tersebut yang terpengaruh. |
HTTPClient.connect.timeout.millis |
Message Processor |
Ini adalah waktu maksimum yang ditunggu oleh Message Processor untuk terhubung ke server target. Properti ini digunakan untuk semua proxy API yang berjalan di Message Processor ini.
Nilai default properti ini adalah
Anda dapat mengubah properti ini seperti yang dijelaskan di
Mengonfigurasi waktu tunggu koneksi di Pemroses Pesan di bawah, atau Anda dapat mengganti nilai ini
dengan menyetel properti |
Sebelum memulai
Sebelum menggunakan langkah-langkah dalam dokumen ini, pastikan Anda memahami topik berikut:
- Jika Anda belum memahami waktu tunggu koneksi, lihat deskripsi properti
connect.timeout.millisdi Spesifikasi Properti Transportasi TargetEndpoint. - Jika Anda belum memahami cara mengonfigurasi properti untuk Edge di Private Cloud, baca Cara mengonfigurasi Edge.
Mengonfigurasi waktu tunggu koneksi di proxy API
Waktu tunggu koneksi dapat dikonfigurasi di proxy API di lokasi berikut:
- Endpoint target
- Kebijakan terkait
ServiceCallout
Mengonfigurasi waktu tunggu koneksi di endpoint target proxy API
Bagian ini menjelaskan cara mengonfigurasi waktu tunggu koneksi di endpoint target proxy API Anda.
Waktu tunggu koneksi dapat dikonfigurasi melalui properti connect.timeout.millis,
yang merepresentasikan nilai waktu tunggu koneksi dalam milidetik.
- Di UI Edge, pilih proxy API tertentu tempat Anda ingin mengonfigurasi nilai waktu tunggu koneksi baru.
- Pilih endpoint target spesifik yang ingin Anda ubah.
- Tambahkan properti
connect.timeout.millisdengan nilai yang sesuai di bawah elemen<HTTPTargetConnection>dalam konfigurasiTargetEndpoint.Misalnya, untuk mengubah waktu tunggu koneksi menjadi
5detik, tambahkan blok kode berikut:<Properties> <Property name="connect.timeout.millis">5000</Property> </Properties>
Karena properti
connect.timeout.millisdalam milidetik, nilai untuk5detik adalah5000.Contoh berikut menunjukkan cara mengonfigurasi waktu tunggu koneksi 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="connect.timeout.millis">5000</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="connect.timeout.millis">5000</Property> </Properties> <Path>/test</Path> </HTTPTargetConnection> </TargetEndpoint> - Simpan perubahan yang dilakukan pada proxy API Anda.
Mengonfigurasi waktu tunggu koneksi dalam kebijakan ServiceCallout proxy API
Bagian ini menjelaskan cara mengonfigurasi waktu tunggu koneksi dalam kebijakan ServiceCallout
proxy API Anda. Waktu tunggu koneksi dapat dikonfigurasi melalui
properti connect.timeout.millis, yang merepresentasikan nilai waktu koneksi dalam
milidetik.
Untuk mengonfigurasi waktu tunggu koneksi dalam kebijakan ServiceCallout menggunakan
properti connect.timeout.millis:
- Di UI Edge, pilih proxy API tertentu tempat Anda ingin mengonfigurasi nilai waktu tunggu koneksi baru untuk kebijakan
ServiceCallout. - Pilih kebijakan
ServiceCallouttertentu yang ingin Anda ubah. - Tambahkan properti
connect.timeout.millisdengan nilai yang sesuai di bawah elemen<HTTPTargetConnection>dalam konfigurasiTargetEndpoint.Misalnya, untuk mengubah waktu tunggu koneksi menjadi
5detik, tambahkan blok kode berikut:<Properties> <Property name="connect.timeout.millis">5000</Property> </Properties>
Karena properti
connect.timeout.millisdalam milidetik, nilai untuk5detik adalah5000.Contoh berikut menunjukkan cara mengonfigurasi waktu tunggu koneksi dalam kebijakan
ServiceCalloutproxy 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="connect.timeout.millis">5000</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="connect.timeout.millis">5000</Property> </Properties> <Path>/test</Path> </HTTPTargetConnection> </ServiceCallout> - Simpan perubahan yang dilakukan pada proxy API Anda.
Mengonfigurasi waktu tunggu koneksi di Pemroses Pesan
Bagian ini menjelaskan cara mengonfigurasi waktu tunggu koneksi di Pemroses Pesan.
Waktu tunggu koneksi dapat dikonfigurasi melalui properti
conf_http_HTTPClient.connect.timeout.millis, yang merepresentasikan nilai
waktu tunggu koneksi dalam milidetik pada komponen Message Processor, menggunakan token sesuai dengan
sintaksis yang dijelaskan dalam
Cara mengonfigurasi Edge.
Untuk mengonfigurasi waktu tunggu koneksi 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_HTTPClient.connect.timeout.millis=TIME_IN_MILLISECONDS
Misalnya, untuk mengubah waktu tunggu koneksi di Message Processor menjadi
5detik, tambahkan baris berikut:conf_http_HTTPClient.connect.timeout.millis=5000
- Simpan perubahan.
- Pastikan file properti dimiliki oleh pengguna
apigeeseperti 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 koneksi di Pemroses Pesan
Bagian ini menjelaskan cara memverifikasi bahwa waktu tunggu koneksi telah berhasil diubah di Prosesor Pesan.
Meskipun Anda menggunakan token conf_http_HTTPClient.connect.timeout.millis untuk menetapkan
waktu tunggu koneksi di Pemroses Pesan, Anda perlu memverifikasi apakah properti HTTPClient.connect.timeout.millis yang sebenarnya telah ditetapkan dengan nilai baru.
- Di mesin Message Processor, telusuri properti
HTTPTransport.connect.timeout.millisdi direktori/opt/apigee/edge-message-processor/confdan periksa apakah properti tersebut telah ditetapkan dengan nilai baru seperti yang ditunjukkan di bawah:grep -ri "HTTPClient.connect.timeout.millis" /opt/apigee/edge-message-processor/conf
- Jika nilai waktu tunggu koneksi baru berhasil ditetapkan di Message Processor, perintah
di atas akan menampilkan nilai baru dalam file
http.properties.Contoh hasil dari perintah di atas setelah Anda mengonfigurasi waktu tunggu koneksi menjadi
5detik adalah sebagai berikut:/opt/apigee/edge-message-processor/conf/http.properties:HTTPClient.connect.timeout.millis=5000
Dalam contoh output di atas, perhatikan bahwa properti
HTTPClient.connect.timeout.millistelah ditetapkan dengan nilai baru5000dihttp.properties. Hal ini menunjukkan bahwa waktu tunggu koneksi berhasil dikonfigurasi menjadi5detik di Message Processor. - Jika Anda masih melihat nilai lama untuk properti
HTTPClient.connect.timeout.millis, maka pastikan Anda telah mengikuti semua langkah yang diuraikan dalam Mengonfigurasi waktu tunggu koneksi di Pemroses Pesan dengan benar. Jika Anda melewatkan langkah apa pun, ulangi semua langkah dengan benar. - Jika Anda masih tidak dapat mengubah waktu tunggu koneksi, hubungi Dukungan Apigee Edge Google Cloud.