Định cấu hình thời gian chờ duy trì hoạt động trên Bộ xử lý thông báo

Bạn đang xem tài liệu về Apigee Edge.
Chuyển đến tài liệu về Apigee X.
thông tin

Tài liệu này giải thích cách định cấu hình thời gian chờ duy trì thời gian chờ hoạt động cho Bộ xử lý thông báo Apigee Edge.

Thời gian chờ duy trì hoạt động trên Trình xử lý thông báo cho phép một kết nối TCP duy nhất gửi và nhận nhiều yêu cầu/phản hồi HTTP từ/đến máy chủ phụ trợ, thay vì mở một kết nối mới cho mọi cặp yêu cầu/phản hồi.

Giá trị mặc định của thuộc tính thời gian chờ duy trì hoạt động trên Bộ xử lý thông báo là 60 giây. Khoảng thời gian chờ này áp dụng cho những máy chủ phụ trợ được định cấu hình trong cấu hình điểm cuối mục tiêu và trong chính sách ServiceCallout của proxy API.

Bạn có thể tăng hoặc giảm thời gian chờ duy trì hoạt động của Bộ xử lý thông báo từ giá trị mặc định là 60 giây tuỳ theo nhu cầu của mình. Có thể định cấu hình giá trị này theo các cách sau:

  • Trong proxy API
    • Trong điểm cuối đích
    • Trong chính sách ServiceCallout
  • Trên Bộ xử lý thư

Các thuộc tính sau kiểm soát thời gian chờ duy trì hoạt động trên Bộ xử lý thông báo:

Tên tài sản Vị trí Nội dung mô tả
keepalive.timeout.millis Proxy API:
  • Điểm cuối mục tiêu
  • Chính sách của ServiceCallout

Đây là thời gian không hoạt động tối đa mà Trình xử lý thông báo cho phép một kết nối TCP duy nhất gửi và nhận nhiều yêu cầu/phản hồi HTTP, thay vì mở một kết nối mới cho mọi cặp yêu cầu/phản hồi.

Theo mặc định, thuộc tính này lấy giá trị được đặt cho thuộc tính HTTPClient.keepalive.timeout.millis trên Bộ xử lý tin nhắn, trong đó giá trị mặc định là 60 giây.

Nếu thuộc tính này được sửa đổi với một giá trị thời gian chờ mới cho máy chủ đích dùng trong điểm cuối đích hoặc chính sách ServiceCallout trong proxy API cụ thể, thì thời gian duy trì hoạt động chỉ của máy chủ đích cụ thể đó sẽ bị ảnh hưởng.

HTTPClient.keepalive.timeout.millis Bộ xử lý thư

Đây là thời gian không hoạt động tối đa mà Trình xử lý thông báo cho phép một kết nối TCP duy nhất gửi và nhận nhiều yêu cầu/phản hồi HTTP, thay vì mở một kết nối mới cho mọi cặp yêu cầu/phản hồi.

Thuộc tính này được dùng cho tất cả các proxy API chạy trên Trình xử lý thư này.

Giá trị mặc định của thuộc tính này là 60 giây.

Bạn có thể sửa đổi thuộc tính này như giải thích trong phần Định cấu hình thời gian chờ hoạt động trên Bộ xử lý thư bên dưới hoặc bạn có thể ghi đè giá trị này bằng cách đặt thuộc tính keepalive.timeout.millis ở cấp proxy API.

Trước khi bắt đầu

Trước khi sử dụng các bước trong tài liệu này, hãy đảm bảo bạn hiểu rõ những chủ đề sau:

Định cấu hình thời gian chờ hoạt động trong proxy API

Bạn có thể định cấu hình thời gian chờ duy trì hoạt động trong proxy API ở những nơi sau:

  • Điểm cuối mục tiêu
  • Chính sách của ServiceCallout

Định cấu hình thời gian chờ hoạt động trong điểm cuối đích của proxy API

