Biblioteca cliente de AMQP de Azure Core para JavaScript: versión 4.3.0
El @azure/core-amqp
paquete proporciona una funcionalidad común para las bibliotecas de JavaScript de Azure que usan el protocolo AMQP, como los que se usan para Azure Service Bus y Azure Event Hubs.
Introducción
Instalación
Instale esta biblioteca con npm de la siguiente manera:
npm install @azure/core-amqp
Entornos admitidos actualmente
- Versiones de LTS de Node.js
- Versiones más recientes de Safari, Chrome, Edge y Firefox.
Para más información, consulte la directiva de compatibilidad.
Conceptos clave
Algunas de las características clave de la biblioteca AMQP de Azure Core son:
- Autorización basada en notificaciones
- Request-Response vínculo para enviar solicitudes 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 reintentos.
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 rhea-promise para administrar conexiones y para enviar y recibir eventos a través del protocolo AMQP .
Registro
Puede establecer la variable de entorno en uno de los siguientes valores para habilitar el AZURE_LOG_LEVEL
registro en stderr
:
- verbose
- info
- warning
- error
También puede establecer el nivel de registro mediante programación importando el paquete de @azure/registrador y llamando a la setLogLevel
función con uno de los valores de nivel de registro.
Por ejemplo, al establecer el nivel info
de registro en , también se emiten los registros escritos para los niveleswarning
.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 AZURE_LOG_LEVEL
variable de entorno, se emitirán los registros escritos mediante un nivel de registro igual o menor que el que elija.
También puede establecer la DEBUG
variable de entorno 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 azure
biblioteca a través de DEBUG cuando también especifique AZURE_LOG_LEVEL o llame 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 consumen una gran cantidad de espacio en disco o consola), puede establecer la variable de entorno de la
DEBUG
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 de la
DEBUG
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 como se muestra anteriormente y, a continuación, ejecute el
DEBUG
script de prueba de la siguiente manera:- Las instrucciones de registro del script de prueba van a
out.log
y la instrucción de registro del sdk van adebug.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
redirigiendo stderr a stdout (&1) y luego redirige 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
- Las instrucciones de registro del script de prueba van a
Contribuciones
Este proyecto agradece las contribuciones y sugerencias. La mayoría de las contribuciones requieren que acepte un Contrato de licencia para el colaborador (CLA) que declara que tiene el derecho a concedernos y nos concede los derechos para usar su contribución. Para más detalles, visite https://cla.microsoft.com.
Cuando se envía una solicitud de incorporación de cambios, un bot de CLA determinará de forma automática si tiene que aportar un CLA y completar la PR adecuadamente (por ejemplo, la etiqueta, el comentario). Solo siga las instrucciones que le dará el bot. Solo será necesario que lo haga una vez en todos los repositorios con nuestro CLA.
Si desea contribuir a esta biblioteca, lea la guía de contribución para obtener más información sobre cómo compilar y probar el código.
El proyecto ha adoptado el Código de conducta de código abierto de Microsoft. Para más información, consulte las preguntas más frecuentes del código de conducta o póngase en contacto con opencode@microsoft.com si tiene cualquier otra pregunta o comentario.
Azure SDK for JavaScript
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de