Biblioteca cliente de Azure Logger para JavaScript: versión 1.1.2

El paquete @azure/logger se puede usar para habilitar el registro en los SDK de Azure para JavaScript.

El registro se puede habilitar para el SDK de Azure de las maneras siguientes:

• Establecimiento de la variable de entorno AZURE_LOG_LEVEL
• Llamada a setLogLevel importado desde "@azure/registrador"
• Llamada a enable() en registradores específicos
• Uso de la variable de entorno DEBUG.

Tenga en cuenta que, si se establece, AZURE_LOG_LEVEL tiene prioridad sobre DEBUG. Use DEBUG solo sin especificar AZURE_LOG_LEVEL ni llamar a setLogLevel.

Introducción

Instalación

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

npm install @azure/logger

Conceptos clave

El paquete @azure/logger admite los siguientes niveles de registro, especificados en orden del más detallado al menos detallado:

• verbose
• info
• warning
• error

Al establecer un nivel de registro, ya sea mediante programación o con la variable de entorno AZURE_LOG_LEVEL, se emitirán los registros escritos con un nivel de registro igual o menor que el elegido.

Por ejemplo, establecer el nivel de registro en warning hará que se emitan todos los registros que tengan el nivel de registro warning o error.

NOTA: Al registrar solicitudes y respuestas, se limpian estos objetos para asegurarse de que no se registran elementos como Authorization encabezados que contienen secretos.

Los cuerpos de solicitud y respuesta nunca se registran. Los encabezados se redactan de forma predeterminada, a menos que estén presentes en la lista siguiente o se permitan explícitamente por el SDK de cliente:

• "x-ms-client-request-id",
• "x-ms-return-client-request-id",
• "x-ms-useragent",
• "x-ms-correlation-request-id",
• "x-ms-request-id",
• "client-request-id",
• "ms-cv",
• "return-client-request-id",
• "traceparent",
• "Access-Control-Allow-Credentials",
• "Access-Control-Allow-Headers",
• "Access-Control-Allow-Methods",
• "Access-Control-Allow-Origin",
• "Access-Control-Expose-Headers",
• "Access-Control-Max-Age",
• "Access-Control-Request-Headers",
• "Access-Control-Request-Method",
• "Origen",
• "Accept",
• "Accept-Encoding",
• "Cache-Control",
• "Conexión",
• "Content-Length",
• "Content-Type",
• "Date",
• "ETag",
• "Expira",
• "If-Match",
• "If-Modified-Since",
• "If-None-Match",
• "If-Unmodified-Since",
• "Última modificación",
• "Pragma",
• "Request-Id",
• "Reintentar después",
• "Servidor",
• "Transfer-Encoding",
• "User-Agent",
• "WWW-Authenticate",

Ejemplos

Ejemplo 1: utilización básica

const { EventHubClient } = require('@azure/event-hubs');

const logger = require('@azure/logger');
logger.setLogLevel('info');

// operations will now emit info, warning, and error logs
const client = new EventHubClient(/* params */);
client.getPartitionIds()
  .then(ids => { /* do work */ })
  .catch(e => { /* do work */ });
});

Ejemplo 2: salida del registro de redireccionamiento

const { AzureLogger, setLogLevel } = require("@azure/logger");

setLogLevel("verbose");

// override logging to output to console.log (default location is stderr)
AzureLogger.log = (...args) => {
  console.log(...args);
};

Con AzureLogger, es posible redirigir la salida de registro de los SDK de Azure mediante la invalidación del método AzureLogger.log. Esto puede resultar útil si quiere redirigir los registros a una ubicación distinta de stderr.

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

Si tiene problemas al usar esta biblioteca, no dude en presentar un problema.

Contribuciones

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.