Naively Programmable Module

    @azure/core-amqp
    TypeScript icon, indicating that this package has built-in type declarations

    3.0.0 • Public • Published

    Azure Core AMQP client library for AMQP operations

    Azure Core AMQP is a library that provides common functionality for Azure Javascript libraries that use AMQP protocol like the ones for Azure Service Bus and Azure Event Hubs.

    Getting started

    Installation

    Install this library using npm as follows:

    npm install @azure/core-amqp

    Prerequisites

    If you are using this package in a Node.js application, then use Node.js 8.x or higher.

    Key concepts

    Some of the key features of Azure Core AMQP library are:

    Troubleshooting

    The core-amqp library depends on the rhea-promise library for managing connections, and for sending and receiving events over the AMQP protocol.

    Logging

    You can set the AZURE_LOG_LEVEL environment variable to one of the following values to enable logging to stderr:

    • verbose
    • info
    • warning
    • error

    You can also set the log level programmatically by importing the @azure/logger package and calling the setLogLevel function with one of the log level values. For example, when you set the log level to info, the logs that are written for levels warning and error are also emitted. This SDK follows the Azure SDK for TypeScript guidelines when determining which level to log to.

    When setting a log level either programmatically or via the AZURE_LOG_LEVEL environment variable, any logs that are written using a log level equal to or less than the one you choose will be emitted.

    You can alternatively set the DEBUG environment variable to get logs when using this library. This can be useful if you also want to emit logs from the dependencies rhea-promise and rhea as well.

    Note: AZURE_LOG_LEVEL, if set, takes precedence over DEBUG. Do not specify any azure libraries via DEBUG when also specifying AZURE_LOG_LEVEL or calling setLogLevel.

    • Getting only info level debug logs from the core-amqp library.
    export DEBUG=azure:core-amqp:info
    • Getting debug logs from the core-amqp and the protocol level library.
    export DEBUG=azure:core-amqp:*,rhea*
    • If you are not interested in viewing the raw event data (which consumes a large amount of console/disk space) then you can set the DEBUG environment variable as follows:
    export DEBUG=azure:core-amqp:*,rhea*,-rhea:raw,-rhea:message
    • If you are interested only in errors and SDK warnings, then you can set the DEBUG environment variable as follows:
    export DEBUG=azure:core-amqp:(error|warning),rhea-promise:error,rhea:events,rhea:frames,rhea:io,rhea:flow

    Logging to a file

    • Set the DEBUG environment variable as shown above and then run your test script as follows:
      • Logging statements from you test script go to out.log and logging statement from the sdk go to debug.log.
        node your-test-script.js > out.log 2>debug.log
      • Logging statements from your test script and the sdk go to the same file out.log by redirecting stderr to stdout (&1), and then redirect stdout to a file:
        node your-test-script.js >out.log 2>&1
      • Logging statements from your test script and the sdk go to the same file out.log.
        node your-test-script.js &> out.log

    Contributing

    This project welcomes contributions and suggestions. Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. For details, visit https://cla.microsoft.com.

    When you submit a pull request, a CLA-bot will automatically determine whether you need to provide a CLA and decorate the PR appropriately (e.g., label, comment). Simply follow the instructions provided by the bot. You will only need to do this once across all repos using our CLA.

    If you'd like to contribute to this library, please read the contributing guide to learn more about how to build and test the code.

    This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact opencode@microsoft.com with any additional questions or comments.

    Impressions

    Install

    npm i @azure/core-amqp

    DownloadsWeekly Downloads

    45,676

    Version

    3.0.0

    License

    MIT

    Unpacked Size

    660 kB

    Total Files

    52

    Last publish

    Collaborators

    • avatar