Compartir a través de


Biblioteca cliente de AMQP de Azure Core para JavaScript: versión 4.3.2

El paquete de @azure/core-amqp proporciona funcionalidad común para bibliotecas de JavaScript de Azure que usan el protocolo AMQP de como los de Azure Service Bus y Azure Event Hubs.

Empezar

Instalación

Instale esta biblioteca con npm como se indica a continuación:

npm install @azure/core-amqp

Entornos admitidos actualmente

Consulte nuestra de directiva de soporte técnico de para obtener más información.

Conceptos clave

Algunas de las características clave de la biblioteca AMQP de Azure Core son:

  • de autorización basada en notificaciones de
  • Request-Response vínculo para enviar solicitud y recibir respuesta a través de AMQP
  • Traducción de errores de códigos de error de AMQP junto con errores específicos de Azure Service Bus y Azure Event Hubs.
  • RetryPolicy para reintentar una operación determinada si se encontró un error que se puede reintentar.

Pasos siguientes

Puede compilar y ejecutar las pruebas localmente ejecutando rushx test. Explore la carpeta test para ver el uso avanzado y el comportamiento de las clases públicas.

Solución de problemas

La biblioteca core-amqp depende de la biblioteca de de de rhea-promise para administrar las conexiones y para enviar y recibir eventos a través del protocolo de AMQP.

Registro

Puede establecer la variable de entorno AZURE_LOG_LEVEL en uno de los siguientes valores para habilitar el registro en stderr:

  • verboso
  • información
  • advertencia
  • error

También puede establecer el nivel de registro mediante programación importando el paquete de @azure/registrador y llamando a la función setLogLevel con uno de los valores de nivel de registro. Por ejemplo, al establecer el nivel de registro en info, también se emiten los registros escritos para los niveles warning y error. Este SDK sigue las directrices del SDK de Azure para TypeScript al determinar en qué nivel se va a registrar.

Al establecer un nivel de registro mediante programación o a través de la variable de entorno AZURE_LOG_LEVEL, se emitirán los registros escritos mediante un nivel de registro igual o menor que el que elija.

También puede establecer la variable de entorno DEBUG para obtener registros al usar esta biblioteca. Esto puede ser útil si también desea emitir registros de las dependencias rhea-promise y rhea.

Nota: AZURE_LOG_LEVEL, si se establece, tiene prioridad sobre DEBUG. No especifique ninguna biblioteca de azure a través de DEBUG al especificar también AZURE_LOG_LEVEL ni llamar a setLogLevel.

  • Obtener solo los registros de depuración de nivel de información de la biblioteca core-amqp.
export DEBUG=azure:core-amqp:info
  • Obtención de registros de depuración de core-amqp y la biblioteca de nivel de protocolo.
export DEBUG=azure:core-amqp:*,rhea*
  • Si no está interesado en ver los datos de eventos sin procesar (que consume una gran cantidad de espacio en disco o consola), puede establecer la variable de entorno DEBUG de la siguiente manera:
export DEBUG=azure:core-amqp:*,rhea*,-rhea:raw,-rhea:message
  • Si solo está interesado en errores y advertencias del SDK , puede establecer la variable de entorno DEBUG de la siguiente manera:
export DEBUG=azure:core-amqp:(error|warning),rhea-promise:error,rhea:events,rhea:frames,rhea:io,rhea:flow

Registro en un archivo

  • Establezca la variable de entorno DEBUG como se muestra anteriormente y, a continuación, ejecute el script de prueba como se indica a continuación:
    • Las instrucciones de registro del script de prueba van a out.log y la instrucción de registro del sdk van a debug.log.
      node your-test-script.js > out.log 2>debug.log
      
    • Las instrucciones de registro del script de prueba y el SDK van al mismo archivo out.log redireccionando stderr a stdout (&1) y, a continuación, redirigen stdout a un archivo:
      node your-test-script.js >out.log 2>&1
      
    • Las instrucciones de registro del script de prueba y el sdk van al mismo archivo out.log.
      node your-test-script.js &> out.log
      

Contribuyendo

Este proyecto da la bienvenida a las contribuciones y sugerencias. La mayoría de las contribuciones requieren que acepte un Contrato de licencia de colaborador (CLA) declarando que tiene derecho a, y en realidad, concedanos los derechos para usar su contribución. Para obtener más información, visite https://cla.microsoft.com.

Al enviar una solicitud de incorporación de cambios, un bot CLA determinará automáticamente si necesita proporcionar un CLA y decorar la solicitud de incorporación de cambios de forma adecuada (por ejemplo, etiqueta, comentario). Solo tiene que seguir las instrucciones proporcionadas por el bot. Solo tendrá que hacerlo una vez en todos los repositorios mediante nuestro CLA.

Si desea contribuir a esta biblioteca, lea la guía de contribución de para obtener más información sobre cómo compilar y probar el código.

Este proyecto ha adoptado el código abierto de conducta de Microsoft. Para obtener más información, consulte el de preguntas más frecuentes sobre el código de conducta de o póngase en contacto con con preguntas o comentarios adicionales.

impresiones