DDevLogs
Начать
ОглавлениеБыстрый стартSDKКоллекторыGit-коммитIngest APIМиграция с SentryAPM / PerformanceSession ReplayOrganizations / RBACАлертыSource mapsNative symbolicationЛимитыFAQМатрица возможностейREST API

Документация

SDK

47 официальных клиентов: DSN, установка из реестра GitFlic, тестовая ошибка и просмотр Issues в кабинете.

v0.4.0 · 47 SDK · реестр GitFlic
Интерактивный каталог с командами установки для всех 47 SDK — на /sdk. В кабинете команды с вашим DSN — в блоке «Установка SDK» на странице настроек проекта.

Выбор SDK

Выберите пакет под ваш стек: язык, фреймворк (React, Laravel, NestJS…) или платформу (Unity, Godot). Все клиенты отправляют события на один Ingest API.

SDKПакетДоставкаВерсия
JavaScript / TypeScriptdevlogs-sdk-jsGitFlic Registry0.4.0
Go (Golang)devlogs-sdk-goGo / Golang (registry + git tag)0.4.0
Pythondevlogs-sdk-pythonGitFlic Registry0.4.0
PHPdevlogs-sdk-phpGitFlic Registry0.4.0
Rubydevlogs-sdk-rubyGitFlic Registry0.4.0
Rustdevlogs-sdk-rustGitFlic Registry0.4.0
Javadevlogs-sdk-javaGitFlic Registry0.4.0
C# / .NETdevlogs-sdk-dotnetGitFlic Registry0.4.0
Node.jsdevlogs-sdk-nodeGitFlic Registry0.4.0
React@devlogs/sdk-reactGitFlic Registry0.4.0
Next.js@devlogs/sdk-nextjsGitFlic Registry0.4.0
Vue@devlogs/sdk-vueGitFlic Registry0.4.0
Angular@devlogs/sdk-angularGitFlic Registry0.4.0
React Native@devlogs/sdk-react-nativeGitFlic Registry0.4.0
Svelte@devlogs/sdk-svelteGitFlic Registry0.4.0
NestJS@devlogs/sdk-nestjsGitFlic Registry0.4.0
Electron@devlogs/sdk-electronGitFlic Registry0.4.0
Edge (Workers / Deno)@devlogs/sdk-edgeGitFlic Registry0.4.0
Nuxt@devlogs/sdk-nuxtGitFlic Registry0.4.0
Remix@devlogs/sdk-remixGitFlic Registry0.4.0
Kotlindevlogs-sdk-kotlinGitFlic Registry0.4.0
Swiftdevlogs-sdk-swiftGit repositorygit
Dart / Flutterdevlogs-sdk-dartGit repositorygit
Elixirdevlogs-sdk-elixirGit repositorygit
Clojuredevlogs-sdk-clojureGit repositorygit
Haskelldevlogs-sdk-haskellGit repositorygit
Perldevlogs-sdk-perlGit repositorygit
Crystaldevlogs-sdk-crystalGit repositorygit
PowerShelldevlogs-sdk-powershellGit repositorygit
C / C++ (Native)devlogs-sdk-nativeGit repositorygit
Laraveldevlogs-sdk-laravelGitFlic Registry0.4.0
Symfonydevlogs-sdk-symfonyGitFlic Registry0.4.0
Railsdevlogs-sdk-railsGitFlic Registry0.4.0
Unitydevlogs-sdk-unityGit repositorygit
Unreal Enginedevlogs-sdk-unrealGit repositorygit
Godotdevlogs-sdk-godotGit repositorygit
Apple (Cocoa)devlogs-sdk-cocoaGit repositorygit
Capacitor / Ionic@devlogs/sdk-capacitorGitFlic Registry0.4.0
.NET MAUIdevlogs-sdk-mauiGitFlic Registry0.4.0
Expo (React Native)@devlogs/sdk-expoGitFlic Registry0.4.0
Spring Bootdevlogs-sdk-springGitFlic Registry0.4.0
Djangodevlogs-sdk-djangoGitFlic Registry0.4.0
Astro@devlogs/sdk-astroGitFlic Registry0.4.0
Tauridevlogs-sdk-tauriGitFlic Registry0.4.0
Android (native)devlogs-sdk-androidGitFlic Registry0.4.0
SolidJS@devlogs/sdk-solidGitFlic Registry0.4.0
WordPressdevlogs-sdk-wordpressGitFlic Registry0.4.0

Реестр GitFlic: git.melnikovit.ru/registry/package. Исходники: dev-logs-sdk.

Как получить DSN

  1. Войдите в личный кабинет на https://dev-logs.ru.
  2. Создайте проект или откройте существующий → перейдите в Настройки проекта (/projects/<id>/settings).
  3. Скопируйте DSN-ключ — публичный идентификатор проекта для SDK и curl-тестов.
При онбординге кабинет открывает настройки с DSN сразу после создания проекта.

Подключение SDK

