REFERENCE / HTTP API
От кода к событию
Logger - это сервис для централизованного сбора и просмотра логов в реальном времени. Отправляйте логи из любого приложения через простой REST API и наблюдайте за ними в веб-интерфейсе.
Аутентификация
Для отправки логов вам понадобится Consumer Key. Получить его можно после регистрации в веб-интерфейсе.
Consumer Key - уникальный идентификатор вашего приложения. Отображается в профиле пользователя после входа.
Отправка логов
POST
/sendmess
Отправка лог-сообщения на сервер
Параметры запроса
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
key |
string | Да | Consumer key, полученный при регистрации |
mess |
any | Да | Сообщение для логирования (строка, число, объект, массив) |
module |
string | Нет | Название модуля/компонента, отправившего лог |
mode |
string | Нет | Режим отображения: regular (по умолчанию) или light |
Примеры запросов на разных языках
Подробные руководства с интеграцией в популярные логгеры (logging в Python, winston в Node.js, Monolog в PHP, log/slog в Go, java.util.logging) собраны в разделе Интеграции: Python, Node.js, JavaScript, PHP, Go, Java.
curl -X POST https://logger.dp-projects.ru/sendmess \
-H "Content-Type: application/json" \
-d '{
"key": "ваш-consumer-key",
"module": "payment-service",
"mess": {
"event": "payment_processed",
"amount": 1000,
"currency": "RUB",
"status": "success"
},
"mode": "regular"
}'
Формат ответа
{
"status": "ok",
"message": "Message sent successfully",
"data": {
"module": "payment-service",
"msg": "{\n \"event\": \"payment_processed\",\n \"amount\": 1000,\n \"currency\": \"RUB\",\n \"status\": \"success\"\n}",
"mode": "regular",
"timestamp": "2024-01-15T10:30:00.000Z"
}
}
Примеры использования
Простой текст
{
"key": "ваш-consumer-key",
"module": "app",
"mess": "Пользователь вошел в систему",
"mode": "regular"
}
Числовые значения
{
"key": "ваш-consumer-key",
"module": "metrics",
"mess": {
"cpu_usage": 45.2,
"memory_used": 1024,
"connections": 150
},
"mode": "regular"
}
Массив данных
{
"key": "ваш-consumer-key",
"module": "batch-processor",
"mess": [
{"id": 1, "status": "processed"},
{"id": 2, "status": "failed"},
{"id": 3, "status": "pending"}
],
"mode": "light"
}
Коды ответов
| Код | Описание |
|---|---|
200 OK |
Лог успешно отправлен |
400 Bad Request |
Отсутствуют обязательные параметры |
401 Unauthorized |
Неверный consumer key |
500 Internal Server Error |
Внутренняя ошибка сервера |