Node.js 프록시 디버깅 및 문제 해결

Apigee Edge 문서를 보고 있습니다.
Apigee X 문서로 이동하세요. info

프록시에 추가하는 Node.js 코드가 작동하는지 확인한 후 Edge에 배포하는 것이 좋습니다. 이 주제에서는 Node.js 애플리케이션이 포함된 프록시가 배포된 후 이를 디버깅하고 문제를 해결하는 방법을 설명합니다.

성능 향상을 위해 연결 풀 크기 증가

성능이 느리다고 생각되면 maxSockets를 사용하여 기본 Node.js 연결 풀 크기를 늘리거나 소켓 풀링을 완전히 사용 중지하여 문제를 해결할 수 있습니다. 자세한 내용과 예시 코드는 Apigee 커뮤니티의 Node.js 성능 팁: 소켓 풀링을 참고하세요.

Node.js 로그 보기

Node.js 애플리케이션에 관한 로그 정보를 보려면 다음 단계를 따르세요.

  1. 기본 API 프록시 페이지에서 보려는 프록시를 클릭합니다.
  2. 선택한 프록시의 요약 페이지에서 도구 모음의 오른쪽에 있는 Node.js 로그를 클릭합니다.

아래와 같이 로그 페이지에서 볼 로그의 시간 범위를 선택할 수 있습니다. 로그에는 HTTP 메서드 호출, 호출 성공 또는 실패, console.log 메시지 등이 기록됩니다. 검색 필드에 검색 문자열을 입력하여 문자열이 포함된 모든 로그 항목을 표시합니다.

트레이스 도구 사용

추적 도구는 일반적인 프록시 디버깅에 유용합니다. 추적 도구 사용에 관한 자세한 내용은 Trace 도구 사용을 참고하세요.

콘솔 출력 인쇄

Node.js 코드에 console.log 문을 삽입하고 추적 도구에서 출력을 볼 수 있습니다. 예를 들어 다음 문은 config.user 변수의 값을 출력합니다.

console.log('Logging in as %s', config.username);

추적 도구에서 console.log 메시지의 출력을 보려면 추적 도구에서 API를 호출하고 모든 트랜잭션의 출력 을 클릭하여 출력 패널을 엽니다.

다음 코드를 실행했다고 가정해 보겠습니다.

var http = require('http');

console.log('node.js application starting...');

var svr = http.createServer(function(req, resp) {
    resp.end('Hello, World!');
});

svr.listen(9000, function() {
    console.log('Node HTTP server is listening');
});

... 콘솔 문이 패널에 표시됩니다.

Nginx 타겟 시간 초과 설정 구성

Nginx를 프록시로 사용하고 'Bad Gateway' 오류가 표시되면 여기에 설명된 대로 Nginx 프록시 시간 제한 구성을 늘려 보세요.

예를 들면 다음과 같습니다.

proxy_connect_timeout       60;
proxy_read_timeout          120;

서버가 응답하는 데 걸리는 시간에 따라 이상적인 타임아웃 구성이 결정될 수 있습니다. 예를 들어 45~60초의 읽기 제한 시간이 적절한 버퍼를 제공하는 데 이상적일 수 있습니다.

Apigee 대상 제한 시간 설정 구성

TargetEndpoint의 HttpTargetConnection 요소에서 Apigee 기본 제한 시간 값을 구성할 수도 있습니다. 기본값은 다음과 같습니다.

connect.timeout.millis - 60 seconds
io.timeout.millis - 120 seconds
 
<HTTPTargetConnection>
    <Properties>
        <Property name="connect.timeout.millis">5000</Property>
        <Property name="io.timeout.millis">5000</Property>
    </Properties>
    <URL>http://www.google.com</URL>
</HTTPTargetConnection>

엔드포인트 속성 참조도 참고하세요.

추가 정보

디버깅에 대해 자세히 알아보려면 다음을 참고하세요.

다음 단계

HTTP/HTTPS, TLS 및 기타 고급 주제 지원에 관한 정보를 비롯하여 Apigee Edge의 Node.js 모듈 지원에 관한 자세한 내용은 Node.js 모듈에 대한 Edge 지원 이해를 참고하세요.