메시지 프로세서에서 연결 제한 시간 구성

Apigee Edge 문서입니다.
Go to the Apigee X 문서로 이동합니다. info

이 문서에서는 Apigee Edge 메시지 프로세서의 연결 제한 시간을 구성하는 방법을 설명합니다.

연결 제한 시간은 메시지 프로세서가 대상 서버와의 연결을 설정하기 위해 대기하는 시간을 나타냅니다. 메시지 프로세서의 연결 제한 시간 속성의 기본값은 3초입니다. 이 제한 시간은 대상 엔드포인트 구성 및 API 프록시의 ServiceCallout 정책에 구성된 백엔드 서버에 적용됩니다.

메시지 프로세서의 연결 제한 시간은 필요에 따라 기본값인 3초에서 늘리거나 줄일 수 있습니다. 다음과 같은 방법으로 구성할 수 있습니다.

  • API 프록시에서
    • 대상 엔드포인트에서
    • ServiceCallout 정책에서
  • 메시지 프로세서에서

다음 속성은 메시지 프로세서의 연결 제한 시간을 제어합니다.

속성 이름 위치 설명
connect.timeout.millis API 프록시:
  • 대상 엔드포인트
  • ServiceCallout 정책

메시지 프로세서가 대상 서버에 연결하기 위해 대기하는 최대 시간입니다.

기본적으로 이 속성은 메시지 프로세서의 HTTPClient.connect.timeout.millis 속성에 설정된 값을 가져오며 기본값은 3초입니다.

이 속성이 API 프록시와 연결된 대상 서버의 새 제한 시간 값으로 수정되면 해당 대상 서버의 연결 시간에만 영향을 미칩니다.

HTTPClient.connect.timeout.millis 메시지 프로세서

메시지 프로세서가 대상 서버에 연결하기 위해 대기하는 최대 시간입니다.

이 속성은 이 메시지 프로세서에서 실행되는 모든 API 프록시에 사용됩니다.

이 속성의 기본값은 3초입니다.

아래의 메시지 프로세서에서 연결 제한 시간 구성에 설명된 대로 이 속성을 수정하거나 API 프록시 수준에서 connect.timeout.millis 속성을 설정하여 이 값을 덮어쓸 수 있습니다.

시작하기 전에

이 문서의 단계를 사용하기 전에 다음 주제를 이해해야 합니다.

API 프록시에서 연결 제한 시간 구성

연결 제한 시간은 API 프록시의 다음 위치에서 구성할 수 있습니다.

  • 대상 엔드포인트
  • ServiceCallout 정책

API 프록시의 대상 엔드포인트에서 연결 제한 시간 구성

이 섹션에서는 API 프록시의 대상 엔드포인트에서 연결 제한 시간을 구성하는 방법을 설명합니다. 연결 제한 시간은 밀리초 단위의 연결 제한 시간 값을 나타내는 connect.timeout.millis, 속성을 통해 구성할 수 있습니다.

  1. Edge UI에서 새 연결 제한 시간 값을 구성하려는 특정 API 프록시를 선택합니다.
  2. 수정하려는 특정 대상 엔드포인트를 선택합니다.
  3. `TargetEndpoint` 구성의 ` <HTTPTargetConnection>` 요소 아래에 적절한 값으로 `connect.timeout.millis ` 속성을 추가합니다.

    예를 들어 연결 제한 시간을 5초로 변경하려면 다음 코드 블록을 추가합니다. 

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

    connect.timeout.millis 속성은 밀리초 단위이므로 5초의 값은 5000입니다.

    다음 예에서는 API 프록시의 대상 엔드포인트 구성에서 연결 제한 시간을 구성하는 방법을 보여줍니다.

    백엔드 서버의 URL을 사용하는 대상 엔드포인트 구성 예

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

    대상 서버를 사용하는 대상 엔드포인트 구성 예

    <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. API 프록시에 적용된 변경사항을 저장합니다.

API 프록시의 ServiceCallout 정책에서 연결 제한 시간 구성

이 섹션에서는 API 프록시의 ServiceCallout 정책에서 연결 제한 시간을 구성하는 방법을 설명합니다. 연결 제한 시간은 밀리초 단위의 연결 시간 값을 나타내는 connect.timeout.millis 속성을 통해 구성할 수 있습니다.

