通过

你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

适用于 JavaScript 的 Azure Core AMQP 客户端库 - 版本 4.3.3

  • 项目

@azure/core-amqp 包为使用 AMQP 协议（例如 Azure 服务总线和 Azure 事件中心）的 Azure JavaScript 库提供了常见功能。

开始

安装

使用 npm 安装此库，如下所示：

npm install @azure/core-amqp

当前支持的环境

有关详细信息，请参阅我们的 支持策略。

关键概念

Azure Core AMQP 库的一些主要功能包括：

  • 基于声明的授权
  • Request-Response 链接，用于通过 AMQP 发送请求和接收响应
  • AMQP 错误代码的错误转换以及特定于 Azure 服务总线和 Azure 事件中心的错误。
  • 如果遇到可重试错误，则重试给定操作的 RetryPolicy。

后续步骤

可以通过执行 rushx test在本地生成和运行测试。 浏览 test 文件夹以查看公共类的高级用法和行为。

故障 排除

核心 amqp 库依赖于用于管理连接的 rhea-promise 库，以及通过 AMQP 协议发送和接收事件。

伐木

可以将 AZURE_LOG_LEVEL 环境变量设置为以下值之一，以便日志记录到 stderr：

  • 详细
  • 信息
  • 警告
  • 错误

还可以通过导入 @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
    • 通过将 stderr 重定向到 stdout（&1），然后将 stdout 重定向到文件，将测试脚本和 sdk 中的日志记录语句转到同一文件 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 机器人会自动确定是否需要提供 CLA 并适当修饰 PR（例如标签、注释）。 只需按照机器人提供的说明进行操作。 只需使用 CLA 在所有存储库中执行此操作一次。

若要参与此库，请阅读 贡献指南 了解有关如何生成和测试代码的详细信息。

此项目已采用 Microsoft 开源行为准则。 有关详细信息，请参阅 行为准则常见问题解答 或与 opencode@microsoft.com 联系，了解任何其他问题或意见。

印象