Azure Logger-clientbibliotheek voor JavaScript - versie 1.2.0

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

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
• Met behulp van de DEBUG omgevingsvariabele.

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 meest uitgebreid naar minst uitgebreid:

• breedsprakig
• informatie
• waarschuwing
• fout

Bij het instellen van een logboekniveau, hetzij programmatisch of via de AZURE_LOG_LEVEL omgevingsvariabele, worden alle logboeken verzonden die zijn geschreven met een logboekniveau dat gelijk is aan of kleiner is dan het niveau dat u kiest.

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

OPMERKING: Bij het registreren van verzoeken en reacties wissen we deze objecten op om ervoor te zorgen dat zaken als Authorization headers die geheimen bevatten, niet worden geregistreerd.

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-aanvraag-id",
• "x-ms-return-client-request-id",
• "x-ms-useragent",
• "x-ms-correlatie-verzoek-id",
• "x-ms-request-id",
• "client-aanvraag-id",
• "ms-cv",
• "return-client-request-id",
• "Stamouder",
• "Toegangscontrole-toestaan-inloggegevens",
• "access-control-allow-headers",
• "Access-control-allow-methods",
• "toegangscontrole-toestaan-oorsprong",
• "Toegangscontrole-exposanten",
• "Toegangscontrole-Max-Age",
• "Toegangscontrole-Verzoek-headers",
• "Toegangscontrole-Aanvraag-Methode",
• "Oorsprong",
• "Accepteren",
• "Accepteren-codering",
• "Cachebeheer",
• "Verbinding",
• "inhoud-lengte",
• "Inhoudstype",
• "Datum",
• "ETag",
• "Verloopt",
• "Als-Match",
• "als-gewijzigd-sinds",
• "Als-Geen-Overeenkomst",
• "als-ongewijzigd-sinds",
• "Laatst gewijzigd",
• "Pragma",
• "Aanvraag-id",
• "Opnieuw proberen na",
• "Server",
• "Overdracht-codering",
• "user-agent",
• "WWW-Authenticeren",

Voorbeelden

Voorbeeld 1: basisgebruik

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

setLogLevel("info");

Voorbeeld 2: uitvoer van omleidingslogboek

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

Met behulp van AzureLogger, is het mogelijk om de logboekuitvoer van de Azure SDK's om te leiden 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.