JavaScript용 Azure Logger 클라이언트 라이브러리 - 버전 1.1.2

@azure/logger 패키지를 사용하여 JavaScript용 Azure SDK에서 로깅을 사용하도록 설정할 수 있습니다.

다음과 같은 방법으로 Azure SDK에 대해 로깅을 사용하도록 설정할 수 있습니다.

• AZURE_LOG_LEVEL 환경 변수 설정
• "@azure/로거"에서 가져온 setLogLevel 호출
• 특정 로거에서 enable() 호출
• DEBUG 환경 변수 사용.

AZURE_LOG_LEVEL이 설정된 경우 DEBUG보다 우선합니다. AZURE_LOG_LEVEL을 지정하거나 setLogLevel을 호출하지 않고 DEBUG만 사용합니다.

시작

설치

다음과 같이 npm을 사용하여 이 라이브러리 설치

npm install @azure/logger

주요 개념

@azure/logger 패키지는 다음과 같이 가장 높은 자세한 정보 표시에서 가장 낮은 자세한 정보 표시로 순서대로 지정된 로그 수준을 지원합니다.

• verbose
• 정보
• warning
• error

프로그래밍 방식으로 또는 AZURE_LOG_LEVEL 환경 변수를 통해 로그 수준을 설정할 때 선택한 수준 이하의 로그 수준을 사용하여 작성된 모든 로그를 내보냅니다.

예를 들어 로그 수준을 warning으로 설정하면 로그 수준이 warning 또는 error인 모든 로그가 내보내집니다.

참고: 요청 및 응답을 로깅할 때 비밀을 포함하는 헤더와 같은 Authorization 항목이 기록되지 않도록 이러한 개체를 삭제합니다.

요청 및 응답 본문은 기록되지 않습니다. 헤더는 다음 목록에 없거나 클라이언트 SDK에서 명시적으로 허용하지 않는 한 기본적으로 수정됩니다.

• "x-ms-client-request-id",
• "x-ms-return-client-request-id",
• "x-ms-useragent",
• "x-ms-correlation-request-id",
• "x-ms-request-id",
• "client-request-id",
• "ms-cv",
• "return-client-request-id",
• "traceparent",
• "Access-Control-Allow-Credentials",
• "Access-Control-Allow-Headers",
• "Access-Control-Allow-Methods",
• "Access-Control-Allow-Origin",
• "Access-Control-Expose-Headers",
• "Access-Control-Max-Age",
• "Access-Control-Request-Headers",
• "Access-Control-Request-Method",
• "Origin",
• "수락",
• "Accept-Encoding",
• "Cache-Control",
• "연결",
• "Content-Length",
• "Content-Type",
• "Date",
• "ETag",
• "만료",
• "If-Match",
• "If-Modified-Since",
• "If-None-Match",
• "If-Unmodified-Since",
• "마지막으로 수정",
• "Pragma",
• "Request-Id",
• "Retry-After",
• "Server",
• "Transfer-Encoding",
• "User-Agent",
• "WWW-Authenticate",

예제

예제 1 - 기본 사용

const { EventHubClient } = require('@azure/event-hubs');

const logger = require('@azure/logger');
logger.setLogLevel('info');

// operations will now emit info, warning, and error logs
const client = new EventHubClient(/* params */);
client.getPartitionIds()
  .then(ids => { /* do work */ })
  .catch(e => { /* do work */ });
});

예제 2 - 로그 출력 리디렉션

const { AzureLogger, setLogLevel } = require("@azure/logger");

setLogLevel("verbose");

// override logging to output to console.log (default location is stderr)
AzureLogger.log = (...args) => {
  console.log(...args);
};

AzureLogger를 사용하면 AzureLogger.log 메서드를 재정의하여 Azure SDK의 로깅 출력을 리디렉션할 수 있습니다. 이는 로그를 stderr 이외의 위치로 리디렉션하려는 경우에 유용할 수 있습니다.

다음 단계

rushx test를 실행하여 로컬에서 테스트를 빌드하고 실행할 수 있습니다. test 폴더를 탐색하여 퍼블릭 클래스의 고급 사용 및 동작을 확인합니다.

문제 해결

이 라이브러리를 사용하는 동안 문제가 발생하면 자유롭게 문제를 제기하세요.

참여

이 라이브러리에 기여하려면 기여 가이드 를 참조하여 코드를 빌드하고 테스트하는 방법에 대해 자세히 알아보세요.