Phần này giải thích cách định cấu hình thời gian chờ hoạt động tại điểm cuối đích của proxy API. Bạn có thể định cấu hình thời gian chờ duy trì hoạt động thông qua thuộc tính keepalive.timeout.millis. Thuộc tính này thể hiện giá trị thời gian chờ duy trì hoạt động tính bằng mili giây.

  1. Trong giao diện người dùng Edge, hãy chọn proxy API cụ thể mà bạn muốn định cấu hình giá trị thời gian chờ duy trì hoạt động mới.
  2. Chọn điểm cuối đích cụ thể mà bạn muốn sửa đổi.
  3. Thêm thuộc tính keepalive.timeout.millis có giá trị thích hợp trong phần tử <HTTPTargetConnection> của cấu hình TargetEndpoint.

    Ví dụ: để thay đổi Thời gian chờ duy trì hoạt động thành 30 giây, hãy thêm khối mã sau:

    <Properties>
      <Property name="keepalive.timeout.millis">30000</Property>
    </Properties>
    

    Vì thuộc tính keepalive.timeout.millis tính bằng mili giây nên giá trị cho 30 giây là 30000.

    Các ví dụ sau đây minh hoạ cách định cấu hình thời gian chờ duy trì hoạt động trong cấu hình điểm cuối đích của proxy API:

    Ví dụ về cấu hình điểm cuối đích bằng cách sử dụng URL cho máy chủ phụ trợ

    <TargetEndpoint name="default">
      <HTTPTargetConnection>
        <URL>https://mocktarget.apigee.net/json</URL>
        <Properties>
          <Property name="keepalive.timeout.millis">30000</Property>
        </Properties>
      </HTTPTargetConnection>
    </TargetEndpoint>
    

    Ví dụ về cấu hình điểm cuối mục tiêu bằng máy chủ đích

    <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>
    
  4. Lưu các thay đổi đã thực hiện đối với proxy API của bạn.

Định cấu hình thời gian chờ duy trì hoạt động trong Chính sách Chú thích dịch vụ của proxy API

Phần này giải thích cách định cấu hình thời gian chờ duy trì hoạt động trong chính sách ServiceCallout của proxy API. Bạn có thể định cấu hình thời gian chờ duy trì hoạt động thông qua thuộc tính the keepalive.timeout.millis, thể hiện giá trị thời gian chờ duy trì hoạt động tính bằng mili giây.

Cách định cấu hình thời gian chờ duy trì hoạt động trong chính sách ServiceCallout bằng thuộc tính keepalive.timeout.millis:

  1. Trong giao diện người dùng Edge, hãy chọn proxy API cụ thể mà bạn muốn định cấu hình giá trị thời gian chờ duy trì hoạt động mới cho chính sách ServiceCallout.
  2. Chọn chính sách ServiceCallout cụ thể mà bạn muốn sửa đổi.
  3. Thêm thuộc tính keepalive.timeout.millis với giá trị thích hợp trong phần tử <HTTPTargetConnection> của cấu hình TargetEndpoint.

    Ví dụ: để thay đổi thời gian chờ duy trì hoạt động thành 30 giây, hãy thêm khối mã sau:

    <Properties>
      <Property name="keepalive.timeout.millis">30000</Property>
    </Properties>
    

    Vì thuộc tính keepalive.timeout.millis tính bằng mili giây nên giá trị cho 30 giây là 30000.

    Các ví dụ sau đây minh hoạ cách định cấu hình thời gian chờ duy trì hoạt động trong chính sách ServiceCallout của proxy API:

    Ví dụ về cấu hình chính sách Chú thích dịch vụ sử dụng URL cho máy chủ phụ trợ

    <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>
    

    Cấu hình chính sách Chú thích dịch vụ mẫu bằng máy chủ mục tiêu

    <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>
    
  4. Lưu các thay đổi đã thực hiện đối với proxy API của bạn.

Định cấu hình thời gian chờ hoạt động trên Bộ xử lý thư

Phần này giải thích cách định cấu hình thời gian chờ duy trì hoạt động trên Bộ xử lý thông báo. Bạn có thể định cấu hình thời gian chờ duy trì hoạt động thông qua thuộc tính HTTPClient.keepalive.timeout.millis. Thuộc tính này thể hiện giá trị thời gian chờ duy trì hoạt động tính bằng mili giây trên thành phần Trình xử lý thông báo. Vì thuộc tính này được nhận xét trên Trình xử lý thông báo, nên bạn cần sử dụng cú pháp đặc biệt conf/http.properties+HTTPClient.keepalive.timeout.millis như mô tả trong phần Thiết lập mã thông báo đang được nhận xét trong Cách định cấu hình Edge.

