Compartir a través de

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

  • Artículo

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
  • Llamar a setLogLevel importado desde "@azure/registrador"
  • Llamada a enable() en registradores específicos
  • Uso de la variable de entorno DEBUG.

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

Empezar

Instalación

Instale esta biblioteca mediante 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 de la mayoría de los detalles a los mínimos detallados:

  • verboso
  • información
  • advertencia
  • error

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

Por ejemplo, si se establece el nivel de registro en warning, todos los registros que tienen el nivel de registro warning o error que se van a emitir.

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 que el SDK de cliente permita explícitamente:

  • "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",
  • "Aceptar",
  • "Accept-Encoding",
  • "Cache-Control",
  • "Conexión",
  • "Content-Length",
  • "Content-Type",
  • "Fecha",
  • "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: uso básico

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 redirección

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 desde los SDK de Azure reemplazando el método AzureLogger.log. Esto puede ser útil si desea 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.

Contribuyendo

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.

impresiones