azure - 将元数据添加到 Azure 函数中的跟踪

Question

我有一个 Azure 函数(.NET core 2.0)，它在 ADO 存储库中的每个 PR 上运行。我想将 PR-ID 作为元数据添加到 Azure 函数记录的每个跟踪中。(我正在使用 Azure 应用程序洞察实例中的 traces 表查看日志)

Azure 函数通过以下方式记录跟踪:

public static async Task<HttpResponseMessage> Run([HttpTrigger(AuthorizationLevel.Function, "post", Route = null)]HttpRequestMessage req, ILogger log, ExecutionContext context)
{
  logger.LogInformation("Trace Message");
}

如何向每个跟踪添加额外的元数据？

Answer 1

是的，这是可能的。

选项 1:在 AsyncLocal 的帮助下使用遥测初始化程序:

    public class CustomTelemetryInitializer : ITelemetryInitializer
    {
        public static AsyncLocal<string> MyValue = new AsyncLocal<string>();

        public void Initialize(ITelemetry telemetry)
        {
            if (telemetry is ISupportProperties propertyItem)
            {
                propertyItem.Properties["myProp"] = MyValue.Value;
            }
        }
    }

您可以在函数中设置 AsyncLocal 的值，如下所示:

        [FunctionName("Function")]
        public static async Task<IActionResult> Run(
            [HttpTrigger(AuthorizationLevel.Function, "get", "post", Route = null)]
            HttpRequest req,
            ILogger log)
        {
            var name = req.Query["name"];

            CustomTelemetryInitializer.MyValue.Value = name;

            log.LogInformation("C# HTTP trigger function processed a request.");

            return new OkObjectResult($"Hello, {name}");
        }

当您运行该函数时，您可以在门户中看到信息:

您可以在 this repo 找到完整代码

现在，处理您的评论。是的，你需要一些额外的东西。 ITelemetryInitializer 实例需要使用依赖注入(inject)来注册。这是在 Startup 类中完成的，如 documentation 中所述。 :

    using Microsoft.ApplicationInsights.Extensibility;
    using Microsoft.Azure.Functions.Extensions.DependencyInjection;
    using Microsoft.Extensions.DependencyInjection;

    [assembly: FunctionsStartup(typeof(FunctionApp.Startup))]

    namespace FunctionApp
    {
        public class Startup : FunctionsStartup
        {
            public override void Configure(IFunctionsHostBuilder builder)
            {
                builder.Services.AddSingleton<ITelemetryInitializer, CustomTelemetryInitializer>();
                builder.Services.AddLogging();
            }
        }
    }

注册后，Application Insights SDK 将使用 CustomTelemetryInitializer。

选项 2另一个选项不涉及任何 TelemetryInitializer，但只能将属性添加到由 Azure Function App Insights 集成添加的生成的 RequestTelemetry。这是通过利用当前 TelemetryRequest 存储在 HttpContext 中的事实来完成的:

       [FunctionName("Function")]
        public static IActionResult Run(
            [HttpTrigger(AuthorizationLevel.Function, "get", "post", Route = null)]
            HttpRequest req,
            ILogger log)
        {
            var name = req.Query["name"];

            CustomTelemetryInitializer.MyValue.Value = name;

            log.LogInformation("C# HTTP trigger function processed a request.");

            var telemetryItem = req.HttpContext.Features.Get<RequestTelemetry>();
            telemetryItem.Properties["SetInFunc"] = name;

            return new OkObjectResult($"Hello, {name}");
        }

这也会显示在门户中:

仅在Request中添加上下文有问题吗？可能会，但请注意，您可以查询所有相关的遥测数据并了解涉及的上下文，例如:

union (traces), (requests), (dependencies), (customEvents), (exceptions)
| extend itemType = iif(itemType == 'availabilityResult',itemType,iif(itemType == 'customEvent',itemType,iif(itemType == 'dependency',itemType,iif(itemType == 'pageView',itemType,iif(itemType == 'request',itemType,iif(itemType == 'trace',itemType,iif(itemType == 'exception',itemType,"")))))))
| extend prop = customDimensions.SetInFunc
| where ((itemType == 'trace' or (itemType == 'request' or (itemType == 'pageView' or (itemType == 'customEvent' or (itemType == 'exception' or (itemType == 'dependency' or itemType == 'availabilityResult')))))))
| top 101 by timestamp desc

将显示:

来自同一调用的所有遥测数据都将具有相同的 operation_Id。