Туториал

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

Пошаговая инструкция: подключите Konso SDK к .NET-приложению и отправьте первый лог за 10 минут.

Открыть Konso arrow_forward
bolt

TL;DR

  • check_circleУстановите NuGet-пакет Konso.Client и зарегистрируйте провайдер логирования в Program.cs
  • check_circleAPI токен получите в Настройки → API доступ вашего проекта
  • check_circleИспользуйте стандартный ILogger — код приложения менять не нужно
  • check_circleУровни логирования настраиваются в appsettings.json, как и для любого другого провайдера
  • check_circleЛоги появятся в разделе Логи в Konso через несколько секунд после запуска

Что понадобится перед началом

Для подключения нужны: аккаунт Konso, созданный проект и API токен. Если проекта ещё нет — создайте его в интерфейсе Konso. Если токена нет — получите его в настройках проекта.

Предварительные требования

  • check_circleАккаунт Konso — зарегистрируйтесь на app.konso.io
  • check_circleСозданный проект в Konso (раздел Проекты → Создать проект)
  • check_circleAPI токен проекта (Настройки → API доступ) — см. туториал «Как получить API токен»
  • check_circle.NET 6+ приложение с ASP.NET Core или Worker Service

Шаг 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<PaymentService> 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 с применённым фильтром по сервису и уровню, развёрнутая запись с деталями]

Если логи появились и поиск работает — интеграция настроена успешно.

Альтернатива: отправка логов через REST API

Если ваше приложение написано не на .NET, используйте прямую отправку через REST API. Подходит для любого языка и платформы.

tips_and_updates

Следующий шаг: настройте алерты

После того как логи начали поступать, создайте первый алерт на Error-уровень. Это позволит получать уведомления о проблемах сразу — не узнавая о них постфактум от пользователей.

Что сделать после подключения

  • check_circleУбедитесь, что correlationId прокидывается через все слои приложения — для диагностики инцидентов
  • check_circleДобавьте userId в контекст логов для запросов, требующих аутентификации
  • check_circleНастройте appsettings.Production.json с уровнем Warning для большинства модулей
  • check_circleСоздайте алерт на критические ошибки (level = Critical) с уведомлением в Telegram или Email
  • check_circleПроверьте, что Debug-логи выключены в production

Ваши логи уже в Konso?

Подключите Konso и получите полный мониторинг приложения с поиском, фильтрацией и алертами

Начать бесплатно arrow_forward

Частые вопросы

Konso SDK совместим с .NET 6, 7, 8, 9? expand_more

Да, Konso.Client поддерживает .NET 6 и выше. Пакет совместим с ASP.NET Core, Worker Service и Console Application.

Логи отправляются синхронно или асинхронно? expand_more

Konso SDK буферизует логи и отправляет их асинхронно батчами. Это не блокирует основной поток приложения и минимально влияет на latency.

Что произойдёт, если Konso недоступен? expand_more

SDK имеет встроенную очередь и retry-логику. При временной недоступности сервиса логи буферизуются локально и отправляются при восстановлении соединения. При превышении размера буфера старые записи удаляются.

Можно ли использовать Konso вместе с другими провайдерами логирования? expand_more

Да, builder.Logging.AddKonso() добавляет Konso как дополнительный провайдер — наряду с Console, Debug или любым другим. Все провайдеры получают одни и те же записи.

Как логировать из фонового сервиса (BackgroundService / HostedService)? expand_more

Точно так же через ILogger. Зарегистрируйте Konso в builder.Logging при настройке хоста — и все логи из BackgroundService автоматически попадут в Konso.