Delen via


Azure Logger-clientbibliotheek voor JavaScript - versie 1.1.4

Het @azure/logger-pakket kan worden gebruikt om logboekregistratie in te schakelen in de Azure SDK's voor JavaScript.

Logboekregistratie kan op de volgende manieren worden ingeschakeld voor de Azure SDK:

  • De omgevingsvariabele AZURE_LOG_LEVEL instellen
  • SetLogLevel wordt geïmporteerd vanuit '@azure/logger' aanroepen
  • Enable() aanroepen voor specifieke logboekregistraties
  • De omgevingsvariabele DEBUG gebruiken.

Houd er rekening mee dat AZURE_LOG_LEVEL, indien ingesteld, voorrang heeft op DEBUG. Gebruik ALLEEN DEBUG zonder AZURE_LOG_LEVEL of het aanroepen van setLogLevel op te geven.

Slag

Installatie

Installeer deze bibliotheek als volgt met npm

npm install @azure/logger

Sleutelbegrippen

Het @azure/logger-pakket ondersteunt de volgende logboekniveaus die zijn opgegeven in volgorde van uitgebreidste tot minst uitgebreid:

  • breedsprakig
  • info
  • waarschuwing
  • fout

Wanneer u een logboekniveau instelt, programmatisch of via de omgevingsvariabele AZURE_LOG_LEVEL, worden alle logboeken die zijn geschreven met een logboekniveau dat gelijk is aan of kleiner is dan het logboekniveau dat u kiest, verzonden.

Als u bijvoorbeeld het logboekniveau instelt op warning, worden alle logboeken met het logboekniveau warning of error verzonden.

OPMERKING: bij het registreren van aanvragen en antwoorden worden deze objecten opgeschoond om ervoor te zorgen dat zaken zoals Authorization headers die geheimen bevatten, niet worden vastgelegd.

Aanvraag- en antwoordteksten worden nooit geregistreerd. Headers worden standaard opnieuw uitgevoerd, tenzij deze aanwezig zijn in de volgende lijst of expliciet zijn toegestaan door de client-SDK:

  • "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",
  • "Oorsprong",
  • "Accepteren",
  • "Accept-Encoding",
  • "Cachebeheer",
  • "Verbinding",
  • "Content-Length",
  • "Inhoudstype",
  • "Datum",
  • "ETag",
  • "Verloopt",
  • "If-Match",
  • "If-Modified-Since",
  • "If-None-Match",
  • "If-Unmodified-Since",
  • "Laatst gewijzigd",
  • "Pragma",
  • "Aanvraag-id",
  • "Opnieuw proberen na",
  • "Server",
  • "Overdracht-codering",
  • "User-Agent",
  • "WWW-Authenticate",

Voorbeelden

Voorbeeld 1: basisgebruik

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

Voorbeeld 2: uitvoer van omleidingslogboek

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

Met AzureLoggerkunt u de logboekuitvoer van de Azure SDK's omleiden door de AzureLogger.log methode te overschrijven. Dit kan handig zijn als u logboeken wilt omleiden naar een andere locatie dan stderr.

Volgende stappen

U kunt de tests lokaal bouwen en uitvoeren door rushx testuit te voeren. Verken de map test om geavanceerd gebruik en gedrag van de openbare klassen te bekijken.

Probleemoplossing

Als u problemen ondervindt tijdens het gebruik van deze bibliotheek, kunt u gerust een probleem indienen.

Bijdragen

Als u een bijdrage wilt leveren aan deze bibliotheek, leest u de gids voor bijdragen voor meer informatie over het bouwen en testen van de code.

indrukken