Tại sao nhật ký thông tin chức năng Azure bị thiếu trong không gian làm việc của nhật ký?

Khắc phục sự cố thiếu Nhật ký chức năng Azure trong Thông tin chi tiết về ứng dụng

Làm việc với Azure Functions thường có cảm giác giống như xây dựng một công cụ tự động hóa được bôi trơn tốt. Nhưng điều gì sẽ xảy ra khi một số nhật ký quan trọng biến mất khỏi không gian làm việc Thông tin chi tiết về ứng dụng của bạn? 🤔 Đó là một thách thức mà tôi gặp phải gần đây khi phát triển Chức năng Azure kích hoạt bộ đếm thời gian. Nhật ký cấp Thông tin của tôi vốn hoạt động hoàn hảo trong bảng điều khiển nhật ký Azure Portal, lại vắng mặt một cách bí ẩn trong Không gian làm việc Nhật ký.

Lúc đầu, tôi cho rằng mọi thứ đã được cấu hình chính xác. Rốt cuộc, tôi đã thiết lập Thông tin chi tiết về ứng dụng trong quá trình tạo Ứng dụng chức năng của mình và thiết lập đo từ xa dường như hoạt động tốt. Với tư cách là nhà phát triển, không có gì khó hiểu hơn việc thấy nhật ký Cảnh báo và Lỗi xuất hiện chính xác trong khi không tìm thấy nhật ký Thông tin. Họ đã trốn ở đâu?

Vấn đề này làm tôi nhớ đến khoảnh khắc tương tự khi gỡ lỗi một ứng dụng web. Nhật ký lỗi hét lên "Sửa tôi!" trong khi nhật ký cấp độ Thông tin tinh tế trượt dưới radar. Nó giống như việc tìm kiếm một mảnh ghép còn thiếu—biết nó tồn tại nhưng không hoàn toàn nhìn thấy nó trong đống. 🧩 host.json và cài đặt đo từ xa của Azure thường đóng một vai trò ở đây.

Trong bài viết này, tôi sẽ phân tích nguyên nhân cốt lõi của vấn đề này và cách giải quyết từng bước. Từ cấu hình Host.json đến xác minh ngưỡng cấp độ nhật ký, tôi sẽ hướng dẫn bạn giải pháp. Hãy đảm bảo những Nhật ký thông tin bị thiếu sẽ tìm được đường trở lại Không gian làm việc của Nhật ký của bạn.

Tìm hiểu về nhật ký chức năng Azure bị thiếu và cách giải quyết

Các tập lệnh được cung cấp trước đó nhằm mục đích giải quyết một vấn đề chung trong đó Nhật ký cấp thông tin do Hàm Azure tạo ra không xuất hiện trong không gian làm việc Nhật ký, mặc dù chúng hiển thị trong bảng điều khiển nhật ký Cổng thông tin Azure. Sự khác biệt này thường xảy ra do cấu hình trong tệp host.json không đúng, cài đặt đo từ xa không đầy đủ hoặc sự cố khi tích hợp Thông tin chi tiết về ứng dụng. Bằng cách sử dụng các lệnh như Cấu hìnhFunctionsWorkerDefaults() Và AddApplicationInsightsTelemetryWorkerService(), chúng tôi đảm bảo rằng Application Insights ghi lại nhật ký như mong đợi. Các tập lệnh này thiết lập nền tảng vững chắc cho việc thu thập và quản lý dữ liệu đo từ xa.

Đầu tiên, `HostBuilder` trong Program.cs thiết lập môi trường nhân viên Chức năng Azure. phương pháp Cấu hìnhFunctionsWorkerDefaults() đảm bảo rằng tất cả phần mềm trung gian cần thiết cho Chức năng Azure đều được khởi tạo. Nó cũng cho phép cấu hình ghi nhật ký và phụ thuộc tùy chỉnh. Tiếp theo, chúng tôi đăng ký rõ ràng Thông tin chi tiết về ứng dụng bằng cách sử dụng AddApplicationInsightsTelemetryWorkerService(). Bước này đảm bảo rằng việc thu thập dữ liệu đo từ xa được đặt cấu hình chính xác cho các Hàm Azure không được kích hoạt HTTP. Ví dụ: hãy tưởng tượng việc gỡ lỗi Chức năng kích hoạt hẹn giờ: Nếu không có Thông tin chi tiết về ứng dụng, việc theo dõi hiệu suất và xác định các vấn đề sẽ trở thành một quy trình thủ công và tốn thời gian. 🔧

