Partilhar via

Configurar o registro em log nas bibliotecas de cliente do SDK do Azure para JavaScript

Este artigo explica como configurar o registo nas bibliotecas do SDK do Azure para JavaScript. Habilitar o registro em log ajuda a diagnosticar problemas de autenticação, solucionar problemas de cadeias de credenciais e obter visibilidade das operações do SDK.

Para habilitar o registro em log, você pode usar uma das opções abaixo:

  • Defina a variável de ambiente para ativar o AZURE_LOG_LEVEL=verbose registro.
  • Use o @azure/logger pacote em seu código-fonte.

Os níveis de log válidos incluem verbose, info, warninge error.

Observação

O código de Armazenamento do Azure mostrado neste artigo pressupõe que o recurso de armazenamento tenha sido configurado com as funções apropriadas do Microsoft Entra. Saiba mais: Autorize o acesso a blobs usando a ID do Microsoft Entra.

Pré-requisitos

  • Uma assinatura do Azure: crie uma gratuitamente
  • Node.js LTS
  • Opcional, uma ferramenta de desenvolvedor, como a CLI do Azure , usada para autenticação em um ambiente de desenvolvimento local. Para criar o contexto necessário, entre com a CLI do Azure.

Habilitar o registro em log com variável de ambiente

Inicie o aplicativo com a variável de ambiente para uma maneira simples de habilitar o registro.

AZURE_LOG_LEVEL=verbose node index.js

Definir variáveis de ambiente

Você também pode adicionar variáveis de ambiente a um .env arquivo na raiz do projeto. Crie um arquivo chamado .env e adicione o seguinte conteúdo.

AZURE_LOG_LEVEL=verbose
AZURE_CLIENT_ID=<YOUR_CLIENT_ID>
AZURE_STORAGE_ACCOUNT_NAME=<YOUR_STORAGE_ACCOUNT_NAME>
AZURE_STORAGE_CONTAINER_NAME=<YOUR_STORAGE_CONTAINER_NAME>

Habilitar o registro em log com o pacote do registrador no código-fonte

O exemplo de código a seguir usa o pacote @azure/logger para depurar as bibliotecas de cliente do SDK do Azure.

Configurar o registo para serviços específicos

Além de definir um nível de log global, você pode configurar diferentes níveis de log para serviços específicos do Azure diretamente em seu código:

// Import service-specific setLogLevel functions
import { setLogLevel as setIdentityLogLevel } from "@azure/identity";
import { setLogLevel as setStorageLogLevel } from "@azure/storage-blob";

// Set different log levels for different services
setIdentityLogLevel("verbose");  // Detailed logs for identity operations
setStorageLogLevel("warning");   // Only warnings and errors for storage operations

Essa abordagem oferece controle refinado sobre a verbosidade do registro em log ao trabalhar com vários serviços do Azure no mesmo aplicativo.

  1. Crie index.js com o código a seguir.

    import {
    ChainedTokenCredential,
    ManagedIdentityCredential,
    AzureCliCredential
} from "@azure/identity";
import { BlobServiceClient } from "@azure/storage-blob";
import { AzureLogger, setLogLevel } from "@azure/logger";

// Check required environment variables
if (!process.env.AZURE_STORAGE_ACCOUNT_NAME) {
    throw new Error("AZURE_STORAGE_ACCOUNT_NAME environment variable is required");
}

if (!process.env.AZURE_STORAGE_CONTAINER_NAME) {
    throw new Error("AZURE_STORAGE_CONTAINER_NAME environment variable is required");
}

// Client ID is optional and only used in production environments
// No need to check for its existence

// Turn on debugging for all Azure SDKs   
setLogLevel("verbose");

// Configure the logger to use console.
AzureLogger.log = (...args)=> {
    console.log(...args);
};

const credential = new ChainedTokenCredential(
    new ManagedIdentityCredential({ clientId: process.env.AZURE_CLIENT_ID }),
    new AzureCliCredential()
);

const blobServiceClient = new BlobServiceClient(
    `https://${process.env.AZURE_STORAGE_ACCOUNT_NAME}.blob.core.windows.net`,
    credential
);
// get container properties
const containerClient = blobServiceClient.getContainerClient(process.env.AZURE_STORAGE_CONTAINER_NAME);

async function main() {
    try {
        const properties = await containerClient.getProperties();

        console.log(properties);
    } catch (err) {
        const error = err;
        console.error("Error retrieving container properties:", error.message);
        throw error;
    }
}

main().catch((err) => {
    console.error("Error running sample:", err.message);
    process.exit(1);
});

  2. Crie o projeto e instale as dependências do npm.

    npm init -y
