Git-коммит в событиях

Передача SHA деплоя из SDK и CI для автозаполнения подозреваемого commit в issue.

SHA git-коммита деплоя передаёт приложение при ingest. DevLogs автоматически заполняет блок «Подозреваемый коммит» на странице issue, если поле ещё пустое. Ручное значение в кабинете не перезаписывается.

Держите release как semver (1.2.0) для фильтров и source maps. SHA деплоя передавайте отдельно через gitCommit или тег git_commit.

Поля ingest

Поле / тег	Назначение	Пример
release	Версия приложения	1.2.0
gitCommit	Git SHA деплоя	e08fd3ee8f26…
gitCommitMessage	Сообщение коммита (необяз.)	fix: certs
tags.git_commit	Альтернатива gitCommit	abc1234
environment	Окружение	production

Полный контракт — в Ingest API.

CI/CD

Переменные в pipeline

export DEVLOGS_GIT_COMMIT="${CI_COMMIT_SHA}"
export DEVLOGS_GIT_COMMIT_MESSAGE="${CI_COMMIT_MESSAGE}"
export DEVLOGS_RELEASE="${CI_COMMIT_TAG:-1.0.0}"
export DEVLOGS_ENVIRONMENT="production"

# Frontend (build-time)
export NEXT_PUBLIC_GIT_COMMIT="${CI_COMMIT_SHA}"

JavaScript / TypeScript

javascript

import { init } from "devlogs-sdk-js";

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

Все npm-обёртки (@devlogs/sdk-nextjs, react, vue…) принимают те же опции — см. руководство по SDK.

Go

client := devlogs.New("YOUR_DSN",
  devlogs.WithRelease("1.2.0"),
  devlogs.WithEnvironment("production"),
  devlogs.WithGitCommit(os.Getenv("CI_COMMIT_SHA")),
  devlogs.WithGitCommitMessage(os.Getenv("CI_COMMIT_MESSAGE")),
)

Другие SDK

Если пакет ещё без нативного параметра — передайте тег git_commit или поле gitCommit в JSON. Примеры для каждого из 47 SDK — в README пакета и на /docs/sdk.

curl

bash

curl -s -X POST "https://dev-logs.ru/api/ingest" \
  -H "Content-Type: application/json" \
  -d '{
    "dsn": "YOUR_DSN",
    "message": "Test error",
    "level": "error",
    "release": "1.2.0",
    "gitCommit": "abc1234567890",
    "environment": "production"
  }'

Где смотреть

Issues → детали issue → сайдбар «Подозреваемый коммит». SHA также виден в шапке события (release или вкладка «Теги»).