Tệp host.json đóng vai trò chính trong việc kiểm soát mức nhật ký nào được ghi lại. Bằng cách đặt `LogLevel` thành Thông tin trong cả phần mặc định và phần Thông tin chi tiết về ứng dụng, chúng tôi xác định rõ ràng rằng nhật ký Cấp thông tin phải được xử lý. Tuy nhiên, thuộc tính samplingSettings đôi khi có thể lọc nhật ký, dẫn đến thiếu các mục trong không gian làm việc của Nhật ký. Bằng cách tắt tính năng lấy mẫu ("isEnabled": false`), chúng tôi đảm bảo tất cả dữ liệu đo từ xa, bao gồm cả Nhật ký thông tin, đều được ghi lại. Điều này đặc biệt quan trọng khi khắc phục sự cố sản xuất mà ngay cả những chi tiết nhỏ cũng có thể tiết lộ nguyên nhân gốc rễ. Tôi đã từng gặp phải tình huống trong đó một thông báo LogInformation nhỏ giúp phát hiện ra một bộ lập lịch bị định cấu hình sai. 🎯

Cuối cùng, tập lệnh kiểm thử đơn vị sẽ xác minh rằng nhật ký ở các cấp độ khác nhau—Thông tin, Cảnh báo và Lỗi—được phát và ghi lại chính xác. sử dụng SetMinimumLevel(), chúng tôi đảm bảo trình ghi nhật ký xử lý tất cả nhật ký ở hoặc trên ngưỡng mong muốn. Trong ví dụ của chúng tôi, chúng tôi đã xác thực rằng nhật ký Thông tin xuất hiện khi được định cấu hình rõ ràng. Việc viết các bài kiểm thử đơn vị như thế này đảm bảo rằng hành vi ghi nhật ký nhất quán giữa các môi trường, ngăn chặn những điều bất ngờ trong quá trình triển khai. Cùng với nhau, các tập lệnh này cung cấp giải pháp toàn diện để khắc phục sự cố thiếu nhật ký Chức năng Azure và tối ưu hóa việc thu thập dữ liệu đo từ xa trong các ứng dụng đám mây của bạn.

// 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.");
    }
}

Giải quyết các nhật ký chức năng Azure bị thiếu bằng cách khám phá dữ liệu đo từ xa

Một khía cạnh quan trọng khác của việc nhật ký Chức năng Azure không xuất hiện trong Không gian làm việc nhật ký liên quan đến cấu hình kênh đo từ xa được Application Insights sử dụng. Theo mặc định, Azure Functions sử dụng SDK Thông tin chi tiết về ứng dụng để đệm các nhật ký trước khi gửi chúng đến điểm cuối đo từ xa. Tuy nhiên, việc đệm này có thể trì hoãn hoặc bỏ qua một số mục nhật ký nhất định như Nhật ký cấp thông tin do lấy mẫu hoặc xóa dữ liệu đo từ xa không đúng cách. Đảm bảo hành vi kênh đo từ xa thích hợp là rất quan trọng để duy trì nhật ký nhất quán.

Một yếu tố thường bị bỏ qua là lấy mẫuCài đặt cấu hình trong host.json. Khi bật tính năng lấy mẫu, chỉ một phần nhật ký được gửi đến Thông tin chi tiết về ứng dụng để giảm khối lượng dữ liệu và chi phí. Tuy nhiên, nếu Nhật ký thông tin rất quan trọng cho việc gỡ lỗi, bạn phải tắt hoàn toàn tính năng lấy mẫu ("isEnabled": false`) hoặc điều chỉnh logic lấy mẫu để đảm bảo tất cả nhật ký cần thiết đều được ghi lại. Ví dụ: tôi gặp phải sự cố trong đó việc bật lấy mẫu khiến nhật ký Thông tin không quan trọng bị sụt giảm ngẫu nhiên, dẫn đến sự thất vọng trong quá trình gỡ lỗi sản xuất. 💻

Ngoài ra, sử dụng Tuôn ra các lệnh đảm bảo rằng tất cả dữ liệu đo từ xa được lưu vào bộ đệm sẽ được gửi ngay lập tức, tránh mất dữ liệu. Trong các trường hợp mà Chức năng Azure chạy trong trình kích hoạt tải cao như yêu cầu HTTP hoặc trình kích hoạt Bộ hẹn giờ, việc đệm dữ liệu đo từ xa có thể tích lũy nhanh chóng, gây ra sự chậm trễ. Bằng cách gọi rõ ràng TelemetryClient.Flush() hoặc xác minh kết nối điểm cuối đo từ xa, nhà phát triển có thể giảm sự không nhất quán trong nhật ký và duy trì môi trường giám sát chính xác. Cuối cùng, việc cân bằng việc lấy mẫu, đệm và xóa cho phép hiển thị nhật ký tối ưu đồng thời giảm thiểu chi phí.

Đảm bảo khả năng hiển thị nhật ký trong nhật ký chức năng Azure