npm pkg set type=module
npm install @azure/identity @azure/storage-blob @azure/logger

  3. Entre em sua assinatura do Azure em seu ambiente local com a CLI do Azure.

    az login

  4. Execute o aplicativo com um arquivo de variável de ambiente. A --env-file opção foi introduzida na Node.js 20.6.0.

    node --env-file .env index.js

  5. Encontre a credencial bem-sucedida na saída. ChainedTokenCredential permite que seu código alterne perfeitamente entre métodos de autenticação, primeiro tentando ManagedIdentityCredential (para ambientes de produção como o Serviço de Aplicativo do Azure) e depois voltando para AzureCliCredential (para desenvolvimento local), com logs mostrando qual credencial foi bem-sucedida.

Pré-requisitos

Habilitar o registro em log com variável de ambiente

Inicie o aplicativo com a variável de ambiente para uma maneira simples de habilitar o registro.

AZURE_LOG_LEVEL=verbose node index.js

Definir variáveis de ambiente

Você também pode adicionar variáveis de ambiente a um .env arquivo na raiz do projeto. Crie um arquivo chamado .env e adicione o seguinte conteúdo.

AZURE_LOG_LEVEL=verbose
AZURE_CLIENT_ID=<YOUR_CLIENT_ID>
AZURE_STORAGE_ACCOUNT_NAME=<YOUR_STORAGE_ACCOUNT_NAME>
AZURE_STORAGE_CONTAINER_NAME=<YOUR_STORAGE_CONTAINER_NAME>

Habilitar o registro em log com o pacote do registrador no código-fonte

O exemplo de código a seguir usa o pacote @azure/logger para depurar as bibliotecas de cliente do SDK do Azure.

Configurar o registo para serviços específicos

Além de definir um nível de log global, você pode configurar diferentes níveis de log para serviços específicos do Azure diretamente em seu código:

// Import service-specific setLogLevel functions
import { setLogLevel as setIdentityLogLevel } from "@azure/identity";
import { setLogLevel as setStorageLogLevel } from "@azure/storage-blob";

// Set different log levels for different services
setIdentityLogLevel("verbose");  // Detailed logs for identity operations
setStorageLogLevel("warning");   // Only warnings and errors for storage operations

Essa abordagem oferece controle refinado sobre a verbosidade do registro em log ao trabalhar com vários serviços do Azure no mesmo aplicativo.

  1. Crie index.ts com o código a seguir.

    import {
    ChainedTokenCredential,
    ManagedIdentityCredential,
    AzureCliCredential
} from "@azure/identity";
import { BlobServiceClient, ContainerGetPropertiesResponse } from "@azure/storage-blob";
import { AzureLogger, setLogLevel } from "@azure/logger";

// Check required environment variables
if (!process.env.AZURE_STORAGE_ACCOUNT_NAME) {
    throw new Error("AZURE_STORAGE_ACCOUNT_NAME environment variable is required");
}

if (!process.env.AZURE_STORAGE_CONTAINER_NAME) {
    throw new Error("AZURE_STORAGE_CONTAINER_NAME environment variable is required");
}

// Client ID is optional and only used in production environments
// No need to check for its existence

// Turn on debugging for all Azure SDKs   
setLogLevel("verbose");

// Configure the logger to use console.log with TypeScript type safety
AzureLogger.log = (...args: unknown[]): void => {
    console.log(...args);
};

const credential = new ChainedTokenCredential(
    new ManagedIdentityCredential({ clientId: process.env.AZURE_CLIENT_ID }),
    new AzureCliCredential()
);

const blobServiceClient = new BlobServiceClient(
    `https://${process.env.AZURE_STORAGE_ACCOUNT_NAME}.blob.core.windows.net`,
    credential
);
// get container properties
const containerClient = blobServiceClient.getContainerClient(process.env.AZURE_STORAGE_CONTAINER_NAME);

async function main(): Promise<void> {
    try {
        const properties: ContainerGetPropertiesResponse = await containerClient.getProperties();

        console.log(properties);
    } catch (err) {
        const error = err as Error;
        console.error("Error retrieving container properties:", error.message);
        throw error;
    }
}

main().catch((err: Error) => {
    console.error("Error running sample:", err.message);
    process.exit(1);
});

  2. Crie o projeto e instale as dependências do npm.

    npm init -y
npm pkg set type=module
npm install @azure/identity @azure/storage-blob @types/node @azure/logger

  3. Entre em sua assinatura do Azure em seu ambiente local com a CLI do Azure.

    az login

  4. Crie o aplicativo.

    tsc

  5. Execute o aplicativo com um arquivo de variável de ambiente. A --env-file opção foi introduzida na Node.js 20.6.0.

    node --env-file .env index.js

  6. Encontre a credencial bem-sucedida na saída - a ChainedTokenCredential permite que seu código alterne perfeitamente entre métodos de autenticação, primeiro tentando ManagedIdentityCredential (para ambientes de produção como o Serviço de Aplicativo do Azure) e depois voltando para AzureCliCredential (para desenvolvimento local), com logs mostrando qual credencial foi bem-sucedida.

Recursos adicionais

  • Last updated on