Compartir a través de

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

El @azure/logger paquete 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 DEBUG entorno.

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 @azure/logger paquete admite los siguientes niveles de registro especificados en orden de mayor a menor detalle:

  • verboso
  • información
  • advertencia
  • error

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

Por ejemplo, si se establece el nivel de registro en warning se emitirán todos los registros que tengan el nivel warning de registro o error .

NOTA: Al registrar solicitudes y respuestas, desinfectamos estos objetos para asegurarnos de que no se registren elementos como Authorization los 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",
  • "identificación-de-solicitud-de-cliente",
  • "ms-cv",
  • "return-client-request-id",
  • "trazas",
  • "Access-Control-Allow-Credentials",
  • "Encabezados-de-Permiso-de-Acceso",
  • "Métodos-de-control-de-acceso-permitido",
  • "Acceso-Control-Permitir-Origen",
  • "Encabezados-de-Exposición-de-Control-Acceso",
  • "Access-Control-Max-Age",
  • "Encabezados-de-solicitud-de-control-acceso",
  • "Método-de-solicitud-de-control-de-acceso",
  • "Origen",
  • "Aceptar",
  • "Aceptar-Codificar",
  • "Control de caché",
  • "Conexión",
  • "Longitud del contenido",
  • "Tipo de contenido",
  • "Fecha",
  • "ETag",
  • "Expira",
  • "Si-Coincidencia",
  • "si-modificado-desde",
  • "Si-no-coincidencia-de-Ninguna",
  • "si-sin-modificar-desde",
  • "Última modificación",
  • "Pragma",
  • "Id-de-solicitud",
  • "Reintentar después",
  • "Servidor",
  • "Codificación de transferencia",
  • "Usuario-Agente",
  • "WWW-Autenticar",

Ejemplos

Ejemplo 1: uso básico

import { setLogLevel } from "@azure/logger";

setLogLevel("info");

Ejemplo 2: salida del registro de redirección

import { setLogLevel, AzureLogger } from "@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 invalidando el AzureLogger.log método. 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.