Để định cấu hình thời gian chờ duy trì hoạt động trên Bộ xử lý thư, hãy làm như sau:

  1. Trên máy Xử lý thư, mở tệp sau trong một trình chỉnh sửa. Nếu chưa có, hãy tạo tài khoản mới.
    /opt/apigee/customer/application/message-processor.properties
    

    Ví dụ: để mở tệp bằng vi, hãy nhập như sau:

    vi /opt/apigee/customer/application/message-processor.properties
    
  2. Thêm một dòng ở định dạng sau vào tệp thuộc tính, thay thế giá trị cho TIME_IN_MILLISECONDS:
    conf/http.properties+HTTPClient.keepalive.timeout.millis=TIME_IN_MILLISECONDS
    

    Ví dụ: để thay đổi thời gian chờ hoạt động trên Bộ xử lý thông báo thành 30 giây, hãy thêm dòng sau:

    conf/http.properties+HTTPClient.keepalive.timeout.millis=30000
    
  3. Lưu các thay đổi.
  4. Đảm bảo tệp thuộc tính do người dùng apigee sở hữu như minh hoạ bên dưới:
    chown apigee:apigee /opt/apigee/customer/application/message-processor.properties
    
  5. Khởi động lại Bộ xử lý tin nhắn như minh hoạ dưới đây:
    /opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart
    
  6. Nếu bạn có nhiều Trình xử lý thông báo, hãy lặp lại các bước trên cho tất cả các Trình xử lý thông báo.

Xác minh thời gian chờ duy trì hoạt động trên Bộ xử lý thư

Phần này giải thích cách xác minh rằng thời gian chờ duy trì hoạt động đã được sửa đổi thành công trên Bộ xử lý thông báo.

Mặc dù bạn sử dụng cú pháp đặc biệt conf/http.properties+HTTPClient.keepalive.timeout.millis để đặt thời gian chờ duy trì hoạt động trên Trình xử lý thông báo, nhưng bạn vẫn cần xác minh xem thuộc tính thực tế HTTPClient.keepalive.timeout.millis đã được đặt với giá trị mới hay chưa.

  1. Trên máy xử lý thư, hãy tìm thuộc tính HTTPClient.keepalive.timeout.millis trong thư mục /opt/apigee/edge-message-processor/conf rồi kiểm tra xem thuộc tính này đã được thiết lập bằng giá trị mới hay chưa:
    grep -ri "HTTPClient.keepalive.timeout.millis" /opt/apigee/edge-message-processor/conf
    
  2. Nếu bạn thiết lập thành công giá trị thời gian chờ duy trì hoạt động trên Bộ xử lý thông báo, thì lệnh trên sẽ hiển thị giá trị mới trong tệp http.properties.

    Kết quả mẫu của lệnh trên sau khi bạn đã định cấu hình để duy trì thời gian chờ hoạt động tới 30 giây như sau:

    /opt/apigee/edge-message-processor/conf/http.properties:HTTPClient.keepalive.timeout.millis=30000
    

    Trong kết quả ví dụ ở trên, hãy lưu ý rằng thuộc tính HTTPClient.keepalive.timeout.millis đã được thiết lập bằng giá trị mới 30000 trong http.properties. Điều này cho biết thời gian chờ duy trì hoạt động đã được định cấu hình thành công thành 30 giây trên Trình xử lý thông báo.

  3. Nếu bạn vẫn thấy giá trị cũ cho thuộc tính HTTPClient.keepalive.timeout.millis, hãy kiểm tra để đảm bảo bạn đã làm theo đúng tất cả bước trong bài viết Định cấu hình thời gian chờ duy trì hoạt động trên Bộ xử lý thông báo. Nếu bạn bỏ lỡ bất kỳ bước nào, hãy lặp lại tất cả các bước đúng cách một lần nữa.
  4. Nếu bạn vẫn không thể sửa đổi thời gian chờ duy trì hoạt động, hãy liên hệ với Nhóm hỗ trợ API API của Google Cloud.