为什么日志工作区中缺少 Azure 函数信息日志？

对 Application Insights 中缺少 Azure 函数日志进行故障排除

使用 Azure Functions 通常感觉就像构建一个运转良好的自动化引擎。但是，当一些关键日志从您的 Application Insights 工作区消失时会发生什么？ 🤔 这是我最近在开发 定时器触发器 Azure Function 时面临的挑战。我的信息级日志在 Azure 门户日志控制台中运行良好，但在 日志工作区 中却神秘地消失了。

起初，我假设一切都配置正确。毕竟，我在创建 Function App 期间设置了 Application Insights，并且遥测设置似乎可以开箱即用。作为开发人员，没有什么比看到 警告 和 错误 日志正确显示而信息日志却无处可寻更令人困惑的了。他们躲在哪里？

这个问题让我想起了调试 Web 应用程序时的类似时刻。错误日志尖叫着“修复我！”而微妙的信息级日志却被雷达忽视了。这有点像寻找一块丢失的拼图——知道它存在，但在一堆拼图中却看不到它。 🧩 Azure 的 host.json 和遥测设置通常在这里发挥作用。

在这篇文章中，我将分解这个问题的根本原因以及如何逐步解决它。从 host.json 配置 到验证日志级别阈值，我将指导您完成解决方案。让我们确保那些丢失的信息日志找到回到您的日志工作区的方式。

命令	使用示例
ConfigureFunctionsWorkerDefaults()	初始化并配置 Azure Functions 工作线程管道。它确保为 Azure Functions 执行正确设置中间件和服务。
Configure<LoggerFilterOptions>()	用于根据日志级别（例如信息、警告或错误）过滤日志。这可确保仅处理所需的日志级别。
services.AddApplicationInsightsTelemetryWorkerService()	为工作人员服务注册 Application Insights。它可以在非 HTTP 触发的上下文中专门针对 Azure Functions 进行遥测收集和日志记录。
options.MinLevel = LogLevel.Information	设置最小日志级别阈值。例如，“信息”可确保捕获信息、警告和错误级别的日志。
ConfigureServices()	提供添加自定义服务或配置依赖项的方法，例如日志记录、Application Insights 或任何 DI 容器相关组件。
samplingSettings: { isEnabled: false }	禁用遥测采样以确保捕获所有日志（包括信息级日志）而不被过滤掉。
host.Run()	执行配置的主机以运行 Azure Functions 工作进程并开始侦听传入事件或触发器。
builder.SetMinimumLevel(LogLevel.Information)	显式设置记录器配置的最低日志级别，以确保处理信息级别及以上级别的详细日志。
Assert.True(condition, message)	在单元测试中用于验证条件是否正确。在这种情况下，它验证信息日志是否已成功捕获。
LogInformation("Message")	记录信息性消息。这对于调试和监视 Azure Functions 中的非关键活动至关重要。

了解丢失的 Azure Function 日志以及如何解决它

前面提供的脚本旨在解决一个常见问题： 由 Azure 函数生成的内容不会出现在日志工作区中，即使它们显示在 Azure 门户日志控制台中也是如此。出现这种差异的原因通常是 host.json 文件中的配置不正确、遥测设置不足或 Application Insights 集成问题。通过使用类似的命令 和 ，我们确保 Application Insights 按预期捕获日志。这些脚本为收集和管理遥测数据奠定了坚实的基础。

首先，Program.cs 中的“HostBuilder”设置 Azure Function 工作线程环境。方法 确保 Azure Functions 所需的所有中间件均已初始化。它还允许自定义日志记录和依赖项注入配置。接下来，我们使用 AddApplicationInsightsTelemetryWorkerService() 显式注册 Application Insights。此步骤可确保为非 HTTP 触发的 Azure Functions 正确配置遥测收集。例如，想象一下调试计时器触发功能：如果没有 Application Insights，跟踪性能和识别问题将成为一个手动且耗时的过程。 🔧

host.json 文件在控制捕获的日志级别方面发挥着关键作用。通过在默认部分和 Application Insights 部分中将“LogLevel”设置为“信息”，我们明确定义必须处理信息级日志。但是，samplingSettings 属性有时会过滤掉日志，导致日志工作区中缺少条目。通过禁用采样（`"isEnabled": false`），我们确保捕获所有遥测数据，包括信息日志。这在解决生产问题时尤其重要，因为即使是很小的细节也可能揭示根本原因。我曾经遇到过这样的情况：一条小的 LogInformation 消息帮助发现了配置错误的调度程序。 🎯

最后，单元测试脚本验证不同级别的日志（信息、警告和错误）是否已正确发出和捕获。使用 ，我们确保记录器处理等于或高于所需阈值的所有日志。在我们的示例中，我们验证了显式配置时信息日志是否会出现。编写这样的单元测试可确保日志记录行为在各个环境中保持一致，从而防止部署期间出现意外。这些脚本共同提供了一个全面的解决方案，用于解决缺少的 Azure Function 日志问题并优化云应用程序中的遥测收集。

