Halaman ini diterjemahkan oleh Cloud Translation API.

Mengonfigurasi waktu tunggu koneksi pada Pemroses Pesan

Anda sedang melihat dokumentasi Apigee Edge.
Buka dokumentasi Apigee X. info

Dokumen ini menjelaskan cara mengonfigurasi waktu tunggu koneksi untuk Apigee Edge Message Processors.

Waktu tunggu koneksi menunjukkan waktu tunggu saat Pemroses Pesan menunggu untuk membuat koneksi dengan server target. Nilai default properti waktu tunggu koneksi pada Pemroses Pesan adalah 3 detik. Periode waktu tunggu ini berlaku untuk server backend yang dikonfigurasi di 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. Ini dapat dikonfigurasi dengan cara berikut:

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

Properti berikut mengontrol waktu tunggu koneksi di Prosesor Pesan:

Nama properti Lokasi Deskripsi

Nama properti	Lokasi	Deskripsi
`connect.timeout.millis`	Proxy API: Endpoint target Kebijakan `ServiceCallout`	Waktu ini adalah waktu maksimum yang mana Pemroses Pesan menunggu untuk terhubung dengan server target. Secara default, properti ini menggunakan nilai yang ditetapkan untuk properti `HTTPClient.connect.timeout.millis` di Pemroses Pesan, dengan nilai defaultnya adalah `3` detik. Jika properti ini dimodifikasi dengan nilai waktu tunggu baru untuk server target yang dikaitkan dengan proxy API, waktu koneksi hanya untuk server target tersebut yang akan terpengaruh.
`HTTPClient.connect.timeout.millis`	Message Processor	Ini adalah waktu maksimum saat Pemroses Pesan menunggu untuk terhubung ke server target. Properti ini digunakan untuk semua proxy API yang berjalan di Pemroses Pesan ini. Nilai default properti ini adalah `3` detik. Anda dapat mengubah properti ini seperti yang dijelaskan dalam Mengonfigurasi waktu tunggu koneksi di Prosesor Pesan di bawah, atau Anda dapat menimpa nilai ini dengan menyetel properti `connect.timeout.millis` pada level proxy API.

connect.timeout.millis

Proxy API:

Endpoint target
Kebijakan ServiceCallout

Waktu ini adalah waktu maksimum yang mana Pemroses Pesan menunggu untuk terhubung dengan server target.

Secara default, properti ini menggunakan nilai yang ditetapkan untuk properti HTTPClient.connect.timeout.millis di Pemroses Pesan, dengan nilai defaultnya adalah 3 detik.

Jika properti ini dimodifikasi dengan nilai waktu tunggu baru untuk server target yang dikaitkan dengan proxy API, waktu koneksi hanya untuk server target tersebut yang akan terpengaruh.

HTTPClient.connect.timeout.millis

Message Processor

Ini adalah waktu maksimum saat Pemroses Pesan menunggu untuk terhubung ke server target.

Properti ini digunakan untuk semua proxy API yang berjalan di Pemroses Pesan ini.

Nilai default properti ini adalah 3 detik.

Anda dapat mengubah properti ini seperti yang dijelaskan dalam Mengonfigurasi waktu tunggu koneksi di Prosesor Pesan di bawah, atau Anda dapat menimpa nilai ini dengan menyetel properti connect.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 koneksi, lihat deskripsi properti connect.timeout.millis di Spesifikasi Properti Transportasi TargetEndpoint.
Jika Anda tidak terbiasa 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 tempat berikut:

Endpoint target
Kebijakan 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 mewakili nilai waktu tunggu koneksi dalam milidetik.

Catatan: Mengonfigurasi waktu koneksi di endpoint target proxy API Anda akan mengganti nilai default (3 detik) dengan nilai baru dan hanya memengaruhi proxy API tertentu tempat proxy dikonfigurasi. Proxy API lainnya tetap menggunakan nilai waktu tunggu koneksi default 3 detik.

Di UI Edge, pilih proxy API tertentu tempat Anda ingin mengonfigurasi nilai waktu tunggu koneksi baru.
Pilih endpoint target tertentu yang ingin Anda ubah.
Tambahkan properti connect.timeout.millis dengan nilai yang sesuai di bagian elemen <HTTPTargetConnection> dalam konfigurasi TargetEndpoint.
Misalnya, untuk mengubah waktu tunggu koneksi menjadi 5 detik, tambahkan blok kode berikut:
```
<Properties>
  <Property name="connect.timeout.millis">5000</Property>
</Properties>
```
Karena properti connect.timeout.millis dalam milidetik, nilai untuk 5 detik adalah 5000.

