Azure Logger JavaScript-ügyféloldali kódtár – 1.2.0-s verzió

A @azure/logger csomag segítségével engedélyezheti a naplózást a JavaScripthez készült Azure SDK-kban.

A naplózás az Azure SDK-hoz a következő módokon engedélyezhető:

• A AZURE_LOG_LEVEL környezeti változó beállítása
• A "@azure/logger" fájlból importált setLogLevel hívása
• Az enable() meghívása adott naplózókon
• A környezeti változó használata DEBUG .

Vegye figyelembe, hogy AZURE_LOG_LEVEL, ha be van állítva, elsőbbséget élvez a DEBUG-nak. Csak a DEBUG függvényt használja AZURE_LOG_LEVEL megadása vagy a setLogLevel hívása nélkül.

Kezdetekhez

Telepítés

A kódtár telepítése az npm használatával az alábbiak szerint

npm install @azure/logger

Alapfogalmak

A @azure/logger csomag a következő naplózási szinteket támogatja, amelyek a legrészletesebbtől a legkevésbé részletesig vannak megadva:

• bőbeszédű
• infó
• figyelmeztetés
• hiba

A naplózási szint programozott módon vagy a AZURE_LOG_LEVEL környezeti változón keresztül történő beállításakor a rendszer kibocsátja a választott vagy annál kisebb naplózási szinttel írt naplókat.

Ha például a naplózási szintet a következőre warningwarningerror állítja, az összes napló kibocsátásra kerül.

MEGJEGYZÉS: A kérések és válaszok naplózásakor megtisztítjuk ezeket az objektumokat, hogy a titkos kulcsokat tartalmazó fejlécek Authorization ne legyenek naplózva.

A kérés- és választestek soha nem lesznek naplózva. A fejlécek alapértelmezés szerint újra vannak állítva, kivéve, ha az ügyféloldali SDK az alábbi listában szerepel, vagy kifejezetten engedélyezi:

• "x-ms-client-request-id",
• "x-ms-return-client-request-id",
• "x-ms-useragent",
• "x-ms-korreláció-kérés-azonosító",
• "x-ms-request-id",
• "ügyfél-kérés-azonosító",
• "ms-cv",
• "return-client-request-id",
• "traceparent",
• "Hozzáférés-vezérlés-engedélyezési hitelesítő adatok",
• "Access-Control-Allow-Headers",
• "Hozzáférés-vezérlés-engedélyezés-módszerek",
• "hozzáférés-vezérlés-engedélyezés-forrás",
• "Hozzáférés-vezérlés-Fejlécek",
• "Hozzáférés-vezérlés-Max-Age",
• "Access-Control-Request-Headers",
• "Hozzáférés-vezérlés-kérés-módszer",
• "Eredet",
• "Elfogadás",
• "Elfogadás-kódolás",
• "Gyorsítótár-vezérlés",
• "Kapcsolat",
• "Tartalomhossz",
• "Tartalomtípus",
• "Dátum",
• "ETag",
• "Lejár",
• "ha-mérkőzés",
• "ha-módosított-mita",
• "ha-nincs-egyezés",
• "ha-nem módosított, mióta",
• "Utolsó módosítás",
• "Pragma",
• "Kérés-azonosító",
• "Újrapróbálkozás után",
• "Kiszolgáló",
• "átvitel-kódolás",
• "Felhasználói ügynök",
• "WWW-hitelesítés",

Példák

1. példa – alapszintű használat

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

setLogLevel("info");

2. példa – átirányítási napló kimenete

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

A használatával AzureLoggera metódus felülbírálásával AzureLogger.log átirányíthatja a naplózási kimenetet az Azure SDK-kból. Ez akkor lehet hasznos, ha a naplókat nem stderr helyre szeretné átirányítani.

Következő lépések

A teszteket helyileg hozhatja létre és futtathatja a rushx testvégrehajtásával. A test mappában megtekintheti a nyilvános osztályok speciális használatát és viselkedését.

Hibaelhárítás

Ha a kódtár használata során problémákba ütközik, nyugodtan a problémát.

Hozzájárulás

Ha hozzá szeretne járulni ehhez a kódtárhoz, olvassa el a közreműködői útmutatót , amelyből többet is megtudhat a kód összeállításáról és teszteléséről.