Định cấu hình thời gian chờ kết nối 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ờ kết nối cho Bộ xử lý tin nhắn Apigee Edge.

Thời gian chờ kết nối thể hiện thời gian mà Trình xử lý thông báo chờ để thiết lập kết nối với máy chủ mục tiêu. Giá trị mặc định của thuộc tính thời gian chờ kết nối trên Trình xử lý tin nhắn mất 3 giây. Khoảng thời gian chờ này áp dụng cho máy chủ phụ trợ được định cấu hình trong cấu hình thiết bị đầu cuối đích và trong Chính sách ServiceCallout của proxy API.

Thời gian chờ kết nối cho Trình xử lý thư có thể tăng hoặc giảm từ giá trị mặc định là 3 giây dựa trên nhu cầu của bạn. Bạn có thể định cấu hình ứng dụng này theo các cách sau:

  • Trong proxy API
    • Trong điểm cuối mục tiêu
    • Trong chính sách ServiceCallout
  • Trên Trình xử lý thư

Các thuộc tính sau kiểm soát thời gian chờ kết nối trên Bộ xử lý thông báo:

Tên tài sản Vị trí Mô tả
connect.timeout.millis Proxy API:
  • Điểm cuối đích
  • ServiceCallout chính sách

Đây là thời gian tối đa mà Trình xử lý thư chờ để kết nối với máy chủ đích.

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

Nếu tài sản này được sửa đổi bằng một giá trị thời gian chờ mới cho máy chủ mục tiêu được liên kết bằng proxy API, thì thời gian kết nối chỉ bị ảnh hưởng đối với máy chủ mục tiêu đó.

HTTPClient.connect.timeout.millis Trình xử lý tin nhắn

Đây là thời gian tối đa mà Trình xử lý thư chờ để kết nối với máy chủ đích.

Thuộc tính này được dùng cho tất 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à 3 giây.

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

Trước khi bắt đầu

Trước khi làm theo các bước trong tài liệu này, hãy đảm bảo bạn hiểu rõ các chủ đề sau:

Định cấu hình thời gian chờ kết nối trong proxy API

Bạn có thể định cấu hình thời gian chờ kết nối trong proxy API ở những vị trí sau:

  • Điểm cuối đích
  • ServiceCallout chính sách

Định cấu hình thời gian chờ kết nối 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ờ kết nối trong điểm cuối mục tiêu của proxy API. Bạn có thể định cấu hình thời gian chờ kết nối thông qua thuộc tính connect.timeout.millis, Biểu thị giá trị thời gian chờ kết nối 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ờ kết nối.
  2. Chọn điểm cuối mục tiêu cụ thể mà bạn muốn sửa đổi.
  3. Thêm thuộc tính connect.timeout.millis có giá trị thích hợp trong Phần tử <HTTPTargetConnection> trong cấu hình TargetEndpoint.

    Ví dụ: để thay đổi thời gian chờ kết nối thành 5 giây, hãy thêm phương thức khối mã sau:

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

    Vì thuộc tính connect.timeout.millis tính bằng mili giây, nên giá trị cho 5 giây là 5000.

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

    Ví dụ về cấu hình thiết bị đầu cuối đí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="connect.timeout.millis">5000</Property>
        </Properties>
      </HTTPTargetConnection>
    </TargetEndpoint>
    

    Ví dụ về cấu hình thiết bị đầu cuối mục tiêu sử dụng máy chủ đích

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

Định cấu hình thời gian chờ kết nối trong chính sách ServiceAnnotation của proxy API

Phần này giải thích cách định cấu hình thời gian chờ kết nối trong ServiceCallout chính sách của proxy API. Thời gian chờ kết nối có thể được định cấu hình thông qua Thuộc tính connect.timeout.millis, biểu thị giá trị thời gian kết nối trong mili giây.

