共用方式為

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

  • 發行項

套件@azure/core-amqp提供 Azure JavaScript 連結庫的常見功能，這些連結庫會使用 AMQP 通訊協定，例如適用於 Azure 服務匯流排 和 Azure 事件中樞 的通訊協定。

開始使用

安裝

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

npm install @azure/core-amqp

目前支援的環境

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

重要概念

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

  • 宣告型授權
  • 透過AMQP傳送要求和接收回應的 Request-Response 連結
  • AMQP 錯誤碼的錯誤轉譯，以及 Azure 服務匯流排 和 Azure 事件中樞 特有的錯誤。
  • 如果遇到可重試的錯誤，則 RetryPolicy 會重試指定的作業。

後續步驟

您可執行 rushx test 以在本機組建和執行測試。 請在 test 資料夾中查看公用類別的進階使用方式和行為。

疑難排解

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

記錄

您可以將環境變數設定 AZURE_LOG_LEVEL 為下列其中一個值，以啟用記錄至 stderr：

  • verbose
  • info
  • warning
  • error

您也可以藉由匯入 @azure/記錄器 套件，並使用其中一個記錄層級值呼叫 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*
  • 如果您 不想要檢視原始事件數據 (會耗用大量控制台/磁碟空間) ，您可以設定 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。

曝光數