다음을 통해 공유

JavaScript용 Azure Core AMQP 클라이언트 라이브러리 - 버전 4.3.3

  • 아티클

@azure/core-amqp 패키지는 azure Service Bus 및 Azure Event Hubs와 같은 AMQP 프로토콜 사용하는 Azure JavaScript 라이브러리에 대한 일반적인 기능을 제공합니다.

시작

설치

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

npm install @azure/core-amqp

현재 지원되는 환경

자세한 내용은 지원 정책 참조하세요.

주요 개념

Azure Core AMQP 라이브러리의 주요 기능 중 일부는 다음과 같습니다.

  • 클레임 기반 권한 부여
  • AMQP 통해 요청을 보내고 응답을 수신하는 대한 Request-Response 링크
  • Azure Service Bus 및 Azure Event Hubs와 관련된 오류와 함께 AMQP 오류 코드의 오류 변환
  • 다시 시도 가능한 오류가 발생한 경우 지정된 작업을 다시 시도하기 위한 RetryPolicy입니다.

다음 단계

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

문제 해결

core-amqp 라이브러리는 연결을 관리하고 AMQP 프로토콜을 통해 이벤트를 보내고 받기 위한 rhea-promise 라이브러리에 따라 달라집니다.

로깅

AZURE_LOG_LEVEL 환경 변수를 다음 값 중 하나로 설정하여 로깅을 stderr수 있습니다.

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

@azure/로거 패키지를 가져오고 로그 수준 값 중 하나를 사용하여 setLogLevel 함수를 호출하여 로그 수준을 프로그래밍 방식으로 설정할 수도 있습니다. 예를 들어 로그 수준을 info설정하면 수준 warning 및 error 대해 작성된 로그도 내보내집니다. 이 SDK는 로그할 수준을 결정할 때 TypeScript용 Azure SDK 지침을 따릅니다.

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

또는 DEBUG 환경 변수를 설정하여 이 라이브러리를 사용할 때 로그를 가져올 수 있습니다. 이 기능은 종속성 rhea-promise 로그를 내보내고 rhea 경우에도 유용할 수 있습니다.

참고: AZURE_LOG_LEVEL 설정되면 DEBUG보다 우선합니다. AZURE_LOG_LEVEL 지정하거나 setLogLevel을 호출할 때는 DEBUG를 통해 azure 라이브러리를 지정하지 마세요.

  • core-amqp 라이브러리에서 정보 수준 디버그 로그만 가져옵니다.
export DEBUG=azure:core-amqp:info
  • core-amqp 및 프로토콜 수준 라이브러리에서 디버그 로그를 가져옵니다.
export DEBUG=azure:core-amqp:*,rhea*
  • 원시 이벤트 데이터(많은 양의 콘솔/디스크 공간을 사용)을 보는 데 관심이 경우 다음과 같이 환경 변수를 설정할 수 있습니다.
export DEBUG=azure:core-amqp:*,rhea*,-rhea:raw,-rhea:message
  • 오류 및 SDK 경고관심이 있는 경우 다음과 같이 환경 변수를 설정할 수 있습니다.
export DEBUG=azure:core-amqp:(error|warning),rhea-promise:error,rhea:events,rhea:frames,rhea:io,rhea:flow

파일에 로깅

  • 위와 같이 DEBUG 환경 변수를 설정한 다음 다음과 같이 테스트 스크립트를 실행합니다.
    • 테스트 스크립트의 로깅 문은 out.log 이동하고 sdk의 로깅 문은 debug.log이동합니다. 
      node your-test-script.js > out.log 2>debug.log
    • 테스트 스크립트 및 sdk의 로깅 문은 stderr를 stdout(&1)로 리디렉션하여 out.log 동일한 파일로 이동한 다음 stdout을 파일로 리디렉션합니다. 
      node your-test-script.js >out.log 2>&1
    • 테스트 스크립트 및 sdk의 로깅 문은 out.log동일한 파일로 이동합니다. 
      node your-test-script.js &> out.log

기여

이 프로젝트는 기여와 제안을 환영합니다. 대부분의 기여는 귀하가 귀하의 기여를 사용할 권리를 부여할 권리가 있음을 선언하는 CLA(기여자 사용권 계약)에 동의해야 합니다. 자세한 내용은 https://cla.microsoft.com 을 참조하세요.

끌어오기 요청을 제출하면 CLA 봇은 CLA를 제공하고 PR을 적절하게 데코레이팅해야 하는지 여부를 자동으로 결정합니다(예: 레이블, 주석). 봇에서 제공하는 지침을 따르기만 하면 됩니다. CLA를 사용하여 모든 리포지토리에서 한 번만 이 작업을 수행해야 합니다.

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

이 프로젝트는 Microsoft 오픈 소스 행동 강령채택했습니다. 자세한 내용은 행동 강령 FAQ 참조하거나 추가 질문이나 의견을 opencode@microsoft.com 문의하세요.

노출