Установите пакет из реестра GitFlic. Ниже — примеры для 12 популярных SDK @ v0.4.0. Остальные 35 клиентов — в интерактивном каталоге с командами установки и README.

JavaScript / TypeScript

Клиент для браузера и серверного JavaScript/TypeScript.

Установка
npm install devlogs-sdk-js@0.4.0 \
  --registry https://git.melnikovit.ru/registry/package/-/npm/
Инициализация и тестовая ошибка
import { init, captureError } from 'devlogs-sdk-js';

init({
  dsn: 'YOUR_DSN',
  serverUrl: 'https://dev-logs.ru',
  release: '1.0.0',
  environment: 'production',
  gitCommit: process.env.NEXT_PUBLIC_GIT_COMMIT,
});

captureError(new Error('тестовая ошибка'));

README: javascript/README.md · карточка в реестре

Node.js

Клиент для Node.js без привязки к фреймворку.

Установка
npm install devlogs-sdk-node@0.4.0 \
  --registry https://git.melnikovit.ru/registry/package/-/npm/
Инициализация и тестовая ошибка
import { init, captureException } from 'devlogs-sdk-node';

init({
  dsn: 'YOUR_DSN',
  serverUrl: 'https://dev-logs.ru',
  release: '1.0.0',
  environment: 'production',
  gitCommit: process.env.NEXT_PUBLIC_GIT_COMMIT,
});

captureException(new Error('тестовая ошибка'));

README: npm-packages/node/README.md · карточка в реестре

React

Интеграция DevLogs для React-приложений.

Установка
npm install @devlogs/sdk-react@0.4.0 \
  --registry https://git.melnikovit.ru/registry/package/-/npm/
Инициализация и тестовая ошибка
import { init, captureException } from '@devlogs/sdk-react';

init({
  dsn: 'YOUR_DSN',
  serverUrl: 'https://dev-logs.ru',
  release: '1.0.0',
  environment: 'production',
  gitCommit: process.env.NEXT_PUBLIC_GIT_COMMIT,
});

captureException(new Error('тестовая ошибка'));

README: npm-packages/react/README.md · карточка в реестре

Next.js

Интеграция DevLogs для Next.js.

Установка
npm install @devlogs/sdk-nextjs@0.4.0 \
  --registry https://git.melnikovit.ru/registry/package/-/npm/
Инициализация и тестовая ошибка
import { init, captureException } from '@devlogs/sdk-nextjs';

init({
  dsn: 'YOUR_DSN',
  serverUrl: 'https://dev-logs.ru',
  release: '1.0.0',
  environment: 'production',
  gitCommit: process.env.NEXT_PUBLIC_GIT_COMMIT,
});

captureException(new Error('тестовая ошибка'));

README: npm-packages/nextjs/README.md · карточка в реестре

Go (Golang)

Клиент для Go-сервисов, CLI и микросервисов.

Установка
export GOPROXY=direct
export GOPRIVATE=git.melnikovit.ru

go get git.melnikovit.ru/project/ivan/dev-logs-sdk/go@v0.4.0
Инициализация и тестовая ошибка
import (
  "errors"
  devlogs "git.melnikovit.ru/project/ivan/dev-logs-sdk/go"
)

client := devlogs.New("YOUR_DSN",
  devlogs.WithServerURL("https://dev-logs.ru"),
  devlogs.WithRelease("1.0.0"),
  devlogs.WithEnvironment("production"),
  devlogs.WithGitCommit(os.Getenv("CI_COMMIT_SHA")),
)
client.CaptureError(errors.New("тестовая ошибка"), nil)

README: go/README.md · карточка в реестре

Python

Клиент для Python-приложений и скриптов.

Установка
pip install devlogs-sdk-python==0.4.0 \
  --index-url https://git.melnikovit.ru/registry/package/-/pypi/simple
Инициализация и тестовая ошибка
from devlogs import Client

client = Client("YOUR_DSN", server_url="https://dev-logs.ru")
client.capture_exception(Exception("тестовая ошибка"))

README: python/README.md · карточка в реестре

PHP

Клиент для PHP-приложений.

Установка
composer require devlogs/devlogs-sdk-php:0.4.0 \
  --repository='{"type":"composer","url":"https://git.melnikovit.ru/registry/package/-/composer/"}'
Инициализация и тестовая ошибка
$client = new \DevLogs\Client('YOUR_DSN', 'https://dev-logs.ru');
$client->captureException(new \Exception('тестовая ошибка'));

README: php/README.md · карточка в реестре

Ruby

Клиент для Ruby-приложений.

Установка
gem install devlogs-sdk-ruby -v 0.4.0 \
  --source https://git.melnikovit.ru/registry/package/-/rubygem
Инициализация и тестовая ошибка
client = Devlogs::Client.new(dsn: 'YOUR_DSN', server_url: 'https://dev-logs.ru')
client.capture_exception(StandardError.new('тестовая ошибка'))

README: ruby/README.md · карточка в реестре

Java

Клиент для Java-приложений.

