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

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

[前提条件]

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

  1. pip を使用して必要なパッケージをインストールします。

    pip install azure-appconfiguration-provider
pip install featuremanagement["AzureMonitor"]
pip install azure-monitor-opentelemetry

  2. app.pyを開き、Application Insights に接続してテレメトリ データを発行するようにアプリケーションを構成します。 次のコードに示すfrom flask import Flask呼び出しの後に、既存の configure_azure_monitor(...) import ステートメントが表示されていることを確認します。 OpenTelemetry の自動インストルメンテーションが正常に動作するには、この順序が必要です。

    import os
from azure.monitor.opentelemetry import configure_azure_monitor

# Configure Azure Monitor
configure_azure_monitor(connection_string=os.getenv("APPLICATIONINSIGHTS_CONNECTION_STRING"))

  3. また、app.py の中で App Configuration から機能フラグを機能管理の中に読み込みます。 FeatureManager では、 publish_telemetry コールバック関数を使用して Azure Monitor にテレメトリを発行します。

    from featuremanagement.azuremonitor import publish_telemetry

feature_manager = FeatureManager(config, on_feature_evaluated=publish_telemetry)

  4. routes.pyを開き、アプリケーション内の独自のイベントを追跡するようにコードを更新します。 track_eventが呼び出されると、指定されたユーザーと共にカスタム イベントが Azure Monitor に発行されます。

    from featuremanagement import track_event
from flask import jsonify

@bp.route("/heart", methods=["POST"])
def heart():
    if current_user.is_authenticated:
        user = current_user.username

        # Track the appropriate event based on the action
        track_event("Liked", user)
    return jsonify({"status": "success"})

  5. index.html開き、同様のボタンを実装するようにコードを更新します。 like ボタンをクリックすると、 /heart エンドポイントに POST 要求が送信されます。

    <script>
    function heartClicked(button) {
        var icon = button.querySelector('i');

        // Toggle the heart icon appearance
        icon.classList.toggle('far');
        icon.classList.toggle('fas');

        // Only send a request to the dedicated heart endpoint when it's a like action
        if (icon.classList.contains('fas')) {
            fetch('/heart', {
                method: 'POST',
                headers: {
                    'Content-Type': 'application/json',
                }
            });
        }
    }
</script>

アプリをビルドして実行する

  1. Application Insights リソースに接続するには、接続文字列が必要です。 APPLICATIONINSIGHTS_CONNECTION_STRING環境変数を Application Insights リソースの接続文字列に設定します。 接続文字列を見つけるには、Azure ポータルを開き、Application Insights に移動し、先ほど作成した Application Insights リソースを選択して、[概要] に移動します。 接続文字列の値をコピー します。 次のコマンドのプレースホルダーの値を、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