Node.js アプリケーションで機能フラグのテレメトリを有効にする

このチュートリアルでは、Node.js アプリケーションでテレメトリを使用して、機能フラグの評価とカスタム イベントを追跡します。 テレメトリを使用すると、機能管理戦略に関する情報に基づいた意思決定を行うことができます。 機能フラグにテレメトリを有効にするには、テレメトリが有効になっている機能フラグを概要で作成したものを使用します。 先に進む前に、テレメトリを有効にして、構成ストアに Greeting という名前の機能フラグを作成してください。 このチュートリアルは、 Node.js アプリケーションでバリアント機能フラグを使用するためのチュートリアルに基づいています。

[前提条件]

Node.js アプリケーションにテレメトリを追加する

  1. 次のパッケージをインストールしてください。

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

  2. server.js開き、最初に次のコードを追加して Application Insights に接続し、テレメトリを発行します。

    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. 次のインポートを追加します。

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

  4. FeatureManagerを初期化するときに、テレメトリ発行元を作成して登録します。

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

    publishTelemetryコールバックは、機能フラグが評価されるたびにテレメトリ データを送信します。

  5. ユーザー操作のカスタム イベントを追跡します。 ユーザーがコンテンツを気に入ったときにテレメトリ データを Application Insights に送信するように、 /api/like エンドポイントを変更します。 これにより、どの機能バリアントのパフォーマンスが向上するかを分析できます。

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

アプリケーションを実行する

  1. Application Insights リソースに接続するには、接続文字列が必要です。 APPLICATIONINSIGHTS_CONNECTION_STRING環境変数を Application Insights リソースの接続文字列に設定します。

    setx APPLICATIONINSIGHTS_CONNECTION_STRING "applicationinsights-connection-string"

    PowerShell を使用する場合は、次のコマンドを実行します。

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

    macOS または Linux を使用する場合は、次のコマンドを実行します。

    export APPLICATIONINSIGHTS_CONNECTION_STRING='applicationinsights-connection-string'

テレメトリを収集する

アプリケーションをデプロイして、ユーザーからのテレメトリの収集を開始します。 その機能をテストするには、多数のテスト ユーザーを作成することで、ユーザー アクティビティをシミュレートできます。 各ユーザーにはそれぞれ異なるあいさつメッセージが表示され、ハートボタンをクリックして引用文に「いいね」することで、アプリケーションを操作できます。 ユーザー ベースが増えるにつれて、Azure App Configuration で収集されるテレメトリ データの量の増加を監視できます。 さらに、データをドリルダウンして、機能フラグの各バリアントがユーザーの動作に与える影響を分析できます。

その他のリソース

  • Last updated on