{"time":1739517408648,"blocks":[{"id":"7YdgPIiPOj","type":"paragraph","data":{"text":"Логирование — один из ключевых инструментов для мониторинга и отладки .NET-приложений. Однако стандартные подходы к сбору и хранению логов могут незаметно снижать производительность системы. Избыточные записи в логах, блокирующие операции ввода-вывода, и неоптимальная работа с хранилищем данных — всё это может привести к задержкам и росту потребления ресурсов. В первой части нашей статьи разберём, какие проблемы могут возникнуть при стандартном логировании в .NET и почему бездумное использование логов способно замедлить работу приложения."}},{"id":"U8Ci390y1B","type":"header2","data":{"text":"Зачем нужно логирование","level":2},"tunes":{}},{"id":"6dQGAFNgah","type":"paragraph","data":{"text":"Когда приложение уже в проде, а в нем что-то сломалось, подключиться отладчиком и просто пройтись по коду, чтобы разобраться в ошибке, не выйдет. В этом случае на помощь может прийти логирование — запись событий в журнал. Таким журналом могут быть:"}},{"id":"1XZg9zAeal","type":"list","data":{"style":"unordered","items":["консоль, ","обычный текстовый файл, ","системный журнал операционной системы, ","реляционная база данных,","специализированные средства, такие как Elastic. "]}},{"id":"2tTZ1TzutN","type":"paragraph","data":{"text":"В .NET есть встроенная поддержка логирования, доступная в пространстве имен Microsoft.Extensions.Logging. О том, как инициализировать логирование, можно почитать в документации. Скажем лишь, что в результате мы можем получить экземпляр ILogger — он предоставляет расширения, которые позволяют записывать события с различным уровнем серьезности (severity). Severity — атрибут, который определяет, насколько сильно дефект может повлиять на работу."}},{"id":"f580fe04-bc16-41a8-a5be-cd0dca461314","type":"banner-blank","data":{}},{"id":"XSQpi3nCVJ","type":"paragraph","data":{"text":"В высоконагруженных приложениях логирование может давать ощутимую нагрузку — как вычислительную, так и в части потребления памяти. Это происходит по следующим причинам:"}},{"id":"8ILuPOsDRC","type":"list","data":{"style":"unordered","items":["Методы расширения ILogger выполняют упаковку (boxing) значимых типов для преобразования их в object. Это верно для bool, int и др.;","Методы расширения ILogger выполняют разбор (parsing) шаблона сообщения каждый раз, когда вызывается соответствующий метод расширения."]}},{"id":"gqoVw0bKHn","type":"header3","data":{"text":"Как работает высокопроизводительное логирование","level":3},"tunes":{}},{"id":"g5MLcpEiFr","type":"paragraph","data":{"text":"Microsoft предлагает другой механизм записи сообщений в журнал — с помощью LoggerMessage. Этот класс позволяет избежать следующих проблем:"}},{"id":"jvG6SLUiid","type":"list","data":{"style":"unordered","items":["Проблема упаковки (boxing). Решается за счет перегруженных методов с обобщенными параметрами.","Проблема разбора шаблона сообщения. Решается так: разбор производится один раз в момент объявления специфического метода для записи сообщения."]}},{"id":"FDm94Lo0VJ","type":"paragraph","data":{"text":"Ниже покажем, как использовать LoggerMessage в приложении, и сравним его производительность с методами расширения ILogger из LoggerExtensions и типизированными методами из LoggerMessageExtensions."}},{"id":"IbDi8nV3s8","type":"paragraph","data":{"text":"Для начала создадим новый проект типа Console Application. Будем использовать фреймворк .Net9."}},{"id":"83jw-dL7ln","type":"paragraph","data":{"text":"После создания проекта нам нужно подключить следующие nuget-пакеты:"}},{"id":"Q0rES6MMU3","type":"code","data":{"code":"Microsoft.Extensions.Logging.Abstractions\nMicrosoft.Extensions.Logging\nMicrosoft.Extensions.Logging.Console","language":"clike","lineNumbers":false,"startLineNumber":1,"stretched":false}},{"id":"Xcw7MsBLdR","type":"paragraph","data":{"text":"Далее инстанцируем в приложении экземпляр ILogger:"}},{"id":"A-o0ogvTO_","type":"code","data":{"code":"using Microsoft.Extensions.Logging;\nusing ILoggerFactory loggerFactory = LoggerFactory.Create(builder => builder.AddConsole());\nILogger logger = loggerFactory.CreateLogger();","language":"csharp","lineNumbers":false,"startLineNumber":1,"stretched":false}},{"id":"htPD8WicGH","type":"paragraph","data":{"text":"При использовании LoggerMessage для каждого типа события нам нужно создать отдельный метод логирования. Для начала — написать статический класс, который будет выступать хранилищем (реестром сообщений). Добавим LoggerExtensions:"}},{"id":"Bn5vhygwJk","type":"code","data":{"code":"using Microsoft.Extensions.Logging;\nnamespace AutoLoggingNet9;\ninternal static class LoggerExtensions\n{\n static LoggerExtensions() { }\n}","language":"csharp","lineNumbers":false,"startLineNumber":1,"stretched":false}},{"id":"m28vP2iVUb","type":"paragraph","data":{"text":"Добавим метод для логирования старта приложения, сохраняя имя хоста. Метод должен соответствовать следующему делегату:"}},{"id":"2ODPeL1ET5","type":"code","data":{"code":"Action(LogLevel logLevel, EventId eventId, string formatString)","language":"csharp","lineNumbers":false,"startLineNumber":1,"stretched":false}},{"id":"YoYEE8xxiW","type":"paragraph","data":{"text":"Где:"}},{"id":"8G-tnSnxHu","type":"list","data":{"style":"unordered","items":["T1..T6 — обобщенные типы параметров, которые мы можем передать во время записи сообщения в журнал;","logLevel — уровень логирования (степень серьезности) события;","eventid — уникальный идентификатор события;","formatString — шаблон сообщения."]}},{"id":"Zpzs-jcxHO","type":"paragraph","data":{"text":"В классе LoggerExtensions для каждого лог-сообщения объявляем Action-делегат в приватном статическом поле. Экземпляр этого делегата инициализируем через LoggerMessage.Define в конструкторе — для его вызова нужно определить public-метод. Код для метода LogApplicationStart:"}},{"id":"syGq5KJz30","type":"code","data":{"code":"internal static class LoggerExtensions\n{\n private static readonly Action s_applicationStart;\n static LoggerExtensions()\n {\n s_applicationStart = LoggerMessage.Define(\n LogLevel.Information,\n new EventId(0, nameof(LogApplicationStart)),\n \"Application started on host '{HostName}'\"\n );\n }\n /// <summary>\n /// Записывает событие \"Старт приложения\"\n /// </summary>\n /// <param name=\"logger\">Экземпляр <see cref=\"ILogger\" /></param>\n /// <param name=\"hostName\">Имя хоста, где запущено приложение</param>\n public static void LogApplicationStart(this ILogger logger, string hostName) =>\n s_applicationStart(logger, hostName, null);\n}","language":"csharp","lineNumbers":false,"startLineNumber":1,"stretched":false}},{"id":"kclBwxySYX","type":"header2","data":{"text":"Как работает LoggerMessage.Define T","level":2},"tunes":{}},{"id":"zSk7qfBegV","type":"paragraph","data":{"text":"Давайте разберемся немного глубже и посмотрим, что же делает метод Define. Код метода для одного обобщенного параметра приведен ниже:"}},{"id":"27muw59A5I","type":"code","data":{"code":"public static Action Define(LogLevel logLevel, EventId eventId, string formatString, LogDefineOptions? options)\n{\n LogValuesFormatter formatter = CreateLogValuesFormatter(formatString, expectedNamedParameterCount: 1);\n\n void Log(ILogger logger, T1 arg1, Exception? exception)\n {\n logger.Log(logLevel, eventId, new LogValues(formatter, arg1), exception, LogValues.Callback);\n }\n \n if (options != null && options.SkipEnabledCheck)\n {\n return Log;\n }\n \n return (logger, arg1, exception) =>\n {\n if (logger.IsEnabled(logLevel))\n {\n Log(logger, arg1, exception);\n }\n };\n}","language":"csharp","lineNumbers":false,"startLineNumber":1,"stretched":false}},{"id":"Kl0pRKqxdX","type":"paragraph","data":{"text":"В первой строке метод CreateLogValuesFormatter разбирает шаблон сообщения и проверяет соответствие количества плейсхолдеров числу обобщённых параметров Define. Если не совпадает — возбуждается исключение."}},{"id":"oYkDI7zNS8","type":"paragraph","data":{"text":"Локальная функция Log вызывает ILogger.Log и записывает сообщение в журнал."}},{"id":"I25Te1wgwt","type":"paragraph","data":{"text":"Ниже идет проверка флага SkipEnabledCheck:"}},{"id":"wGda_ItRUF","type":"list","data":{"style":"unordered","items":["Если true, сообщение записывается без учёта объявленного уровня логирования.","Если false (или options не предоставлен), сначала проверяется уровень логирования. Если наше событие объявлено с уровнем, подлежащим записи, то будет произведен вызов функции Log."]}},{"id":"QIx_0y9s2_","type":"paragraph","data":{"text":"Выводы:"}},{"id":"D_c-qQmehc","type":"list","data":{"style":"ordered","items":["Результат метода, делегат Action, мы сохраняем в приватном статическом поле. То есть Define выполнится лишь один раз за время жизни приложения. То же самое и с разбором шаблона каждого сообщения.","Делегат проверяет уровень логирования, исключая ненужные вызовы ILogger.Log — это повышает производительность.","Наличие параметров Define и делегатов Action позволяет избежать упаковки значимых типов — это снижает нагрузку на память и процессор."]}},{"id":"QpDiO9thse","type":"paragraph","data":{"text":"Добавим вызов этого метода в наше приложение:"}},{"id":"48DtJQg4dw","type":"code","data":{"code":"using AutoLoggingNet9;\nusing Microsoft.Extensions.Logging;\nusing System.Net;\n \nusing ILoggerFactory loggerFactory = LoggerFactory.Create(builder => builder.AddConsole());\n \nILogger logger = loggerFactory.CreateLogger();\n \nlogger.LogApplicationStart(Dns.GetHostName());","language":"csharp","lineNumbers":false,"startLineNumber":1,"stretched":false}},{"id":"kMkAw2_9xs","type":"paragraph","data":{"text":"Если запустить, то в консоли мы увидим такой вывод:"}},{"id":"9JMUBn2p5-","type":"image","data":{"alt":"","title":"","caption":"","file":{"id":45615,"url":"https://media.tproger.ru/user-uploads/101078/2025-01-30/fdfdb0e8-6e51-4f4d-b721-c3549e2ce59b.png"},"stretched":false,"withBackground":false,"withBorder":false,"width":904,"height":178,"optimizedFile":{"original":"https://media.tproger.ru/user-uploads/101078/2025-01-30/fdfdb0e8-6e51-4f4d-b721-c3549e2ce59b.png","alt":"Часть 1: Почему стандартное логирование может тормозить .NET-приложения 1","dimensions":{"width":904,"height":178},"additionalSizes":{"srcSet":[{"url":"https://tproger.ru/signed_image/2F7LRCuS2-bPVQgKYjwyaVSwV6cqJwMtazvOmK1-ctk/rs:fill:766:0:true/cb:vimg_2/f:webp/aHR0cHM6Ly9tZWRpYS50cHJvZ2VyLnJ1L3VzZXItdXBsb2Fkcy8xMDEwNzgvMjAyNS0wMS0zMC9mZGZkYjBlOC02ZTUxLTRmNGQtYjcyMS1jMzU0OWUyY2U1OWIucG5n","dpr":1,"width":766},{"url":"https://tproger.ru/signed_image/cy8pnr0g8tFdeY8sahbTFCSLJ2wwn4LGe3PSyJf4MlI/rs:fill:1532:0:true/cb:vimg_2/f:webp/aHR0cHM6Ly9tZWRpYS50cHJvZ2VyLnJ1L3VzZXItdXBsb2Fkcy8xMDEwNzgvMjAyNS0wMS0zMC9mZGZkYjBlOC02ZTUxLTRmNGQtYjcyMS1jMzU0OWUyY2U1OWIucG5n","dpr":1,"width":1532},{"url":"https://tproger.ru/signed_image/mkz6Uv2OPSsOaGh7eF9UYYmy6iHM9V2hVzupRQK1wJA/rs:fill:686:0:true/cb:vimg_2/f:webp/aHR0cHM6Ly9tZWRpYS50cHJvZ2VyLnJ1L3VzZXItdXBsb2Fkcy8xMDEwNzgvMjAyNS0wMS0zMC9mZGZkYjBlOC02ZTUxLTRmNGQtYjcyMS1jMzU0OWUyY2U1OWIucG5n","dpr":1,"width":686},{"url":"https://tproger.ru/signed_image/_VP7oNHMbGJ9e_ui_DS1Jevh-JUGShysNJ5PuJC3TW0/rs:fill:1372:0:true/cb:vimg_2/f:webp/aHR0cHM6Ly9tZWRpYS50cHJvZ2VyLnJ1L3VzZXItdXBsb2Fkcy8xMDEwNzgvMjAyNS0wMS0zMC9mZGZkYjBlOC02ZTUxLTRmNGQtYjcyMS1jMzU0OWUyY2U1OWIucG5n","dpr":1,"width":1372},{"url":"https://tproger.ru/signed_image/syuqZooAYPRj7oMzxIccMmvXqI5puHWcUbLgsFonCh4/rs:fill:636:0:true/cb:vimg_2/f:webp/aHR0cHM6Ly9tZWRpYS50cHJvZ2VyLnJ1L3VzZXItdXBsb2Fkcy8xMDEwNzgvMjAyNS0wMS0zMC9mZGZkYjBlOC02ZTUxLTRmNGQtYjcyMS1jMzU0OWUyY2U1OWIucG5n","dpr":1,"width":636},{"url":"https://tproger.ru/signed_image/wRpp3JyFk2QsHVlARBNqD3XrjKGnfs3pgCYFd8Jbfks/rs:fill:1272:0:true/cb:vimg_2/f:webp/aHR0cHM6Ly9tZWRpYS50cHJvZ2VyLnJ1L3VzZXItdXBsb2Fkcy8xMDEwNzgvMjAyNS0wMS0zMC9mZGZkYjBlOC02ZTUxLTRmNGQtYjcyMS1jMzU0OWUyY2U1OWIucG5n","dpr":1,"width":1272},{"url":"https://tproger.ru/signed_image/HBN6Y7GzDdW0AnXnN-4wSbfbvI4JMr7cbJBFYL-VIRM/rs:fill:466:0:true/cb:vimg_2/f:webp/aHR0cHM6Ly9tZWRpYS50cHJvZ2VyLnJ1L3VzZXItdXBsb2Fkcy8xMDEwNzgvMjAyNS0wMS0zMC9mZGZkYjBlOC02ZTUxLTRmNGQtYjcyMS1jMzU0OWUyY2U1OWIucG5n","dpr":1,"width":466},{"url":"https://tproger.ru/signed_image/ounNm_Lruw1yp5JF1hgLavVTJk74WdlcOMcRuTZogfk/rs:fill:932:0:true/cb:vimg_2/f:webp/aHR0cHM6Ly9tZWRpYS50cHJvZ2VyLnJ1L3VzZXItdXBsb2Fkcy8xMDEwNzgvMjAyNS0wMS0zMC9mZGZkYjBlOC02ZTUxLTRmNGQtYjcyMS1jMzU0OWUyY2U1OWIucG5n","dpr":1,"width":932}],"sizes":[{"media":"(min-width: 1441px)","size":"766px"},{"media":"(min-width: 1281px)","size":"686px"},{"media":"(min-width: 1281px)","size":"766px"},{"media":"(min-width: 961px)","size":"766px"},{"media":"(min-width: 671px)","size":"636px"},{"media":"(min-width: 500px)","size":"466px"}]}}}},{"id":"IkWS9Qmzi0","type":"paragraph","data":{"text":"Добавим сообщение, которые говорит об окончании работы приложения. В качестве параметра выводим в лог время выполнения. Вот основные изменения в LoggerExtensions:"}},{"id":"qOM_QFZ_L3","type":"code","data":{"code":"using Microsoft.Extensions.Logging;\n\nnamespace AutoLoggingNet9;\n\ninternal static partial class LoggerExtensions\n{\n /// <summary>\n /// Записывает событие \"Старт приложения\".\n /// </summary>\n /// <param name=\"logger\">Экземпляр <see cref=\"ILogger\" /></param>\n /// <param name=\"hostName\">Имя хоста, где запущено приложение</param>\n [LoggerMessage(EventId = 0, EventName = nameof(LogApplicationStart), Level = LogLevel.Information, Message = \"Application started on host '{HostName}'\")]\n public static partial void LogApplicationStart(this ILogger logger, string hostName);\n\n /// <summary>\n /// Записывает событие \"Приложение завершено\" с указанием времени, потребовавшегося на выполнение приложения.\n /// </summary>\n /// <param name=\"logger\">Экземпляр <see cref=\"ILogger\" /></param>\n /// <param name=\"elapsed\">Время, затраченное на выполнение приложения</param>\n [LoggerMessage(EventId = 1000, EventName = nameof(LogApplicationFinish), Level = LogLevel.Information, Message = \"Application is done. ElapsedTime: {Elapsed:g}\")]\n public static partial void LogApplicationFinish(this ILogger logger, TimeSpan elapsed);\n}\n","language":"csharp","lineNumbers":false,"startLineNumber":1,"stretched":false}},{"id":"LYxjfTW0UZ","type":"paragraph","data":{"text":"Выше добавили еще одно приватное поле, public-метод и код инициализации делегата."}},{"id":"c333923a-16d0-4f93-b6b0-297466ee66cb","type":"banner-blank","data":{}},{"id":"GefITfxRkm","type":"paragraph","data":{"text":"Вот обновленный код приложения:"}},{"id":"fsXX2-h_85","type":"code","data":{"code":"using AutoLoggingNet9;\nusing Microsoft.Extensions.Logging;\nusing System.Diagnostics;\nusing System.Net;\n \nusing ILoggerFactory loggerFactory = LoggerFactory.Create(builder => builder.AddConsole());\n \nILogger logger = loggerFactory.CreateLogger();\n \nlogger.LogApplicationStart(Dns.GetHostName());\n \nvar sw = Stopwatch.StartNew();\ntry\n{\n // Имитация выполнения работы приложения\n Thread.Sleep(2000);\n}\nfinally\n{\n sw.Stop();\n logger.LogApplicationFinish(sw.Elapsed);","language":"csharp","lineNumbers":false,"startLineNumber":1,"stretched":false}},{"id":"06_r6EbtIZ","type":"paragraph","data":{"text":"Вывод будет такой:"}},{"id":"ngvJOqE4Kf","type":"image","data":{"alt":"","title":"","caption":"","file":{"id":45616,"url":"https://media.tproger.ru/user-uploads/101078/2025-01-30/09e9b56e-d2bf-4730-bd92-94a0cbb78b59.png"},"stretched":false,"withBackground":false,"withBorder":false,"width":904,"height":238,"optimizedFile":{"original":"https://media.tproger.ru/user-uploads/101078/2025-01-30/09e9b56e-d2bf-4730-bd92-94a0cbb78b59.png","alt":"Часть 1: Почему стандартное логирование может тормозить .NET-приложения 2","dimensions":{"width":904,"height":238},"additionalSizes":{"srcSet":[{"url":"https://tproger.ru/signed_image/LJeBKJWeZro3gROb0N_4mlgZyiwCZFzsv7ivccxxQgs/rs:fill:766:0:true/cb:vimg_2/f:webp/aHR0cHM6Ly9tZWRpYS50cHJvZ2VyLnJ1L3VzZXItdXBsb2Fkcy8xMDEwNzgvMjAyNS0wMS0zMC8wOWU5YjU2ZS1kMmJmLTQ3MzAtYmQ5Mi05NGEwY2JiNzhiNTkucG5n","dpr":1,"width":766},{"url":"https://tproger.ru/signed_image/_qmjKgPmwubu1hySNj71I7Tm1OYOcrb8G5s6Yus8ejI/rs:fill:1532:0:true/cb:vimg_2/f:webp/aHR0cHM6Ly9tZWRpYS50cHJvZ2VyLnJ1L3VzZXItdXBsb2Fkcy8xMDEwNzgvMjAyNS0wMS0zMC8wOWU5YjU2ZS1kMmJmLTQ3MzAtYmQ5Mi05NGEwY2JiNzhiNTkucG5n","dpr":1,"width":1532},{"url":"https://tproger.ru/signed_image/0vJyAdRu7jenMOnsD9X5rdXX8nYa3IlEhB06HPk1WJ4/rs:fill:686:0:true/cb:vimg_2/f:webp/aHR0cHM6Ly9tZWRpYS50cHJvZ2VyLnJ1L3VzZXItdXBsb2Fkcy8xMDEwNzgvMjAyNS0wMS0zMC8wOWU5YjU2ZS1kMmJmLTQ3MzAtYmQ5Mi05NGEwY2JiNzhiNTkucG5n","dpr":1,"width":686},{"url":"https://tproger.ru/signed_image/_YoH2IPdszfETLlnHv2mJRgeyxrJDzp4lISMunqObbo/rs:fill:1372:0:true/cb:vimg_2/f:webp/aHR0cHM6Ly9tZWRpYS50cHJvZ2VyLnJ1L3VzZXItdXBsb2Fkcy8xMDEwNzgvMjAyNS0wMS0zMC8wOWU5YjU2ZS1kMmJmLTQ3MzAtYmQ5Mi05NGEwY2JiNzhiNTkucG5n","dpr":1,"width":1372},{"url":"https://tproger.ru/signed_image/nWffcsW1SzaGywYTWACRlQJoKJ4a7zgCcmvNGTO_4vo/rs:fill:636:0:true/cb:vimg_2/f:webp/aHR0cHM6Ly9tZWRpYS50cHJvZ2VyLnJ1L3VzZXItdXBsb2Fkcy8xMDEwNzgvMjAyNS0wMS0zMC8wOWU5YjU2ZS1kMmJmLTQ3MzAtYmQ5Mi05NGEwY2JiNzhiNTkucG5n","dpr":1,"width":636},{"url":"https://tproger.ru/signed_image/heqgfAcwjyfWF4rlN4_VN3uhflmQGiOwGXnRyvtFAPY/rs:fill:1272:0:true/cb:vimg_2/f:webp/aHR0cHM6Ly9tZWRpYS50cHJvZ2VyLnJ1L3VzZXItdXBsb2Fkcy8xMDEwNzgvMjAyNS0wMS0zMC8wOWU5YjU2ZS1kMmJmLTQ3MzAtYmQ5Mi05NGEwY2JiNzhiNTkucG5n","dpr":1,"width":1272},{"url":"https://tproger.ru/signed_image/cp2BX6TDWxPrICcHTmzR8k8nH-MI_-xbRNv5GOqn5aA/rs:fill:466:0:true/cb:vimg_2/f:webp/aHR0cHM6Ly9tZWRpYS50cHJvZ2VyLnJ1L3VzZXItdXBsb2Fkcy8xMDEwNzgvMjAyNS0wMS0zMC8wOWU5YjU2ZS1kMmJmLTQ3MzAtYmQ5Mi05NGEwY2JiNzhiNTkucG5n","dpr":1,"width":466},{"url":"https://tproger.ru/signed_image/8GFo3TPcvJ48fj00cA_N38mSDXDdLjso5r_evBKLJY0/rs:fill:932:0:true/cb:vimg_2/f:webp/aHR0cHM6Ly9tZWRpYS50cHJvZ2VyLnJ1L3VzZXItdXBsb2Fkcy8xMDEwNzgvMjAyNS0wMS0zMC8wOWU5YjU2ZS1kMmJmLTQ3MzAtYmQ5Mi05NGEwY2JiNzhiNTkucG5n","dpr":1,"width":932}],"sizes":[{"media":"(min-width: 1441px)","size":"766px"},{"media":"(min-width: 1281px)","size":"686px"},{"media":"(min-width: 1281px)","size":"766px"},{"media":"(min-width: 961px)","size":"766px"},{"media":"(min-width: 671px)","size":"636px"},{"media":"(min-width: 500px)","size":"466px"}]}}}},{"id":"e65jdd1NPN","type":"paragraph","data":{"text":"Резюмируем, что нужно сделать с LoggerMessage для каждого события:"}},{"id":"ZODKrwY0EO","type":"list","data":{"style":"unordered","items":["Добавить в статический класс приватное поле для сохранения ссылки на делегат. ","Определить публичный метод расширения. ","Добавить инициализацию делегата в конструктор статического класса."]}},{"id":"pRtNwDfTO3","type":"paragraph","data":{"text":"Это кажется сложнее, чем обычные методы ILogger. К счастью, есть LoggerMessageAttribute, который позволяет уменьшить объем работы."}},{"id":"ACr2zDWO56","type":"header2","data":{"text":"Как упростить переход на высокопроизводительное логирование в .NET","level":2},"tunes":{}},{"id":"cdZnDepf9l","type":"paragraph","data":{"text":"С LoggerMessageAttribute, для объявления метода расширения, нужно сделать следующее:"}},{"id":"1d7ZBWtxWe","type":"list","data":{"style":"unordered","items":["Пометить класс с методами расширения директивой partial — объявить класс частичным;","Объявить публичный метод расширения — тоже частичный;","Декорировать этот метод атрибутом LoggerMessageAttribute."]}},{"id":"_k6A-agltW","type":"paragraph","data":{"text":"Это приведет к тому, что во время компиляции сработает механизм перехватчика, который сгенерирует весь необходимый код за нас. Вот обновленный код класса LoggerExtensions:"}},{"id":"UyX1HOxqjd","type":"code","data":{"code":"using Microsoft.Extensions.Logging;\n \nnamespace AutoLoggingNet9;\n \ninternal static partial class LoggerExtensions\n{\n /// \n /// Записывает событие \"Старт приложения\".\n /// \n /// Экземпляр \n /// Имя хоста, где запущено приложение\n [LoggerMessage(EventId = 0, EventName = nameof(LogApplicationStart), Level = LogLevel.Information, Message = \"Application started on host '{HostName}'\")]\n public static partial void LogApplicationStart(this ILogger logger, string hostName);\n \n /// \n /// Записывает событие \"Приложение завершено\" с указанием времени, потребовавшегося на выполнение приложения.\n /// \n /// Экземпляр \n /// Время, затраченное на выполнение приложения\n [LoggerMessage(EventId = 1000, EventName = nameof(LogApplicationFinish), Level = LogLevel.Information, Message = \"Application is done. ElapsedTime: {Elapsed:g}\")]\n public static partial void LogApplicationFinish(this ILogger logger, TimeSpan elapsed);","language":"csharp","lineNumbers":false,"startLineNumber":1,"stretched":false}},{"id":"A2GPUjjzpM","type":"paragraph","data":{"text":"До момента компиляции Visual Studio будет показывать, что в коде есть ошибки — нужно дописать тела объявленных методов. Не пугайтесь: просто выполните сборку проекта и ошибки уйдут."}},{"id":"p5rv3XBmyt","type":"paragraph","data":{"text":"Что же делает этот атрибут? Давайте посмотрим на сгенерированный код:"}},{"id":"Df33kxsctP","type":"code","data":{"code":"[global::System.CodeDom.Compiler.GeneratedCodeAttribute(\"Microsoft.Extensions.Logging.Generators\", \"9.0.11.11010\")]\nprivate static readonly global::System.Action __LogApplicationFinishCallback =\n global::Microsoft.Extensions.Logging.LoggerMessage.Define(global::Microsoft.Extensions.Logging.LogLevel.Information, newglobal::Microsoft.Extensions.Logging.EventId(1000, \"LogApplicationFinish\"), \"Application is done. ElapsedTime: {Elapsed:g}\", newglobal::Microsoft.Extensions.Logging.LogDefineOptions() { SkipEnabledCheck = true }); \n \n[global::System.CodeDom.Compiler.GeneratedCodeAttribute(\"Microsoft.Extensions.Logging.Generators\", \"9.0.11.11010\")]\npublic static partial void LogApplicationFinish(this global::Microsoft.Extensions.Logging.ILogger logger, global::System.TimeSpan elapsed)\n{\n if (logger.IsEnabled(global::Microsoft.Extensions.Logging.LogLevel.Information))\n {\n __LogApplicationFinishCallback(logger, elapsed, null);\n }\n}","language":"clike","lineNumbers":false,"startLineNumber":1,"stretched":false}},{"id":"D3LSgxvY76","type":"paragraph","data":{"text":"Для каждого частичного метода будет сгенерировано:"}},{"id":"OskiLpw9uL","type":"list","data":{"style":"unordered","items":["Приватное поле для хранения ссылки на делегат. Имя поля начинается с двойного символа underscore(_), в этом случае называется __LogApplicationFinishCallback,","Код инициализации делегата,","Тело метода расширения."]}},{"id":"qFDhpXpc9G","type":"paragraph","data":{"text":"Метод проверяет уровень логирования: если событие уровня Debug, а минимальный уровень — Information, делегат не вызывается. Это улучшает производительность. А LoggerMessageAttribute упрощает создание методов расширения, снижая трудозатраты."}},{"id":"XCyTZ9EsQx","type":"paragraph","data":{"text":"В следующей статье мы сравним производительность стандартного логирования и LoggerMessage на реальных примерах, а также покажем, как легко оптимизировать код с помощью AutoLoggerMessage. Не переключайтесь!"}},{"id":"56ffc44e-6414-44b0-8669-87aa3a9aa774","type":"banner-blank","data":{}},{"id":"3SufHj37u2","type":"paragraph","data":{"text":"А если хотите больше узнать про .NET, сразу переходите в наш Telegram канал, это точно ускорит время ожидания! "}}],"version":"2.25.0"}

Ошибка в настройках сайта