// Solution 1: Proper Host Configuration and Log Filtering
using Microsoft.Extensions.Hosting;
using Microsoft.Extensions.DependencyInjection;
using Microsoft.Extensions.Logging;
public class Program
{
    public static void Main(string[] args)
    {
        var host = new HostBuilder()
            .ConfigureFunctionsWorkerDefaults()
            .ConfigureServices(services =>
            {
                services.AddApplicationInsightsTelemetryWorkerService();
                services.Configure<LoggerFilterOptions>(options =>
                {
                    options.MinLevel = LogLevel.Information;
                });
            })
            .Build();
        host.Run();
    }
}

// host.json Configuration
{
  "version": "2.0",
  "logging": {
    "LogLevel": {
      "Default": "Information",
      "Microsoft": "Warning",
      "Function": "Information"
    },
    "applicationInsights": {
      "LogLevel": {
        "Default": "Information"
      },
      "samplingSettings": {
        "isEnabled": false
      }
    }
  }
}

using Microsoft.Extensions.Logging;
public class MyFunction
{
    private readonly ILogger _logger;
    public MyFunction(ILoggerFactory loggerFactory)
    {
        _logger = loggerFactory.CreateLogger<MyFunction>();
    }
    public void Run()
    {
        _logger.LogInformation("Executing Information level log.");
        _logger.LogWarning("This is a Warning level log.");
        _logger.LogError("This is an Error level log.");
    }
}

using Xunit;
using Microsoft.Extensions.Logging;
public class LogTests
{
    [Fact]
    public void VerifyInformationLogsAreCaptured()
    {
        var loggerFactory = LoggerFactory.Create(builder =>
        {
            builder.AddConsole();
            builder.SetMinimumLevel(LogLevel.Information);
        });
        var logger = loggerFactory.CreateLogger("TestLogger");
        logger.LogInformation("This is a test Information log.");
        Assert.True(true, "Information log captured successfully.");
    }
}

通过探索遥测数据解决丢失的 Azure 函数日志

Azure Function 日志未出现在 日志工作区 中的另一个关键方面涉及 Application Insights 使用的 遥测通道 配置。默认情况下，Azure Functions 使用 Application Insights SDK，该 SDK 在将日志发送到遥测终结点之前对其进行缓冲。然而，由于遥测数据的采样或刷新不当，这种缓冲可能会延迟或忽略某些日志条目，例如信息级日志。确保正确的遥测通道行为对于维护一致的日志至关重要。

一个经常被忽视的因素是 host.json 中的配置。启用采样后，仅将一小部分日志发送到 Application Insights，以减少数据量和成本。但是，如果信息日志对于调试至关重要，则必须完全禁用采样（`"isEnabled": false`）或调整采样逻辑以确保捕获所有必要的日志。例如，我遇到了一个问题，启用采样会导致非关键信息日志随机下降，从而导致生产调试过程中的挫败感。 💻

此外，使用 命令确保立即发送所有缓冲的遥测数据，避免数据丢失。在 Azure Functions 在 HTTP 请求或计时器触发器等高负载触发器下运行的情况下，遥测缓冲可能会快速累积，从而导致延迟。通过显式调用 TelemetryClient.Flush() 或验证遥测端点连接，开发人员可以减少日志不一致并维护准确的监控环境。最终，平衡采样、缓冲和刷新可以实现最佳的日志可见性，同时最大限度地降低成本。

1. 为什么“日志”工作区中缺少我的信息日志？
2. 由于以下原因，信息日志可能不会出现 在 。禁用采样 捕获所有日志。
3. host.json 中的 LogLevel 配置有什么作用？
4. 这 指定捕获的最小日志严重性，例如 ，确保处理该级别或更高级别的日志。
5. 如何确保遥测数据刷新到 Application Insights？
6. 使用 函数代码中的方法强制所有缓冲的遥测立即发送。
7. 为什么警告和错误日志可见，但信息日志不可见？
8. 当 配置错误或 由于优化而删除信息日志。
9. 我可以调整采样逻辑以包含特定日志吗？
10. 是的，您可以自定义 下的财产 排除特定的遥测类型，例如 或者 Exception。
11. AddApplicationInsightsTelemetryWorkerService() 的作用是什么？
12. 这 方法在 Azure Functions 中注册 Application Insights 以进行遥测。
13. 如何验证 Application Insights 是否已正确链接？
14. 在 Application Insights 设置下检查 Function App 配置中的 Instrumentation Key 或 Connection String。
15. 我可以以编程方式记录信息级消息吗？
16. 是的，您可以使用 在函数代码中显式记录信息消息的方法。
17. 如何解决计时器触发器功能中丢失日志的问题？
18. 验证 配置，确保遥测已连接，然后调用 在函数的末尾。
19. ConfigureFunctionsWorkerDefaults() 的作用是什么？
20. 这 方法初始化 Azure Functions 中间件并设置日志记录。

确保 Azure 函数日志中的日志可见性

确保 Azure Functions 中正确的日志可见性需要仔细配置 host.json 和正确的遥测设置。诸如此类的问题 默认日志级别阈值可能会导致日志丢失，即使数据出现在门户控制台中也是如此。显式禁用采样并调用遥测刷新方法通常可以解决此问题。

此外，验证 Application Insights 是否已正确连接并确保两者中的日志级别适当 并且配置文件至关重要。通过这些调整，信息日志将可靠地显示在日志工作区中，从而提供对 Azure Function 行为的清晰洞察。 🛠️