Partager via

Bibliothèque de client AMQP Azure Core pour JavaScript - version 4.3.4

  • Article

Le package @azure/core-amqp fournit des fonctionnalités courantes pour bibliothèques JavaScript Azure qui utilisent le protocole AMQP comme ceux d’Azure Service Bus et d’Azure Event Hubs.

Commencer

Installation

Installez cette bibliothèque à l’aide de npm comme suit :

npm install @azure/core-amqp

Environnements actuellement pris en charge

Pour plus d’informations, consultez notre de stratégie de support .

Concepts clés

Voici quelques-unes des principales fonctionnalités de la bibliothèque AMQP Azure Core :

  • d’autorisation basée sur les revendications
  • lien Request-Response pour l’envoi d’une demande et la réception d’une réponse sur AMQP
  • Traduction d’erreurs des codes d’erreur AMQP, ainsi que des erreurs spécifiques à Azure Service Bus et Azure Event Hubs.
  • RetryPolicy pour réessayer une opération donnée si une erreur retentable a été rencontrée.

Étapes suivantes

Vous pouvez générer et exécuter les tests localement en exécutant rushx test. Explorez le dossier test pour voir l’utilisation et le comportement avancés des classes publiques.

Dépannage

La bibliothèque core-amqp dépend de la bibliothèque de promesse de répétition pour la gestion des connexions et de l’envoi et de la réception d’événements sur le protocole AMQP .

Exploitation forestière

Vous pouvez définir la variable d’environnement AZURE_LOG_LEVEL sur l’une des valeurs suivantes pour activer la journalisation dans stderr:

  • verbeux
  • info
  • avertissement
  • erreur

Vous pouvez également définir le niveau du journal par programmation en important le package @azure/enregistreur d’événements et en appelant la fonction setLogLevel avec l’une des valeurs de niveau journal. Par exemple, lorsque vous définissez le niveau de journal sur info, les journaux d’activité écrits pour les niveaux warning et les error sont également émis. Ce Kit de développement logiciel (SDK) Azure pour TypeScript instructions lors de la détermination du niveau auquel se connecter.

Lorsque vous définissez un niveau de journal par programmation ou via la variable d’environnement AZURE_LOG_LEVEL, tous les journaux écrits à l’aide d’un niveau de journal égal ou inférieur à celui que vous choisissez sont émis.

Vous pouvez également définir la variable d’environnement DEBUG pour obtenir des journaux lors de l’utilisation de cette bibliothèque. Cela peut être utile si vous souhaitez également émettre des journaux à partir des dépendances rhea-promise et rhea également.

Remarque : AZURE_LOG_LEVEL, si elle est définie, est prioritaire sur DEBUG. Ne spécifiez aucune bibliothèque azure via DEBUG lors de la spécification AZURE_LOG_LEVEL ou de l’appel de setLogLevel.

  • Obtention uniquement des journaux de débogage au niveau des informations à partir de la bibliothèque core-amqp.
export DEBUG=azure:core-amqp:info
  • Obtention des journaux de débogage à partir de core-amqp et de la bibliothèque au niveau du protocole.
export DEBUG=azure:core-amqp:*,rhea*
  • Si vous n’êtes pas intéressé par l’affichage des données d’événement brutes (qui consomme une grande quantité d’espace console/disque), vous pouvez définir la variable d’environnement DEBUG comme suit :
export DEBUG=azure:core-amqp:*,rhea*,-rhea:raw,-rhea:message
  • Si vous n’êtes intéressé que par les erreurs et les avertissements sdk, vous pouvez définir la variable d’environnement DEBUG comme suit :
export DEBUG=azure:core-amqp:(error|warning),rhea-promise:error,rhea:events,rhea:frames,rhea:io,rhea:flow

Journalisation dans un fichier

  • Définissez la variable d’environnement DEBUG comme indiqué ci-dessus, puis exécutez votre script de test comme suit :
    • Les instructions de journalisation de votre script de test sont out.log et l’instruction de journalisation à partir du kit sdk vont à debug.log. 
      node your-test-script.js > out.log 2>debug.log
    • Les instructions de journalisation à partir de votre script de test et du kit sdk accédent au même fichier out.log en redirigeant stderr vers stdout (&1), puis redirigez stdout vers un fichier : 
      node your-test-script.js >out.log 2>&1
    • Journalisation des instructions à partir de votre script de test et du kit sdk accédez au même fichier out.log. 
      node your-test-script.js &> out.log

Contribuant

Ce projet accueille les contributions et suggestions. La plupart des contributions vous obligent à accepter un contrat de licence contributeur (CLA) déclarant que vous avez le droit, et en fait, de nous accorder les droits d’utilisation de votre contribution. Pour plus d’informations, visitez https://cla.microsoft.com.

Lorsque vous envoyez une demande de tirage( pull request), un bot CLA détermine automatiquement si vous devez fournir un CLA et décorer correctement la demande de tirage (par exemple, étiquette, commentaire). Suivez simplement les instructions fournies par le bot. Vous n’aurez besoin de le faire qu’une seule fois sur tous les dépôts à l’aide de notre CLA.

Si vous souhaitez contribuer à cette bibliothèque, lisez le guide de contribution pour en savoir plus sur la génération et le test du code.

Ce projet a adopté le code de conduite Microsoft Open Source. Pour plus d’informations, consultez le forum aux questions du Code de conduite ou contactez avec des questions ou commentaires supplémentaires.

Impressions