Поделиться через

Клиентская библиотека AMQP Azure Core для JavaScript версии 4.3.3

  • Статья

Пакет предоставляет общие функциональные возможности для библиотек JavaScript Azure, использующих протокол AMQP AMQP, например для служб служебной шины Azure и Центров событий Azure.

Начало работы

Установка

Установите эту библиотеку с помощью npm следующим образом:

npm install @azure/core-amqp

Поддерживаемые в настоящее время среды

Дополнительные сведения см. в политике поддержки .

Основные понятия

Ниже приведены некоторые основные функции библиотеки AMQP Azure Core:

  • авторизации на основе утверждений
  • ссылка Request-Response для отправки запроса и получения ответа по протоколу AMQP
  • Преобразование кодов ошибок AMQP вместе с ошибками, характерными для служебной шины Azure и Центров событий Azure.
  • RetryPolicy для повторения данной операции, если обнаружена повторная ошибка.

Дальнейшие действия

Вы можете создать и запустить тесты локально, выполнив rushx test. Изучите папку test, чтобы просмотреть расширенное использование и поведение общедоступных классов.

Устранение неполадок

Библиотека core-amqp зависит от библиотеки rhea-promise для управления подключениями, а также для отправки и получения событий по протоколу AMQP.

Лесозаготовка

Можно задать для переменной среды AZURE_LOG_LEVEL одно из следующих значений, чтобы включить ведение журнала для stderr:

  • многословный
  • информация
  • предупреждение
  • ошибка

Вы также можете программно задать уровень журнала, импортируя пакет @azure/loger и вызывая функцию setLogLevel с одним из значений уровня журнала. Например, при настройке уровня журнала infoтакже создаются журналы, написанные для уровней warning и error. Этот пакет SDK следует рекомендациям azure SDK для TypeScript при определении уровня входа.

При настройке уровня журнала программным способом или с помощью переменной среды AZURE_LOG_LEVEL все журналы, записанные с использованием уровня журнала, равного или меньше выбранного, будут выведены.

Можно также задать переменную среды DEBUG для получения журналов при использовании этой библиотеки. Это может быть полезно, если вы также хотите выдавать журналы из зависимостей rhea-promise и rhea.

Примечание. AZURE_LOG_LEVEL, если задано, имеет приоритет над DEBUG. Не указывайте библиотеки azure через DEBUG при указании AZURE_LOG_LEVEL или вызова setLogLevel.

  • Получение журналов отладки только на уровне сведений из библиотеки 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 переходят к тому же файлу out.log путем перенаправления stderr в stdout (&1), а затем перенаправлять stdout в файл: 
      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 автоматически определяет, нужно ли предоставить соглашение об уровне обслуживания и украсить pr соответствующим образом (например, метка, комментарий). Просто следуйте инструкциям, предоставленным ботом. Это необходимо сделать только один раз во всех репозиториях с помощью нашего CLA.

Если вы хотите внести свой вклад в эту библиотеку, ознакомьтесь с руководством по вкладу, чтобы узнать больше о том, как создавать и тестировать код.

Этот проект принял Microsoft Open Source Code of Conduct. Дополнительные сведения см. в кодекса поведения или с дополнительными вопросами или комментариями.

впечатлений