共用方式為

適用於 JavaScript 的 Azure Core AMQP 用戶端連結庫 - 4.3.3 版

  • 發行項

@azure/core-amqp 套件為使用 AMQP 通訊協定的 Azure JavaScript 連結庫提供一般功能，例如 Azure 服務總線和 Azure 事件中樞的通訊協定。

開始

安裝

使用 npm 安裝此連結庫，如下所示：

npm install @azure/core-amqp

目前支持的環境

如需詳細資訊，請參閱我們的 支持原則。

重要概念

Azure Core AMQP 連結庫的一些主要功能包括：

後續步驟

您可以在本機建置及執行測試，方法是執行 rushx test。 探索 test 資料夾，以查看公用類別的進階使用方式和行為。

故障排除

core-amqp 連結庫取決於用於管理連線的 rhea-promise 連結庫，以及透過 AMQP 通訊協定傳送和接收事件。

伐木

您可以將 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*
  • 如果您 對檢視原始事件數據（耗用大量控制台/磁碟空間）不感興趣，您可以設定 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），宣告您有權，而且實際上確實會授與我們使用您貢獻的許可權。 如需詳細資料，請前往 https://cla.microsoft.com 。

當您提交提取要求時，CLA-Bot 會自動判斷您是否需要提供 CLA 並適當裝飾 PR（例如標籤、批註）。 只要遵循 Bot 所提供的指示即可。 您只需要使用我們的 CLA 在所有存放庫上執行此動作一次。

如果您想要參與此連結庫，請閱讀 參與指南，以深入瞭解如何建置和測試程序代碼。

此項目已採用 Microsoft 開放原始碼程式代碼。 如需詳細資訊，請參閱 《行為規範》常見問題 或連絡 opencode@microsoft.com，以取得任何其他問題或意見。

印象