Megosztás a következőn keresztül:


Azure Core AMQP ügyféloldali kódtár JavaScripthez – 4.4.1-es verzió

A @azure/core-amqp csomag általános funkciókat biztosít Azure JavaScript-kódtárakhoz, amelyek az AMQP protokollt használják, mint az Azure Service Bus és az Azure Event Hubs esetében.

Kezdetekhez

Telepítés

Telepítse ezt a kódtárat az npm használatával az alábbiak szerint:

npm install @azure/core-amqp

Jelenleg támogatott környezetek

További részletekért tekintse meg támogatási szabályzatunkat.

Főbb fogalmak

Az Azure Core AMQP-kódtár néhány fő funkciója:

  • jogcímalapú engedélyezési
  • Request-Response hivatkozás az AMQP- küldéséhez és a válasz fogadásához
  • Az AMQP hibakódjainak és az Azure Service Busra és az Azure Event Hubsra vonatkozó hibák fordítása.
  • RetryPolicy egy adott művelet újrapróbálkozására, ha újrapróbálkozási hiba történt.

Következő lépések

A teszteket helyileg hozhatja létre és futtathatja a npm run testvégrehajtásával. A test mappában megtekintheti a nyilvános osztályok speciális használatát és viselkedését.

Hibaelhárítás

Az alapvető amqp-kódtár a rhea-promise kódtártól függ a kapcsolatok kezeléséhez, valamint az események AMQP protokollon keresztüli küldéséhez és fogadásához.

Fakitermelés

A AZURE_LOG_LEVEL környezeti változót az alábbi értékek egyikére állíthatja be, hogy engedélyezze a naplózást stderr:

  • bővebb
  • infó
  • figyelmeztetés
  • hiba

A naplószintet programozott módon is beállíthatja, ha importálja a @azure/logger csomagot, és meghívja a setLogLevel függvényt az egyik naplószintű értékkel. Ha például a naplószintet infoértékre állítja, a warning és error szintekre írt naplók is ki lesznek bocsátva. Ez az SDK a TypeScripthez készült Azure SDK irányelveit követi, annak meghatározásakor, hogy melyik szintre kell bejelentkeznie.

Ha a naplószintet programozott módon vagy a AZURE_LOG_LEVEL környezeti változón keresztül állítja be, a rendszer minden olyan naplót kibocsát, amely a választottnál egyenlő vagy annál kisebb naplószinttel van megírva.

Másik lehetőségként beállíthatja a DEBUG környezeti változót, hogy naplókat kapjon a kódtár használatakor. Ez akkor lehet hasznos, ha a rhea-promise és rhea függőségekből is szeretne naplókat kibocsátani.

Megjegyzés: ha be van állítva, AZURE_LOG_LEVEL elsőbbséget élvez a DEBUG-nak. Ne adjon meg azure kódtárakat a DEBUG használatával, ha AZURE_LOG_LEVEL vagy a setLogLevel hívását is megadja.

  • Csak információszintű hibakeresési naplók lekérése a core-amqp kódtárból.
export DEBUG=azure:core-amqp:info
  • Hibakeresési naplók lekérése a core-amqp és a protokollszintű kódtárból.
export DEBUG=azure:core-amqp:*,rhea*
  • Ha nem szeretné megtekinteni a nyers eseményadatokat (amely nagy mennyiségű konzolt/lemezterületet használ fel), akkor az alábbi módon állíthatja be a DEBUG környezeti változót:
export DEBUG=azure:core-amqp:*,rhea*,-rhea:raw,-rhea:message
  • Ha csak hibák és SDK-figyelmeztetésekérdekli, akkor a DEBUG környezeti változót az alábbiak szerint állíthatja be:
export DEBUG=azure:core-amqp:(error|warning),rhea-promise:error,rhea:events,rhea:frames,rhea:io,rhea:flow

Naplózás fájlba

  • Állítsa be a DEBUG környezeti változót a fent látható módon, majd futtassa a tesztszkriptet az alábbiak szerint:
    • A tesztszkript naplózási utasításai az out.log és a naplózási utasítás az sdk-ból a debug.log.
      node your-test-script.js > out.log 2>debug.log
      
    • A tesztszkriptből és az sdk-ből származó naplózási utasítások ugyanahhoz a fájlhoz out.log a stderr stdoutra (&1) való átirányításával, majd a stdout fájlba való átirányításával:
      node your-test-script.js >out.log 2>&1
      
    • A tesztszkriptből származó naplózási utasítások és az sdk ugyanarra a fájlra out.log.
      node your-test-script.js &> out.log
      

Hozzájárulás

Ez a projekt üdvözli a hozzájárulásokat és javaslatokat. A legtöbb hozzájárulás megköveteli, hogy elfogadja a közreműködői licencszerződést (CLA), amely kimondja, hogy önnek joga van a hozzájárulás használatára, és valóban meg kell adnia nekünk a jogosultságokat a hozzájárulás használatára. A részletekért látogasson el ide https://cla.microsoft.com.

A lekéréses kérelem elküldésekor a CLA-robot automatikusan meghatározza, hogy meg kell-e adnia egy CLA-t, és megfelelően kell-e díszítenie a lekéréses kérelmet (például címkét, megjegyzést). Egyszerűen kövesse a robot utasításait. Ezt csak egyszer kell elvégeznie az összes adattárban a CLA használatával.

Ha hozzá szeretne járulni ehhez a kódtárhoz, olvassa el a közreműködői útmutatót, amelyből többet is megtudhat a kód összeállításáról és teszteléséről.

Ez a projekt elfogadta a Microsoft nyílt forráskódú magatartási kódexének. További információkért lásd a magatartási kódexével kapcsolatos gyakori kérdéseket, vagy további kérdésekkel vagy megjegyzésekkel forduljon opencode@microsoft.com.