Để định cấu hình thời gian chờ kết nối trong chính sách ServiceCallout bằng cách sử dụng Thuộc tính connect.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ờ kết nố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 connect.timeout.millis có giá trị thích hợp trong Phần tử <HTTPTargetConnection> trong cấu hình TargetEndpoint.

    Ví dụ: để thay đổi thời gian chờ kết nối thành 5 giây, hãy thêm khối mã sau:

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

    Vì thuộc tính connect.timeout.millis tính bằng mili giây, nên giá trị cho 5 giây là 5000.

    Các ví dụ sau đây minh hoạ cách định cấu hình thời gian chờ kết nối trong Chính sách ServiceCallout của proxy API:

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

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

    Ví dụ về cấu hình chính sách ServiceAnnotation sử dụ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="connect.timeout.millis">5000</Property>
        </Properties>
      <Path>/test</Path>
      </HTTPTargetConnection>
    </ServiceCallout>
    
  4. Lưu các thay đổi đã thực hiện đối với proxy API.

Định cấu hình thời gian chờ kết nối trên Trình xử lý thư

Phần này giải thích cách định cấu hình thời gian chờ kết nối trên Trình xử lý thông báo. Thời gian chờ kết nối có thể được định cấu hình thông qua thuộc tính này conf_http_HTTPClient.connect.timeout.millis biểu thị thời gian chờ kết nối tính bằng mili giây trên thành phần Trình xử lý thư, sử dụng mã thông báo theo cú pháp được mô tả trong Cách định cấu hình Edge.

Để định cấu hình thời gian chờ kết nối trên Trình xử lý thư, hãy làm như sau:

  1. Trên máy Trình xử lý thư, mở tệp sau trong trình chỉnh sửa. Nếu không đã tồn tại, thì hãy tạo nó.
    /opt/apigee/customer/application/message-processor.properties
    

    Ví dụ: để mở tệp bằng vi, nhập thông tin 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_HTTPClient.connect.timeout.millis=TIME_IN_MILLISECONDS
    

    Ví dụ: để thay đổi thời gian chờ kết nối trên Trình xử lý thư thành 5 giây, thêm dòng sau:

    conf_http_HTTPClient.connect.timeout.millis=5000
    
  3. Lưu các thay đổi.
  4. Đảm bảo tệp thuộc tính thuộc sở hữu của người dùng apigee như minh hoạ dưới đây:
    chown apigee:apigee /opt/apigee/customer/application/message-processor.properties
    
  5. Khởi động lại Trình xử lý thư 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ư, hãy lặp lại các bước trên cho tất cả các Thư Bộ xử lý.

Xác minh thời gian chờ kết nối trên Trình xử lý thư

Phần này giải thích cách xác minh thời gian chờ kết nối đã được sửa đổi thành công trên Trình xử lý tin nhắn.

Mặc dù bạn sử dụng mã thông báo conf_http_HTTPClient.connect.timeout.millis để đặt hết thời gian chờ kết nối trên Trình xử lý thông báo, bạn cần xác minh xem thuộc tính HTTPClient.connect.timeout.millis đã được đặt với giá trị mới.

  1. Trên máy Xử lý thư, hãy tìm kiếm thuộc tính HTTPTransport.connect.timeout.millis trong /opt/apigee/edge-message-processor/conf và kiểm tra xem thư mục đó có đã được đặt với giá trị mới như sau:
    grep -ri "HTTPClient.connect.timeout.millis" /opt/apigee/edge-message-processor/conf
    
  2. Nếu giá trị thời gian chờ kết nối mới được đặt thành công trên Trình xử lý thông báo, thì lệnh ở trên hiển thị giá trị mới trong tệp http.properties.

    Kết quả mẫu từ lệnh trên, sau khi bạn đã định cấu hình thời gian chờ kết nối thành 5 giây như sau:

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

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

  3. Nếu bạn vẫn thấy giá trị cũ của thuộc tính HTTPClient.connect.timeout.millis, sau đó xác minh rằng bạn đã làm theo tất cả các bước nêu trong Định cấu hình thời gian chờ kết nối trên Trình xử lý thư chính xác. 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 một cách chính xác.
  4. Nếu bạn vẫn không thể sửa đổi thời gian chờ kết nối, hãy liên hệ với Bộ phận hỗ trợ Apigee Edge của Google Cloud.