Как начать собирать логи в Konso
Пошаговая инструкция: подключите Konso SDK к .NET-приложению и отправьте первый лог за 10 минут.
Открыть Konso arrow_forwardTL;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
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. Подходит для любого языка и платформы.
Следующий шаг: настройте алерты
После того как логи начали поступать, создайте первый алерт на 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