Habilitar telemetria para feature flags em um aplicativo Node.js

Neste tutorial, você usará a telemetria em seu aplicativo Node.js para acompanhar avaliações de sinalizador de recursos e eventos personalizados. A telemetria permite que você tome decisões informadas sobre sua estratégia de gerenciamento de recursos. Use o sinalizador de recurso com a telemetria habilitada criada na visão geral para habilitar a telemetria para sinalizadores de recursos. Antes de continuar, certifique-se de criar um sinalizador de recurso chamado Saudação em seu repositório de configuração com telemetria habilitada. Este tutorial baseia-se no tutorial para usar sinalizadores de recursos variantes em um aplicativo Node.js.

Pré-requisitos

Adicionar telemetria ao aplicativo Node.js

  1. Instale os seguintes pacotes.

    npm install @microsoft/feature-management-applicationinsights-node

  2. Abra server.js e adicione o código a seguir no início para se conectar ao Application Insights para publicar a telemetria.

    const appInsightsConnectionString = process.env.APPLICATIONINSIGHTS_CONNECTION_STRING;
const applicationInsights = require("applicationinsights");
applicationInsights.setup(appInsightsConnectionString).start();

const express = require("express");
const server = express();
// existing code ...

  3. Adicione a seguinte importação.

    const { createTelemetryPublisher, trackEvent } = require("@microsoft/feature-management-applicationinsights-node");

  4. Crie e registre o editor de telemetria ao inicializar o FeatureManager.

    // existing code ...
const featureFlagProvider = new ConfigurationMapFeatureFlagProvider(appConfig);
const publishTelemetry = createTelemetryPublisher(applicationInsights.defaultClient);
featureManager = new FeatureManager(featureFlagProvider, {
    onFeatureEvaluated: publishTelemetry
});
// existing code ...

    O retorno de chamada publishTelemetry enviará dados de telemetria sempre que um sinalizador de recurso for avaliado.

  5. Acompanhe eventos personalizados para interações do usuário. Modifique o /api/like endpoint para enviar dados de telemetria para o Application Insights sempre que um usuário curtir conteúdo. Isso ajuda você a analisar quais variantes de recursos têm melhor desempenho.

    server.post("/api/like", (req, res) => {
    const { UserId } = req.body;
    if (UserId === undefined) {
        return res.status(400).send({ error: "UserId is required" });
    }
    trackEvent(applicationInsights.defaultClient, UserId, { name: "Liked" });
    res.status(200).send();
});

Executar o aplicativo

  1. O Application Insights exige uma cadeia de conexão para se conectar ao seu recurso do Application Insights. Defina a variável de ambiente APPLICATIONINSIGHTS_CONNECTION_STRING para a cadeia de conexão do recurso do Application Insights.

    setx APPLICATIONINSIGHTS_CONNECTION_STRING "applicationinsights-connection-string"

    Se você usar o PowerShell, execute o seguinte comando:

    $Env:APPLICATIONINSIGHTS_CONNECTION_STRING = "applicationinsights-connection-string"

    Se você usa macOS ou Linux, execute o comando a seguir:

    export APPLICATIONINSIGHTS_CONNECTION_STRING='applicationinsights-connection-string'

Coletar telemetria

Implante seu aplicativo para começar a coletar telemetria de seus usuários. Para testar sua funcionalidade, você pode simular a atividade do usuário criando muitos usuários de teste. Cada usuário verá uma variante diferente das mensagens de saudação e poderá interagir com o aplicativo clicando no botão com ícone de coração para curtir uma citação. À medida que sua base de usuários cresce, você pode monitorar o volume crescente de dados de telemetria coletados na Configuração de Aplicativos do Azure. Além disso, você pode fazer uma busca detalhada nos dados para analisar como cada variante do sinalizador de recurso influencia o comportamento do usuário.

Recursos adicionais

  • Last updated on