JavaScript 用 Azure Core AMQP クライアント ライブラリ - バージョン 4.3.2

  • [アーティクル]

パッケージは、AMQP プロトコル (Azure Service Bus や Azure Event Hubs など) を使用する Azure JavaScript ライブラリを するための一般的な機能を提供します。

はじめ

取り付け

次のように npm を使用してこのライブラリをインストールします。

npm install @azure/core-amqp

現在サポートされている環境

  • Node.js の LTS バージョンを する
  • Safari、Chrome、Edge、Firefox の最新バージョン。

詳細については、サポート ポリシーの を参照してください。

主な概念

Azure Core AMQP ライブラリの主な機能の一部を次に示します。

  • 要求ベースの承認 の
  • AMQP 経由で要求の送信と応答の受信を するための Request-Response リンク
  • AMQP エラー コードと、Azure Service Bus および Azure Event Hubs に固有のエラーの翻訳。
  • 再試行可能なエラーが発生した場合に特定の操作を再試行するための RetryPolicy。

次の手順

rushx testを実行することで、テストをローカルでビルドして実行できます。 test フォルダーを調べて、パブリック クラスの高度な使用方法と動作を確認します。

トラブルシューティング

コア amqp ライブラリは、接続を管理したり、AMQP プロトコルを介してイベントを送受信したりするために、rhea-promise ライブラリに依存します。

伐採

AZURE_LOG_LEVEL 環境変数を次のいずれかの値に設定して、stderrへのログ記録を有効にすることができます。

  • 冗長
  • 情報
  • 警告
  • エラー

@azure/logger パッケージをインポートし、ログ レベル値のいずれかを使用して setLogLevel 関数を呼び出すことで、ログ レベルをプログラムで設定することもできます。 たとえば、ログ レベルを infoに設定すると、warning レベルと error に対して書き込まれたログも出力されます。 この SDK は、ログイン先のレベルを決定する際に Azure SDK for TypeScript ガイドラインに従っています。

プログラムまたは 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 警告のみに関心がある場合は、次のように DEBUG 環境変数を設定できます。
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 を使用するすべてのリポジトリで 1 回だけ行う必要があります。

このライブラリに投稿する場合は、コードをビルドしてテストする方法の詳細については、投稿ガイド を参照してください。

このプロジェクトでは、Microsoft オープン ソースの行動規範を採用しています。 詳細については、行動規範に関する FAQ を参照するか、その他の質問やコメントを opencode@microsoft.com にお問い合わせください。

インプレッション