<ph type="x-smartling-placeholder"></ph>
현재 Apigee Edge 문서를 보고 있습니다.
Apigee X 문서. 정보
Apigee에서 라우터는 기본값입니다. 그러나 사용 권한을 확인하기 위해 추가 정보를 수집해야 하는 경우도 특정 오류가 발생한 이유를 확인할 수 있습니다. 이를 수행하는 방법 중 하나는 디버그 로그를 얻을 수 있도록 디버그 모드로 작동해야 합니다. 신속하게 해결할 수 있습니다.
이 문서에서는 다음 인스턴스의 요청에 대해 Apigee Edge의 라우터에서 디버그 로그를 사용 설정하는 방법을 설명합니다. 지정할 수도 있습니다 디버그 로깅을 사용 설정하여 더 많은 정보를 캡처할 수 있습니다. 잘못된 형식의 요청이나 <ph type="x-smartling-placeholder"></ph> 400 잘못된 요청 - SSL 인증서 오류 북쪽 방면 (클라이언트 애플리케이션과 라우터 사이)에 연결합니다.
<ph type="x-smartling-placeholder">시작하기 전에
- NGINX 오류 로그와 로깅 수준에 익숙하지 않은 경우 NGINX 오류 로그 문서
- 대상 API 요청의 조직, 환경 및 가상 호스트 이름을 수집합니다. 디버그 정보를 수집해야 합니다
라우터에서 NGINX 디버그 로그 사용 설정
이 섹션에서는 Edge Router에서 디버그 로그를 사용 설정하는 방법을 설명합니다.
<ph type="x-smartling-placeholder">관련 가상 호스트 구성 파일 식별
다음 단계에서는 라우터에서 관련 가상 호스트 구성 파일을 찾는 방법을 설명합니다.
- 특정 API의 조직 이름, 환경 이름, 가상 호스트를 알고 있는 경우
디버그하려는 포드를 호출한 다음
가상 호스트 conf 파일을 다음과 같이 결정합니다.
<ph type="x-smartling-placeholder">
- </ph>
/opt/nginx/conf.d/디렉터리로 이동합니다.- ORG_NAME_ENV_NAME_VIRTUALHOST
.conf파일 검색 파일을conf.d디렉터리에 저장합니다.ls -ltrh | grep "ORG_NAME_ENV_NAME_VIRTUALHOST_NAME"
-
조직 이름을 모르는 경우 가상 호스트 구성을 식별할 수 있습니다. 파일을 만들 수 있습니다.
/opt/nginx/conf.d/디렉터리로 이동하여hostalias: 다음 명령어를 사용하여 요청을 보냈습니다.ls -ltrh | grep -r 'HOST_ALIAS_NAME'
샘플 출력:
호스트 별칭 이름이
opdk.cert-test.com이라고 가정해 보겠습니다. Google Cloud 콘솔에서ls -ltrh명령어를 실행하면 아래와 같이 출력됩니다.
<ph type="x-smartling-placeholder">
라우터의 특정 가상 호스트에 대한 디버그 로깅 사용 설정
다음 단계에서는 특정 서비스의 디버그 로그를 Apigee 라우터에서 사용 설정하는 방법을 설명합니다. 가상 호스트입니다
- 라우터 머신의 편집기에서 다음 파일을 엽니다.
/opt/nginx/conf.d/ORG_NAME_ENV_NAME_VIRTUALHOST_NAME.conf예:vi /opt/nginx/conf.d/ORG_NAME_ENV_NAME_VIRTUALHOST_NAME.conf
- 다음 줄을 변경합니다.
error_log /opt/apigee/var/log/edge-router/nginx/ORG_NAME~ENV_NAME.PORT_error_log error;
error_log /opt/apigee/var/log/edge-router/nginx/ORG_NAME~ENV_NAME.PORT_error_log info;
- 변경사항을 저장합니다.
- NGINX 새로고침 명령어를 실행합니다. 예를 들면 다음과 같습니다.
sudo /opt/nginx/scripts/apigee-nginx reload
- 이제 다음 파일이 디버그 로그를 캡처합니다.
<ph type="x-smartling-placeholder">
/opt/apigee/var/log/edge-router/nginx/ORG_NAME~ENV_NAME.PORT_error_log
</ph> - 두 개 이상의 라우터에서 디버그 로그를 캡처하려면 라우터입니다.
NGINX 오류 로그 파일에 로깅된 디버그 정보 확인
-
클라이언트가 가상 호스트와 연결된 호스트 별칭 및 포트에서 API 요청을 하면 디버그 로그가 다음 파일에 캡처됩니다.
/opt/apigee/var/log/edge-router/nginx/ORG_NAME~ENV_NAME.PORT_error_log -
다음 예와 같이 API 요청에 대한 디버그 정보가 표시되는지 확인합니다.
샘플 디버그 정보:
2021/01/27 02:48:40 [warn] 27624#27624: *3777 a client request body is buffered to a temporary file /opt/apigee/var/log/edge-router/nginx/client_temp/0000000001, client: XX.XX.XX.XX, server: XX.XX.XX.XX, request: "POST /post-no-target HTTP/1.1", host: "XX.XX.XX.XX:443"
위에 표시된 정보는 클라이언트가 다음과 함께
POST요청을 전송할 때 캡처됩니다. 대규모 페이로드가 필요합니다 이 로그는 디버그 로깅이 사용 설정된 경우에만 표시됩니다. - 추가 디버그 정보가 표시되지 않으면 에 설명된 단계 라우터의 특정 가상 호스트에 대한 디버그 로깅을 올바르게 사용 설정합니다. 만약 놓친 부분이 있는 경우 모든 단계를 올바르게 다시 반복합니다.
- 그래도 디버그 정보를 얻을 수 없는 경우 Apigee Edge 지원팀에 문의하세요.
라우터의 특정 가상 호스트에 대한 디버그 로그 사용 중지
이 섹션에서는 라우터에서 특정 가상 호스트에 대한 디버그 로그를 사용 중지하는 방법을 설명합니다.
- 라우터 머신의 편집기에서 다음 파일을 엽니다.
/opt/nginx/conf.d/ORG_NAME_ENV_NAME_VIRTUALHOST_NAME.conf예를 들면 다음과 같습니다.vi /opt/nginx/conf.d/ORG_NAME_ENV_NAME_VIRTUALHOST_NAME.conf
-
다음 줄을 변경합니다.
error_log /opt/apigee/var/log/edge-router/nginx/ORG_NAME~ENV_NAME.PORT_error_log info;
error_log /opt/apigee/var/log/edge-router/nginx/ORG_NAME~ENV_NAME.PORT_error_log error;
- 변경사항을 저장합니다.
- NGINX 새로고침 명령어를 실행합니다. 예를 들면 다음과 같습니다.
/opt/nginx/scripts/apigee-nginx reload
- 이제 다음 파일이 오류 로그만 캡처합니다.
<ph type="x-smartling-placeholder">
/opt/apigee/var/log/edge-router/nginx/ORG_NAME~ENV_NAME.PORT_error_log
</ph> - 두 개 이상의 라우터에서 디버그 로그를 중지하려면 각 라우터에서 라우터.
NGINX 오류 로그 파일에 오류 정보만 로깅되었는지 확인
- 특정 가상 호스트와 연결된 호스트 별칭 및 포트에서 API 요청 실행 구성을 기다리거나 클라이언트가 요청할 때까지 기다려야 합니다
- 다음 파일을 확인합니다.
/opt/apigee/var/log/edge-router/nginx/ORG_NAME~ENV_NAME.PORT_error_log - 오류 정보만 표시되고 디버그 정보는 더 이상 표시되지 않는지 확인 확인할 수 있습니다
- 추가 디버그 정보가 로깅되고 있는 경우, 다음 사항을 확인하세요. 에 설명된 모든 단계를 따름 라우터에서 특정 가상 호스트의 디버그 로그 사용 중지 올바르게 하기 만약 놓친 부분이 있는 경우 모든 단계를 올바르게 다시 반복합니다.
- 그래도 디버그 정보를 얻을 수 없는 경우 Apigee Edge 지원