Libreria client di Azure Core AMQP per JavaScript - versione 4.3.4

Il pacchetto @azure/core-amqp offre funzionalità comuni per librerie JavaScript di Azure che usano il protocollo AMQP come quelli per il bus di servizio di Azure e Hub eventi di Azure.

Introduttiva

Installazione

Installare questa libreria usando npm come indicato di seguito:

npm install @azure/core-amqp

Ambienti attualmente supportati

• versioni LTS di Node.js
• Versioni più recenti di Safari, Chrome, Edge e Firefox.

Per altri dettagli, vedere i criteri di supporto .

Concetti chiave

Alcune delle funzionalità principali della libreria Azure Core AMQP sono:

• di autorizzazione basata sulle attestazioni
• Request-Response collegamento per l'invio di una richiesta e la ricezione di una risposta tramite AMQP
• Conversione degli errori dei codici di errore AMQP insieme agli errori specifici del bus di servizio di Azure e di Hub eventi di Azure.
• RetryPolicy per ritentare un'operazione specifica se è stato rilevato un errore riprovabile.

Passaggi successivi

È possibile compilare ed eseguire i test in locale eseguendo rushx test. Esplorare la cartella test per visualizzare l'utilizzo e il comportamento avanzati delle classi pubbliche.

Risoluzione dei problemi

La libreria core amqp dipende dalla libreria rhea-promise per la gestione delle connessioni e per l'invio e la ricezione di eventi tramite il protocollo AMQP.

Registrazione

È possibile impostare la variabile di ambiente AZURE_LOG_LEVEL su uno dei valori seguenti per abilitare la registrazione in stderr:

• prolisso
• Informazioni
• avvertimento
• errore

È anche possibile impostare il livello di log a livello di codice importando il pacchetto @azure/logger e chiamando la funzione con uno dei valori del livello di log. Ad esempio, quando si imposta il livello di log su info, vengono generati anche i log scritti per i livelli warning e error. Questo SDK segue le linee guida per i di Azure SDK per TypeScript per determinare il livello a cui eseguire l'accesso.

Quando si imposta un livello di log a livello di codice o tramite la variabile di ambiente AZURE_LOG_LEVEL, tutti i log scritti usando un livello di log uguale o inferiore a quello scelto verranno generati.

In alternativa, è possibile impostare la variabile di ambiente DEBUG per ottenere i log quando si usa questa libreria. Ciò può essere utile anche se si vogliono generare log dalle dipendenze rhea-promise e rhea.

Nota: AZURE_LOG_LEVEL, se impostato, ha la precedenza su DEBUG. Non specificare librerie azure tramite DEBUG quando si specificano anche AZURE_LOG_LEVEL o si chiama setLogLevel.

• Ottenere solo i log di debug a livello di informazioni dalla libreria core-amqp.

export DEBUG=azure:core-amqp:info

• Recupero dei log di debug dalla libreria amqp principale e a livello di protocollo.

export DEBUG=azure:core-amqp:*,rhea*

• Se non si è interessati a visualizzare i dati dell'evento non elaborati (che utilizza una grande quantità di spazio su console/disco), è possibile impostare la variabile di ambiente DEBUG come indicato di seguito:

export DEBUG=azure:core-amqp:*,rhea*,-rhea:raw,-rhea:message

• Se si è interessati solo agli errori e agli avvisi dell'SDK , è possibile impostare la variabile di ambiente DEBUG come indicato di seguito:

export DEBUG=azure:core-amqp:(error|warning),rhea-promise:error,rhea:events,rhea:frames,rhea:io,rhea:flow

Registrazione in un file

• Impostare la variabile di ambiente DEBUG come illustrato in precedenza e quindi eseguire lo script di test come indicato di seguito:
  • Le istruzioni di registrazione dello script di test vengono out.log e l'istruzione di registrazione dall'SDK passano a debug.log.

    node your-test-script.js > out.log 2>debug.log
    

  • Le istruzioni di registrazione dallo script di test e l'SDK passano allo stesso file out.log reindirizzando stderr a stdout (&1) e quindi reindirizzare stdout a un file:

    node your-test-script.js >out.log 2>&1
    

  • Le istruzioni di registrazione dallo script di test e l'SDK passano allo stesso file out.log.

    node your-test-script.js &> out.log
    

Contribuire

Questo progetto accoglie contributi e suggerimenti. La maggior parte dei contributi richiede l'accettazione di un Contratto di licenza collaboratore (CLA) che dichiara di avere il diritto e, in realtà, concedere a Microsoft i diritti per l'uso del contributo. Per informazioni dettagliate, vedere https://cla.microsoft.com.

Quando si invia una richiesta pull, un bot CLA determinerà automaticamente se è necessario fornire un cla e decorare la richiesta pull in modo appropriato (ad esempio, etichetta, commento). Seguire semplicemente le istruzioni fornite dal bot. Dovrai eseguire questa operazione una sola volta in tutti i repository usando la nostra cla.

Per contribuire a questa libreria, leggere la guida contribuire per altre informazioni su come compilare e testare il codice.

Questo progetto ha adottato la codice di comportamento Microsoft Open Source. Per altre informazioni, vedere domande frequenti sul codice di comportamento o contattare opencode@microsoft.com con eventuali domande o commenti aggiuntivi.