connect.timeout.millis 속성을 사용하여 ServiceCallout 정책에서 연결 제한 시간을 구성하려면 다음 단계를 따르세요.

  1. Edge UI에서 ServiceCallout 정책의 새 연결 제한 시간 값을 구성하려는 특정 API 프록시를 선택합니다.
  2. 수정하려는 특정 ServiceCallout 정책을 선택합니다.
  3. TargetEndpoint 구성의 <HTTPTargetConnection> 요소 아래에 적절한 값으로 connect.timeout.millis 속성을 추가합니다.

    예를 들어 연결 제한 시간을 5초로 변경하려면 다음 코드 블록을 추가합니다. 

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

    connect.timeout.millis 속성은 밀리초 단위이므로 5초의 값은 5000입니다.

    다음 예에서는 API 프록시의 ServiceCallout 정책에서 연결 제한 시간을 구성하는 방법을 보여줍니다.

    백엔드 서버의 URL을 사용하는 ServiceCallout 정책 구성 예

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

    대상 서버를 사용하는 ServiceCallout 정책 구성 예

    <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. API 프록시에 적용된 변경사항을 저장합니다.

메시지 프로세서에서 연결 제한 시간 구성

이 섹션에서는 메시지 프로세서에서 연결 제한 시간을 구성하는 방법을 설명합니다. 연결 제한 시간은 메시지 프로세서 구성요소의 연결 제한 시간 값을 밀리초 단위로 나타내는 속성 conf_http_HTTPClient.connect.timeout.millis을 통해 Edge 구성 방법에 설명된 구문에 따라 토큰을 사용하여 구성할 수 있습니다.

메시지 프로세서에서 연결 제한 시간을 구성하려면 다음 단계를 따르세요.

  1. 메시지 프로세서 머신에서 편집기로 다음 파일을 엽니다. 파일이 아직 없는 경우 만듭니다. 
    /opt/apigee/customer/application/message-processor.properties

    예를 들어 vi를 사용하여 파일을 열려면 다음을 입력합니다. 

    vi /opt/apigee/customer/application/message-processor.properties
  2. 다음 형식으로 속성 파일에 행을 추가하고 TIME_IN_MILLISECONDS의 값을 대체합니다. 
    conf_http_HTTPClient.connect.timeout.millis=TIME_IN_MILLISECONDS

    예를 들어 메시지 프로세서의 연결 제한 시간을 5초로 변경하려면 다음 행을 추가합니다. 

    conf_http_HTTPClient.connect.timeout.millis=5000
  3. 변경사항을 저장합니다.
  4. 아래와 같이 속성 파일의 소유자가 apigee 사용자인지 확인합니다. 
    chown apigee:apigee /opt/apigee/customer/application/message-processor.properties
  5. 아래와 같이 메시지 프로세서를 다시 시작합니다. 
    /opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart
  6. 메시지 프로세서가 두 개 이상인 경우 모든 메시지 프로세서에서 위의 단계를 반복합니다.

메시지 프로세서에서 연결 제한 시간 확인

이 섹션에서는 메시지 프로세서에서 연결 제한 시간이 성공적으로 수정되었는지 확인하는 방법을 설명합니다.

메시지 프로세서에서 연결 제한 시간을 설정하는 데 conf_http_HTTPClient.connect.timeout.millis 토큰을 사용하더라도 실제 속성 HTTPClient.connect.timeout.millis가 새 값으로 설정되었는지 확인해야 합니다.

  1. 메시지 프로세서 머신에서 HTTPTransport.connect.timeout.millis 디렉터리에서 /opt/apigee/edge-message-processor/conf 속성을 검색하고 아래와 같이 새 값으로 설정되었는지 확인합니다. 
    grep -ri "HTTPClient.connect.timeout.millis" /opt/apigee/edge-message-processor/conf
  2. 메시지 프로세서에서 새 연결 제한 시간 값이 성공적으로 설정되면 위의 명령어는 http.properties 파일에 새 값을 표시합니다.

    연결 제한 시간을 5초로 구성한 후 위의 명령어에서 가져온 샘플 결과는 다음과 같습니다. 

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

    위의 예시 출력에서 http.properties의 HTTPClient.connect.timeout.millis 속성이 새 값 5000으로 설정된 것을 확인할 수 있습니다. 이는 메시지 프로세서에서 연결 제한 시간이 5초로 성공적으로 구성되었음을 나타냅니다.

  3. HTTPClient.connect.timeout.millis 속성의 이전 값이 계속 표시되면 메시지 프로세서에서 연결 제한 시간 구성에 설명된 모든 단계를 올바르게 따랐는지 확인합니다. 단계를 누락한 경우 모든 단계를 다시 올바르게 반복합니다.
  4. 연결 제한 시간을 수정할 수 없는 경우 Google Cloud Apigee Edge 지원팀에 문의하세요.