Libreria client di Azure Logger per JavaScript - versione 1.2.0

Il @azure/logger pacchetto può essere usato per abilitare la registrazione negli SDK di Azure per JavaScript.

La registrazione può essere abilitata per Azure SDK nei modi seguenti:

• Impostazione della variabile di ambiente AZURE_LOG_LEVEL
• Chiamata di setLogLevel importato da "@azure/logger"
• Chiamata di enable() in logger specifici
• Utilizzo della variabile d'ambiente DEBUG .

Si noti che AZURE_LOG_LEVEL, se impostato, ha la precedenza su DEBUG. Usare DEBUG solo senza specificare AZURE_LOG_LEVEL o chiamare setLogLevel.

Introduttiva

Installazione

Installare questa libreria usando npm come indicato di seguito

npm install @azure/logger

Concetti chiave

Il @azure/logger pacchetto supporta i seguenti livelli di log specificati nell'ordine dal più dettagliato al meno dettagliato:

• prolisso
• Informazioni
• avvertimento
• errore

Quando si imposta un livello di log, a livello di programmazione o tramite la AZURE_LOG_LEVEL variabile di ambiente, verranno emessi tutti i log scritti utilizzando un livello di log uguale o inferiore a quello scelto.

Ad esempio, l'impostazione del livello di registro su warning causerà l'emissione di tutti i registri che hanno il livello warning di registro o error la generazione.

NOTA: durante la registrazione delle richieste e delle risposte, vengono disinfettati questi oggetti per assicurarsi che elementi come Authorization le intestazioni che contengono segreti non vengano registrati.

I corpi di richiesta e risposta non vengono mai registrati. Le intestazioni vengono elaborate per impostazione predefinita, a meno che non siano presenti nell'elenco seguente o consentite in modo esplicito dall'SDK client:

• "x-ms-client-request-id",
• "x-ms-return-client-request-id",
• "x-ms-useragent",
• "x-ms-correlation-request-id",
• "x-ms-request-id",
• "id-richiesta-cliente",
• "ms-cv",
• "return-client-request-id",
• "traceparent",
• "Access-Control-Allow-Credentials",
• "Access-Control-Allow-Headers",
• "Access-Control-Allow-Methods",
• "Accesso-Controllo-Consenti-Origine",
• "Access-Control-Expose-Headers",
• "Access-Control-Max-Age",
• "Intestazioni-richiesta-controllo-accesso",
• "Metodo di richiesta di controllo degli accessi",
• "Origine",
• "Accetta",
• "Accetta-Codifica",
• "Controllo della cache",
• "Connessione",
• "Lunghezza del contenuto",
• "Tipo di contenuto",
• "Data",
• "ETag",
• "Scade",
• "If-Match",
• "Se-modificato-da",
• "Se-Nessuno-Corrisponde",
• "se-non-modificato-da",
• "Ultima modifica",
• "Pragma",
• "ID richiesta",
• "Riprova-Dopo",
• "Servitore",
• "Codifica di trasferimento",
• "User-Agent",
• "WWW-Authenticate",

Esempi

Esempio 1 - Utilizzo di base

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

setLogLevel("info");

Esempio 2: reindirizzare l'output del log

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);
};

Utilizzando AzureLogger, è possibile reindirizzare l'output di registrazione dagli SDK di Azure eseguendo l'override del AzureLogger.log metodo. Questo può essere utile se si desidera reindirizzare i log a una posizione diversa da stderr.

Passaggi successivi

È possibile compilare ed eseguire i test in locale eseguendo rushx test. Esplorare la cartella test per visualizzare l'utilizzo e il comportamento avanzati delle classi pubbliche.

Risoluzione dei problemi

Se si verificano problemi durante l'uso di questa libreria, è possibile segnalare un problema.

Contribuire

Per contribuire a questa libreria, leggere la guida per i contributi per altre informazioni su come compilare e testare il codice.