다음을 통해 공유


JavaScript용 Azure 로거 클라이언트 라이브러리 - 버전 1.2.0

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

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

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

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

시작

설치

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

npm install @azure/logger

주요 개념

패키지는 @azure/logger 가장 자세한 정보 표시 순으로 지정된 다음 로그 수준을 지원합니다.

  • 자세한
  • 정보
  • 경고
  • 오류

프로그래밍 방식으로 또는 환경 변수를 통해 AZURE_LOG_LEVEL 로그 수준을 설정할 때 선택한 로그 수준과 같거나 낮은 로그 수준을 사용하여 작성된 모든 로그가 내보내집니다.

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

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

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

  • "x-ms-클라이언트 요청 ID",
  • "x-ms-return-client-request-id",
  • "x-ms-useragent",
  • "x-ms-상관 관계 요청 ID",
  • "x-ms-요청-id",
  • "클라이언트 요청 ID",
  • "ms-cv",
  • "반품 클라이언트 요청 ID",
  • "트레이스페어런트",
  • "액세스 제어 허용 자격 증명",
  • "액세스 제어 허용 헤더",
  • "액세스 제어 허용 방법",
  • "액세스 제어 허용 원본",
  • "액세스 제어 노출 헤더",
  • "액세스 제어-최대 연령",
  • "액세스 제어 요청 헤더",
  • "액세스 제어 요청 방법",
  • "원산지",
  • "수락",
  • "수락 인코딩",
  • "캐시 제어",
  • "연결",
  • "콘텐츠 길이",
  • "콘텐츠 유형",
  • "날짜",
  • "ETag",
  • "만료",
  • "만약에-일치",
  • "if-modified-since",
  • "만약에-없음-일치",
  • "수정되지 않은 이후",
  • "마지막으로 수정",
  • "프라그마",
  • "요청 ID",
  • "재시도 후",
  • "서버",
  • "전송 인코딩",
  • "사용자 에이전트",
  • "WWW-인증",

예제

예제 1 - 기본 사용

import { setLogLevel } from "@azure/logger";

setLogLevel("info");

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

import { setLogLevel, AzureLogger } from "@azure/logger";

setLogLevel("verbose");

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

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

다음 단계

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

문제 해결

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

기여

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