Google은 AI 기술을 사용하여 콘텐츠를 사용자의 기본 언어로 번역합니다. AI 번역에는 오류가 있을 수 있습니다.

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

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

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

메시지 프로세서의 연결 유지 제한 시간을 사용하면 모든 요청/응답 쌍에 대해 새 연결을 여는 대신 단일 TCP 연결을 통해 백엔드 서버에서 여러 HTTP 요청/응답을 주고받을 수 있습니다.

메시지 프로세서의 연결 유지 제한 시간 속성의 기본값은 60초입니다. 이 제한 시간은 대상 엔드포인트 구성 및 API 프록시의 ServiceCallout 정책에 구성된 백엔드 서버에 적용됩니다.

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

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

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

속성 이름 위치 설명

속성 이름	위치	설명
`keepalive.timeout.millis`	API 프록시: 대상 엔드포인트 `ServiceCallout` 정책	이는 메시지 프로세서가 모든 요청/응답 쌍에 대해 새 연결을 여는 대신 단일 TCP 연결을 통해 여러 HTTP 요청/응답을 주고받을 수 있도록 허용하는 최대 유휴 시간입니다. 기본적으로 이 속성은 메시지 프로세서의 `HTTPClient.keepalive.timeout.millis` 속성에 설정된 값을 가져오며 기본값은 `60`초입니다. 이 속성이 특정 API 프록시의 대상 엔드포인트 또는 `ServiceCallout` 정책에 사용되는 대상 서버의 새 제한 시간 값으로 수정되면 해당 특정 대상 서버의 연결 유지 시간만 영향을 받습니다.
`HTTPClient.keepalive.timeout.millis`	메시지 프로세서	이는 메시지 프로세서가 모든 요청/응답 쌍에 대해 새 연결을 여는 대신 단일 TCP 연결을 통해 여러 HTTP 요청/응답을 주고받을 수 있도록 허용하는 최대 유휴 시간입니다. 이 속성은 이 메시지 프로세서에서 실행되는 모든 API 프록시에 사용됩니다. 이 속성의 기본값은 `60`초입니다. 아래의 메시지 프로세서에서 연결 유지 제한 시간 구성 에 설명된 대로 이 속성을 수정하거나 API 프록시 수준에서 `keepalive.timeout.millis`속성을 설정하여 이 값을 덮어쓸 수 있습니다.

keepalive.timeout.millis

API 프록시:

대상 엔드포인트
ServiceCallout 정책

이는 메시지 프로세서가 모든 요청/응답 쌍에 대해 새 연결을 여는 대신 단일 TCP 연결을 통해 여러 HTTP 요청/응답을 주고받을 수 있도록 허용하는 최대 유휴 시간입니다.

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

이 속성이 특정 API 프록시의 대상 엔드포인트 또는 ServiceCallout 정책에 사용되는 대상 서버의 새 제한 시간 값으로 수정되면 해당 특정 대상 서버의 연결 유지 시간만 영향을 받습니다.

HTTPClient.keepalive.timeout.millis

메시지 프로세서

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

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

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

시작하기 전에

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

연결 유지 제한 시간에 익숙하지 않은 경우 대상 엔드포인트 전송 속성 사양에서 keepalive.timeout.millis 속성 설명을 참고하세요.
프라이빗 클라우드용 Edge의 속성 구성에 익숙하지 않은 경우 Edge 구성 방법을 읽어보세요.

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

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

대상 엔드포인트
ServiceCallout 정책

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

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

참고: API 프록시의 대상 엔드포인트에서 연결 유지 제한 시간을 구성하면 기본값 (60초)이 새 값으로 재정의되고 구성된 특정 API 프록시에만 영향을 미칩니다. 나머지 API 프록시 는 기본 연결 유지 제한 시간 값인 60초를 계속 사용합니다.

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

예를 들어 연결 유지 제한 시간을 30초로 변경하려면 다음 코드 블록을 추가합니다.
```
<Properties>
  <Property name="keepalive.timeout.millis">30000</Property>
</Properties>
```
keepalive.timeout.millis 속성은 밀리초 단위이므로 30초의 값은 30000입니다.

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

백엔드 서버의 URL을 사용하는 대상 엔드포인트 구성 예
```
<TargetEndpoint name="default">
  <HTTPTargetConnection>
    <URL>https://mocktarget.apigee.net/json</URL>
    <Properties>
      <Property name="keepalive.timeout.millis">30000</Property>
    </Properties>
  </HTTPTargetConnection>
</TargetEndpoint>
```
대상 서버를 사용하는 대상 엔드포인트 구성 예
```
<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>
```
참고: 속성 값은 리터럴만 될 수 있습니다. 변수를 사용하여 값을 설정할 수 없습니다.
API 프록시에 적용된 변경사항을 저장합니다.

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

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

