Как начать собирать логи в Konso

Шаг 1. Установите NuGet-пакет

В терминале из директории вашего проекта выполните: dotnet add package Konso.Client Или через Package Manager Console в Visual Studio: Install-Package Konso.Client [скриншот: терминал с командой dotnet add package и успешным результатом установки пакета]

Шаг 2. Добавьте API токен в конфигурацию

Откройте appsettings.json и добавьте секцию Konso: { "Konso": { "ApiKey": "ВАШ_API_ТОКЕН", "ProjectId": "ВАШ_PROJECT_ID" } } Важно: не коммитьте токен в репозиторий. Для production используйте переменные окружения или User Secrets: dotnet user-secrets set "Konso:ApiKey" "ВАШ_API_ТОКЕН" [скриншот: файл appsettings.json с добавленной секцией Konso]

Шаг 3. Зарегистрируйте провайдер логирования

Откройте Program.cs и добавьте Konso как провайдер логирования: var builder = WebApplication.CreateBuilder(args); builder.Logging.AddKonso(options => { options.ApiKey = builder.Configuration["Konso:ApiKey"]; }); // ... остальной код var app = builder.Build(); [скриншот: Program.cs с добавленной строкой builder.Logging.AddKonso] После этого все логи, которые ваше приложение отправляет через стандартный ILogger, будут автоматически попадать в Konso.

Шаг 4. Настройте уровни логирования

В appsettings.json добавьте конфигурацию уровней для Konso: { "Logging": { "LogLevel": { "Default": "Warning", "Konso": "Warning" }, "Konso": { "LogLevel": { "Default": "Warning", "YourApp.Namespace": "Information" } } } } [скриншот: appsettings.json с конфигурацией Logging.Konso.LogLevel] Рекомендация: в production начните с Warning и выше. Debug оставьте только для локальной разработки в appsettings.Development.json.

Шаг 5. Проверьте, что логи отправляются

Запустите приложение и вызовите любое действие, которое должно генерировать лог. Если в коде уже используется ILogger — никаких изменений не нужно: public class PaymentService { private readonly ILogger _logger; public PaymentService(ILogger logger) { _logger = logger; } public async Task ProcessPayment(decimal amount, string userId) { _logger.LogInformation("Payment started: userId={UserId}, amount={Amount}", userId, amount); // ... _logger.LogError("Payment failed for userId={UserId}", userId); } } [скриншот: код сервиса с ILogger — стандартный код без изменений]

Шаг 6. Откройте раздел Логи в Konso

Перейдите в Konso → ваш проект → раздел Логи. Через несколько секунд после запуска приложения вы увидите первые записи. [скриншот: раздел Логи в Konso с первыми записями от приложения, видны уровень, время, сообщение] Для каждой записи доступны: уровень, время, сообщение, имя категории (класс), а также все структурированные поля, которые вы передали в шаблон сообщения.

Шаг 7. Попробуйте поиск и фильтрацию

Убедитесь, что поиск работает корректно: • Введите название класса (например, PaymentService) в поле поиска — увидите только логи этого сервиса • Выберите уровень Error — отфильтруются только ошибки • Кликните на запись для просмотра деталей и структурированных полей [скриншот: интерфейс логов Konso с применённым фильтром по сервису и уровню, развёрнутая запись с деталями] Если логи появились и поиск работает — интеграция настроена успешно.