Установка
<!-- pom.xml — репозиторий GitFlic -->
<repositories>
  <repository>
    <id>gitflic</id>
    <url>https://git.melnikovit.ru/registry/package/-/maven/</url>
  </repository>
</repositories>

<dependency>
  <groupId>ru.devlogs</groupId>
  <artifactId>devlogs-sdk-java</artifactId>
  <version>0.4.0</version>
</dependency>
Инициализация и тестовая ошибка
Client client = new Client("YOUR_DSN", "https://dev-logs.ru");
client.captureException(new RuntimeException("тестовая ошибка"));

README: java/README.md · карточка в реестре

C# / .NET

Клиент для C# и .NET-приложений.

Установка
dotnet nuget add source https://git.melnikovit.ru/registry/package/-/nuget/index.json -n gitflic
dotnet add package devlogs-sdk-dotnet --version 0.4.0
Инициализация и тестовая ошибка
var client = new Client("YOUR_DSN", "https://dev-logs.ru");
await client.CaptureExceptionAsync(new Exception("тестовая ошибка"));

README: dotnet/README.md · карточка в реестре

React Native

Клиент для React Native-приложений.

Установка
npm install @devlogs/sdk-react-native@0.4.0 \
  --registry https://git.melnikovit.ru/registry/package/-/npm/
Инициализация и тестовая ошибка
import { initForReactNative, captureException } from '@devlogs/sdk-react-native';

initForReactNative({
  dsn: 'YOUR_DSN',
  serverUrl: 'https://dev-logs.ru',
  release: '1.0.0',
  environment: 'production',
  gitCommit: process.env.NEXT_PUBLIC_GIT_COMMIT,
});

captureException(new Error('тестовая ошибка'));

README: npm-packages/react-native/README.md · карточка в реестре

Laravel

Интеграция DevLogs для Laravel.

Установка
composer require devlogs/devlogs-sdk-laravel:0.4.0 \
  --repository='{"type":"composer","url":"https://git.melnikovit.ru/registry/package/-/composer/"}'
Инициализация и тестовая ошибка
use DevLogs\Laravel\DevLogsClient;

$client = new DevLogsClient('YOUR_DSN', 'https://dev-logs.ru');
$client->captureException(new \Exception('тестовая ошибка'));

README: laravel/README.md · карточка в реестре

Git-коммит (подозреваемый commit в issue)

Передайте SHA деплоя — DevLogs автоматически заполнит блок «Подозреваемый коммит» при первом событии issue. Ручное значение в кабинете не перезаписывается.

JS SDK
DevLogs.init({
  dsn: process.env.NEXT_PUBLIC_DEVLOGS_DSN,
  release: "1.2.0",
  gitCommit: process.env.NEXT_PUBLIC_GIT_COMMIT,
  gitCommitMessage: process.env.NEXT_PUBLIC_GIT_COMMIT_MESSAGE,
});

Альтернатива: тег git_commit или поле gitCommit в JSON ingest. Если release — git SHA (7–40 hex), он тоже подставится. Подробнее: Git-коммит в событиях.

Go SDK
client := devlogs.New("YOUR_DSN",
  devlogs.WithRelease("1.2.0"),
  devlogs.WithGitCommit(os.Getenv("CI_COMMIT_SHA")),
)

Release и environment

Передайте release (версия приложения) и environment (production, staging, …) при инициализации — они попадают в каждое событие и доступны в фильтрах кабинета.

ПеременнаяОписание
DEVLOGS_DSNПубличный DSN проекта (если SDK поддерживает env)
DEVLOGS_SERVER_URLБазовый URL (https://dev-logs.ru)
DEVLOGS_RELEASEВерсия релиза приложения
DEVLOGS_GIT_COMMITGit SHA деплоя (подозреваемый коммит в issue)
DEVLOGS_GIT_COMMIT_MESSAGEСообщение git-коммита (необязательно)
DEVLOGS_ENVIRONMENTОкружение (production, staging, …)

Как проверить, что работает

После инициализации SDK вызовите тестовую ошибку (например captureException) или отправьте событие через curl:

curl — тестовое событие
curl -s -X POST "https://dev-logs.ru/api/ingest" \
  -H "Content-Type: application/json" \
  -d '{
    "dsn": "YOUR_DSN",
    "message": "Тестовая ошибка DevLogs",
    "level": "error",
    "type": "TestError",
    "release": "1.0.0",
    "environment": "production"
  }'

Успешный ответ: HTTP 201 с errorId и fingerprint.

Просмотр ошибок в кабинете

  1. Кабинет → Проект → Issues — список сгруппированных ошибок (issues).
  2. Фильтры: уровень, окружение, release, текст сообщения, статус (открыта / решена).
  3. Клик по issue — детали: stack trace, контекст, breadcrumbs, история событий.
  4. Для читаемого stack trace в production загрузите source maps и укажите тот же release в SDK.

Алерты

Настройте уведомления о новых issues: Telegram, email или webhooks — в настройках проекта или по инструкции в разделе Алерты.