참고: API 프록시의 ServiceCallout 정책에서 연결 유지 제한 시간을 구성하면 기본값 (60초)이 새 값으로 재정의되고 구성된 특정 ServiceCallout 정책에만 영향을 미칩니다. 나머지 ServiceCallout 정책 및 API 프록시는 기본 연결 유지 제한 시간 값인 60초를 계속 사용합니다.

필수 권한: 이 작업을 수행하려면 연결 유지 제한 시간을 구성하려는 특정 API 프록시에 대한 수정 액세스 권한이 있어야 합니다. ServiceCallout 정책.

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

Edge UI에서 ServiceCallout 정책의 새 연결 유지 제한 시간 값을 구성하려는 특정 API 프록시를 선택합니다.
수정하려는 특정 ServiceCallout 정책을 선택합니다.

TargetEndpoint 구성의 <HTTPTargetConnection> 요소 아래에 적절한 값이 있는 keepalive.timeout.millis 속성을 추가합니다.

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

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

keepalive.timeout.millis 속성은 밀리초 단위이므로 30초의 값은 30000입니다.

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

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

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

대상 서버를 사용하는 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="keepalive.timeout.millis">30000</Property>
    </Properties>
    <Path>/test</Path>
  </HTTPTargetConnection>
</ServiceCallout>

API 프록시에 적용된 변경사항을 저장합니다.

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

이 섹션에서는 메시지 프로세서에서 연결 유지 제한 시간을 구성하는 방법을 설명합니다. 연결 유지 제한 시간은 메시지 프로세서 구성요소의 연결 유지 제한 시간 값을 밀리초 단위로 나타내는 HTTPClient.keepalive.timeout.millis 속성을 통해 구성할 수 있습니다. 이 속성은 메시지 프로세서에 주석 처리되어 있으므로 Edge 구성 방법 섹션에서 설명한 대로 특수 구문 conf/http.properties+HTTPClient.keepalive.timeout.millis를 사용하여 현재 주석 처리된 토큰을 설정해야 합니다.

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

메시지 프로세서 머신에서 편집기로 다음 파일을 엽니다. 파일이 아직 없는 경우 파일을 만듭니다.
```
/opt/apigee/customer/application/message-processor.properties
```
예를 들어 vi를 사용하여 파일을 열려면 다음을 입력합니다.
```
vi /opt/apigee/customer/application/message-processor.properties
```
다음 형식으로 속성 파일에 행을 추가하고 TIME_IN_MILLISECONDS의 값을 대체합니다.
```
conf/http.properties+HTTPClient.keepalive.timeout.millis=TIME_IN_MILLISECONDS
```
예를 들어 메시지 프로세서의 연결 유지 제한 시간을 30초로 변경하려면 다음 행을 추가합니다.
```
conf/http.properties+HTTPClient.keepalive.timeout.millis=30000
```
변경사항을 저장합니다.
아래와 같이 속성 파일의 소유자가 apigee 사용자인지 확인합니다.
```
chown apigee:apigee /opt/apigee/customer/application/message-processor.properties
```

아래와 같이 메시지 프로세서를 다시 시작합니다.

/opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart

메시지 프로세서가 두 개 이상인 경우 모든 메시지 프로세서에서 위의 단계를 반복합니다.

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

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

특수 구문 conf/http.properties+HTTPClient.keepalive.timeout.millis를 사용하여 메시지 프로세서에서 연결 유지 제한 시간을 설정하더라도 실제 속성 HTTPClient.keepalive.timeout.millis가 새 값으로 설정되었는지 확인해야 합니다.

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

연결 유지 제한 시간을 30초로 구성한 후 위의 명령어에서 가져온 샘플 결과는 다음과 같습니다.
```
/opt/apigee/edge-message-processor/conf/http.properties:HTTPClient.keepalive.timeout.millis=30000
```
위의 예시 출력에서 http.properties의 HTTPClient.keepalive.timeout.millis 속성이 새 값 30000으로 설정된 것을 확인할 수 있습니다. 이는 메시지 프로세서에서 연결 유지 제한 시간이 30초로 성공적으로 구성되었음을 나타냅니다.
`HTTPClient.keepalive.timeout.millis` 속성의 이전 값이 계속 표시되면HTTPClient.keepalive.timeout.millis 메시지 프로세서에서 연결 유지 제한 시간 구성에 설명된 모든 단계를 올바르게 따랐는지 확인합니다. 단계를 누락한 경우 모든 단계를 다시 올바르게 반복합니다.
연결 유지 제한 시간을 수정할 수 없는 경우 Google Cloud Apigee Edge 지원팀에 문의하세요.