次の方法で共有

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

  • [アーティクル]

このパッケージは@azure/core-amqp、Azure Service BusやAzure Event Hubsなどの AMQP プロトコルを使用する Azure JavaScript ライブラリに共通の機能を提供します。

作業の開始

インストール

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

npm install @azure/core-amqp

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

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

主要な概念

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

次のステップ

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

トラブルシューティング

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

ログ記録

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

  • verbose
  • info
  • warning
  • error

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

プログラムまたは環境変数を使用してログ レベルを AZURE_LOG_LEVEL 設定すると、選択したログ レベル以下のログ レベルを使用して書き込まれたログが生成されます。

または、このライブラリを使用するときにログを DEBUG 取得するように環境変数を設定することもできます。 これは、依存関係rhea-promiserheaからもログを出力する場合にも役立ちます。

メモ： AZURE_LOG_LEVEL設定されている場合は、DEBUG よりも優先されます。 AZURE_LOG_LEVELを指定 azure する場合や setLogLevel を呼び出す場合は、DEBUG を使用してライブラリを指定しないでください。

  • core-amqp ライブラリから情報レベルのデバッグ ログのみを取得します。
export DEBUG=azure:core-amqp:info
  • core-amqp とプロトコル レベル ライブラリからデバッグ ログを取得します。
export DEBUG=azure:core-amqp:*,rhea*
  • (大量のコンソール/ディスク領域を消費する) 生イベント データを表示することに関心がない 場合は、環境変数を DEBUG 次のように設定できます。
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)、stdout をファイルにリダイレクトして、同じ out.log ファイルに移動します。
      node your-test-script.js >out.log 2>&1
    • テスト スクリプトと sdk からのログ ステートメントは、同じファイル out.logに移動します。 
      node your-test-script.js &> out.log

共同作成

このプロジェクトでは、共同作成と提案を歓迎しています。 ほとんどの共同作成では、共同作成者使用許諾契約書 (CLA) にご同意いただき、ご自身の共同作成内容を使用する権利を Microsoft に供与する権利をお持ちであり、かつ実際に供与することを宣言していただく必要があります。 詳細については、 https://cla.microsoft.com を参照してください。

pull request を送信すると、CLA を提供して PR (ラベル、コメントなど) を適宜装飾する必要があるかどうかを CLA ボットが自動的に決定します。 ボットによって提供される手順にそのまま従ってください。 この操作は、Microsoft の CLA を使用するすべてのリポジトリについて、1 回だけ行う必要があります。

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

このプロジェクトでは、Microsoft オープン ソースの倫理規定を採用しています。 詳しくは、「Code of Conduct FAQ (倫理規定についてよくある質問)」を参照するか、opencode@microsoft.com 宛てに質問またはコメントをお送りください。

インプレッション数