Biblioteca de clientes do Logger do Azure para JavaScript – versão 1.2.0

O @azure/logger pacote pode ser usado para habilitar o registro em log nos SDKs do Azure para JavaScript.

O log pode ser habilitado para o SDK do Azure das seguintes maneiras:

• Definindo a variável de ambiente AZURE_LOG_LEVEL
• Chamando setLogLevel importado de "@azure/agente"
• Chamando enable() em agentes específicos
• Usando a DEBUG variável de ambiente.

Observe que AZURE_LOG_LEVEL, se definido, tem precedência sobre DEBUG. Use apenas DEBUG sem especificar AZURE_LOG_LEVEL ou chamar setLogLevel.

Introdução

Instalação

Instalar esta biblioteca usando o npm da seguinte maneira

npm install @azure/logger

Principais conceitos

O @azure/logger pacote suporta os seguintes níveis de log especificados na ordem do mais detalhado para o menos detalhado:

• prolixo
• informação
• aviso
• erro

Ao definir um nível de log, programaticamente ou por meio da AZURE_LOG_LEVEL variável de ambiente, todos os logs gravados usando um nível de log igual ou menor que o escolhido serão emitidos.

Por exemplo, definir o nível de log como warning fará com que todos os logs que têm o nível warning de log ou error sejam emitidos.

NOTA: Ao registrar solicitações e respostas, limpamos esses objetos para garantir que coisas como Authorization cabeçalhos que contêm segredos não sejam registradas.

Os corpos de solicitação e resposta nunca são registrados. Os cabeçalhos são redigidos por padrão, a menos que estejam presentes na lista a seguir ou explicitamente permitidos pelo SDK do cliente:

• "x-ms-client-request-id",
• "x-ms-return-client-request-id",
• "x-ms-useragent",
• "x-ms-correlation-request-id",
• "x-ms-request-id",
• "ID de solicitação do cliente",
• "ms-cv",
• "ID de solicitação de cliente de retorno",
• "traceparent",
• "Access-Control-Allow-Credentials",
• "Cabeçalhos de Permissão de Controle de Acesso",
• "Métodos de Permissão de Controle de Acesso",
• "Acesso-Controle-Permitir-Origem",
• "Cabeçalhos de exposição de controle de acesso",
• "Access-Control-Max-Age",
• "Cabeçalhos de solicitação de controle de acesso",
• "Método de solicitação de controle de acesso",
• "Origem",
• "Aceitar",
• "Aceitar codificação",
• "Controle de Cache",
• "Conexão",
• "Comprimento do conteúdo",
• "Tipo de conteúdo",
• "Data",
• "ETag",
• "Expira",
• "If-Match",
• "Se-modificado-desde",
• "Se-Nenhuma-Correspondência",
• "Se-Não modificado-Desde",
• "Última modificação",
• "Pragma",
• "ID de solicitação",
• "Tentar depois",
• "Servidor",
• "Transferência-Codificação",
• "Agente do usuário",
• "WWW-Autenticar",

Exemplos

Exemplo 1 – uso básico

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

setLogLevel("info");

Exemplo 2 – redirecionar a saída do log

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

Usando AzureLogger, é possível redirecionar a saída de log dos SDKs do Azure substituindo o AzureLogger.log método. Isso pode ser útil se você quiser redirecionar logs para um local diferente de stderr.

Próximas etapas

Você pode compilar e executar os testes localmente executando rushx test. Explore a pasta test para ver o uso e o comportamento avançados das classes públicas.

Solucionando problemas

Se você tiver problemas ao usar essa biblioteca, fique à vontade para registrar um problema.

Contribuindo

Se você quiser contribuir com essa biblioteca, leia o guia de contribuição para saber mais sobre como criar e testar o código.