Libreria client di Azure Logger per JavaScript - versione 1.1.2

Il pacchetto @azure/logger 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 importata da "@azure/logger"
• Chiamata a enable() su logger specifici
• Usp della variabile di ambiente DEBUG.

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

Introduzione

Installazione

Installare questa libreria usando npm come indicato di seguito

npm install @azure/logger

Concetti chiave

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

• verbose
• info
• warning
• error

Quando si imposta un livello di log, a livello di codice o tramite la variabile di ambiente AZURE_LOG_LEVEL, verrà emesso qualsiasi log scritto usando un livello di log minore o uguale a quello scelto.

Ad esempio, impostando il livello di log su warning, verranno emessi tutti i log con il livello di log warning o error.

NOTA: quando si registrano richieste e risposte, questi oggetti vengono sanificati per assicurarsi che le Authorization intestazioni contenenti segreti non vengano registrate.

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 esplicitamente consentite 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",
• "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",
• "Origin",
• "Accept",
• "Accept-Encoding",
• "Cache-Control",
• "Connection",
• "Content-Length",
• "Content-Type",
• "Date",
• "ETag",
• "Expires",
• "If-Match",
• "If-Modified-Since",
• "If-None-Match",
• "If-Unmodified-Since",
• "Ultima modifica",
• "Pragma",
• "Request-Id",
• "Retry-After",
• "Server",
• "Transfer-Encoding",
• "User-Agent",
• "WWW-Authenticate",

Esempio

Esempio 1 - Utilizzo di base

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

Esempio 2 - Reindirizzare l'output del log

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

Usando AzureLogger, è possibile reindirizzare l'output della registrazione dagli SDK di Azure eseguendo l'override del metodo AzureLogger.log. Ciò può essere utile se si vogliono 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.

Contributo

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