Contoh berikut menunjukkan cara mengonfigurasi waktu tunggu koneksi di 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 yang 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>
```
Catatan: Nilai properti hanya boleh literal. Anda tidak dapat menetapkan nilai menggunakan variabel.
Simpan perubahan yang dibuat pada proxy API Anda.

Mengonfigurasi waktu tunggu koneksi di 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 mewakili nilai waktu koneksi dalam milidetik.

Catatan: Mengonfigurasi waktu tunggu koneksi dalam kebijakan ServiceCallout di proxy API akan mengganti nilai default (3 detik) dengan nilai baru dan hanya memengaruhi kebijakan ServiceCallout tertentu tempat nilai dikonfigurasi. Kebijakan ServiceCallout dan Proxy API lainnya tetap menggunakan nilai waktu tunggu koneksi default 3 detik.

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

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 ServiceCallout tertentu yang ingin Anda ubah.

Tambahkan properti connect.timeout.millis dengan nilai yang sesuai di bagian elemen <HTTPTargetConnection> dalam konfigurasi TargetEndpoint.

Misalnya untuk mengubah waktu tunggu koneksi menjadi 5 detik, tambahkan blok kode berikut:

<Properties>
  <Property name="connect.timeout.millis">5000</Property>
</Properties>

Karena properti connect.timeout.millis dalam milidetik, nilai untuk 5 detik adalah 5000.

Contoh berikut menunjukkan cara mengonfigurasi waktu tunggu koneksi pada 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="connect.timeout.millis">5000</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="connect.timeout.millis">5000</Property>
    </Properties>
  <Path>/test</Path>
  </HTTPTargetConnection>
</ServiceCallout>

Simpan perubahan yang dibuat pada proxy API Anda.

Mengonfigurasi waktu tunggu koneksi di Prosesor Pesan

Bagian ini menjelaskan cara mengonfigurasi waktu tunggu koneksi pada Pemroses Pesan. Waktu tunggu koneksi dapat dikonfigurasi melalui properti conf_http_HTTPClient.connect.timeout.millis, yang mewakili nilai waktu tunggu koneksi dalam milidetik pada komponen Pemroses Pesan, menggunakan token sesuai dengan sintaksis yang dijelaskan dalam Cara mengonfigurasi Edge.

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

Di mesin Message Processor, buka file berikut di editor. Jika belum ada, maka 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 dengan TIME_IN_MILLISECONDS:
```
conf_http_HTTPClient.connect.timeout.millis=TIME_IN_MILLISECONDS
```
Misalnya, untuk mengubah waktu tunggu koneksi di Message Processor menjadi 5 detik, tambahkan baris berikut:
```
conf_http_HTTPClient.connect.timeout.millis=5000
```
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 koneksi pada Pemroses Pesan

Bagian ini menjelaskan cara memverifikasi bahwa waktu tunggu koneksi telah berhasil diubah pada Pemroses Pesan.

Meskipun Anda menggunakan token conf_http_HTTPClient.connect.timeout.millis untuk menetapkan waktu tunggu koneksi pada Pemroses Pesan, Anda harus memverifikasi apakah properti HTTPClient.connect.timeout.millis yang sebenarnya telah ditetapkan dengan nilai baru.

Pada mesin Message Processor, telusuri properti HTTPTransport.connect.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.connect.timeout.millis" /opt/apigee/edge-message-processor/conf
```
Jika nilai waktu tunggu koneksi baru berhasil ditetapkan di Pemroses Pesan, perintah di atas akan menampilkan nilai baru dalam file http.properties.
Contoh hasil dari perintah di atas setelah Anda mengonfigurasi waktu tunggu koneksi ke 5 detik adalah sebagai berikut:
```
/opt/apigee/edge-message-processor/conf/http.properties:HTTPClient.connect.timeout.millis=5000
```
Pada contoh output di atas, perhatikan bahwa properti HTTPClient.connect.timeout.millis telah ditetapkan dengan nilai baru 5000 di http.properties. Hal ini menunjukkan bahwa waktu tunggu koneksi berhasil dikonfigurasi ke 5 detik pada Pemroses Pesan.
Jika Anda masih melihat nilai lama untuk properti HTTPClient.connect.timeout.millis, 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 lagi dengan benar.
Jika Anda masih tidak dapat mengubah waktu tunggu koneksi, hubungi Dukungan Apigee Edge Google Cloud.