在 Python 应用程序中为功能标志启用遥测

在本教程中，你将在 Python 应用程序中使用遥测来跟踪功能标志评估和自定义事件。 遥测允许你对功能管理策略做出明智的决策。 利用功能标志，并在启用功能标志的遥测概述中启用遥测。 在继续作之前，请确保在配置存储中创建一个名为 Greeting 的功能标志，并启用遥测。 本教程基于在 Python 应用程序中使用变体功能标志的教程为基础。

先决条件

• 启用功能标志的遥测中启用了遥测的变体功能标志。
• 在 Python 应用程序中使用变体功能标志中的应用程序。

将遥测添加到 Python 应用程序

1. 使用 pip 安装所需的包：

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

2. 打开 app.py 并配置代码以连接到 Application Insights 以发布遥测数据。

   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 中从应用程序配置加载功能标志并将其加载到功能管理中。 FeatureManagerpublish_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
   
   @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 按钮会将 POST 请求发送到 /heart 终结点。

   <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 需要连接字符串才能连接到 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'
   

2. 运行应用程序， 请参阅使用变体功能标志的步骤 2。

3. 创建 10 个不同的用户并登录到应用程序。 当你以每个用户是身份登录时，会收到不同的消息变体。 大约 50% 的时间不会收到消息。 25% 的时间会收到消息“你好!”，25% 的时间会收到“我希望这能让你开心!”。

4. 某些用户选择“ 赞 ”按钮以触发遥测事件。

5. 在 Azure 门户中打开 Application Insights 资源，然后选择“监视”下的“日志”。 在查询窗口中，运行以下查询以查看遥测事件：

   // Step 1: Get distinct users and their Variant from FeatureEvaluation
   let evaluated_users =
       customEvents
       | where name == "FeatureEvaluation"
       | extend TargetingId = tostring(customDimensions.TargetingId),
               Variant = tostring(customDimensions.Variant)
       | summarize Variant = any(Variant) by TargetingId;
   
   // Step 2: Get distinct users who emitted a "Like"
   let liked_users =
       customEvents
       | where name == "Liked"
       | extend TargetingId = tostring(customDimensions.TargetingId)
       | summarize by TargetingId;
   
   // Step 3: Join them to get only the evaluated users who also liked
   let hearted_users =
       evaluated_users
       | join kind=inner (liked_users) on TargetingId
       | summarize HeartedUsers = dcount(TargetingId) by Variant;
   
   // Step 4: Total evaluated users per variant
   let total_users =
       evaluated_users
       | summarize TotalUsers = dcount(TargetingId) by Variant;
   
   // Step 5: Combine results
   let combined_data =
       total_users
       | join kind=leftouter (hearted_users) on Variant
       | extend HeartedUsers = coalesce(HeartedUsers, 0)
       | extend PercentageHearted = strcat(round(HeartedUsers * 100.0 / TotalUsers, 1), "%")
       | project Variant, TotalUsers, HeartedUsers, PercentageHearted;
   
   // Step 6: Add total row
   let total_sum =
       combined_data
       | summarize
           TotalUsers = sum(TotalUsers),
           HeartedUsers = sum(HeartedUsers)
       | extend
           Variant = "All",
           PercentageHearted = strcat(round(HeartedUsers * 100.0 / TotalUsers, 1), "%")
       | project Variant, TotalUsers, HeartedUsers, PercentageHearted;
   
   // Step 7: Output
   combined_data
   | union (total_sum)
   
   

   

   每次加载引文页面时，你都会看到一个“FeatureEvaluation”，每次单击点赞按钮时，您都会看到一个“Liked”事件。 “FeatureEvaluation”事件具有一个自定义属性FeatureName，该属性的名称为已评估的功能标志。 这两个事件都有一个自定义 TargetingId 属性，其中包含喜欢引号的用户的名称。

其他资源

• Flask 每日一句示例