Udostępnij za pośrednictwem

Biblioteka klienta rejestratora platformy Azure dla języka JavaScript — wersja 1.1.3

  • Artykuł

Pakiet @azure/logger może służyć do włączania rejestrowania w zestawach SDK platformy Azure dla języka JavaScript.

Rejestrowanie można włączyć dla zestawu Azure SDK w następujący sposób:

  • Ustawianie zmiennej środowiskowej AZURE_LOG_LEVEL
  • Wywoływanie elementu setLogLevel zaimportowanego z "@azure/rejestratora"
  • Wywoływanie funkcji enable() dla określonych rejestratorów
  • Używanie zmiennej środowiskowej DEBUG.

Należy pamiętać, że AZURE_LOG_LEVEL, jeśli ustawiono, ma pierwszeństwo przed debugowaniem. Użyj tylko debugowania bez określania AZURE_LOG_LEVEL lub wywoływania metody setLogLevel.

Wprowadzenie

Instalacja

Zainstaluj tę bibliotekę przy użyciu narzędzia npm w następujący sposób

npm install @azure/logger

Kluczowe pojęcia

Pakiet @azure/logger obsługuje następujące poziomy dziennika określone w kolejności najbardziej pełnej do najmniejszej pełnej:

  • gadatliwy
  • Informacji
  • ostrzeżenie
  • błąd

Podczas ustawiania poziomu dziennika programowo lub za pośrednictwem zmiennej środowiskowej AZURE_LOG_LEVEL wszystkie dzienniki zapisywane przy użyciu poziomu dziennika równego lub mniejszego niż wybrany zostanie wyemitowany.

Na przykład ustawienie poziomu dziennika na wartość warning spowoduje, że wszystkie dzienniki, które mają warning poziomu dziennika lub error być emitowane.

UWAGA: podczas rejestrowania żądań i odpowiedzi usuwamy te obiekty, aby upewnić się, że takie elementy jak nagłówki Authorization zawierające wpisy tajne nie są rejestrowane.

Treść żądań i odpowiedzi nigdy nie jest rejestrowana. Nagłówki są domyślnie redagowane, chyba że znajdują się na poniższej liście lub jawnie dozwolone przez zestaw SDK klienta:

  • "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",
  • "Źródło",
  • "Akceptuj",
  • "Accept-Encoding",
  • "Cache-Control",
  • "Połączenie",
  • "Content-Length",
  • "Typ zawartości",
  • "Data",
  • "ETag",
  • "Wygasa",
  • "If-Match",
  • "If-Modified-Since",
  • "If-None-Match",
  • "If-Unmodified-Since",
  • "Ostatnia modyfikacja",
  • "Pragma",
  • "Identyfikator żądania",
  • "Ponów próbę po",
  • "Serwer",
  • "Kodowanie transferu",
  • "User-Agent",
  • "WWW-Authenticate",

Przykłady

Przykład 1 — podstawowe użycie

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

Przykład 2 — dane wyjściowe dziennika przekierowania

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

Za pomocą AzureLoggermożna przekierować dane wyjściowe rejestrowania z zestawów SDK platformy Azure przez zastąpienie metody AzureLogger.log. Może to być przydatne, jeśli chcesz przekierować dzienniki do lokalizacji innej niż stderr.

Następne kroki

Testy można kompilować i uruchamiać lokalnie, wykonując rushx test. Zapoznaj się z folderem test, aby zobaczyć zaawansowane użycie i zachowanie klas publicznych.

Rozwiązywanie problemów

Jeśli wystąpią problemy podczas korzystania z tej biblioteki, możesz zgłosić problem.

Przyczyniając się

Jeśli chcesz współtworzyć tę bibliotekę, przeczytaj przewodnik dotyczący współtworzenia , aby dowiedzieć się więcej na temat tworzenia i testowania kodu.

wrażenia