Quickstart & Agent Installation

Для PHP агент состоит из двух частей: Zend Extension tracelight.so внутри PHP-FPM и системного демона tracelight-daemon, который держит соединение с ingestion-узлом.

# Токен из консоли: Settings → Organization → Package Registry
export TL_TOKEN=tlr_xxxxxxxxxxxxxxxx

# Debian / Ubuntu: закрытый APT-репозиторий
echo "machine packages.tracelight.ru login org password $TL_TOKEN" \
  | sudo tee /etc/apt/auth.conf.d/tracelight.conf
curl -fsSL -u org:$TL_TOKEN https://packages.tracelight.ru/gpg \
  | sudo gpg --dearmor -o /usr/share/keyrings/tracelight.gpg
echo "deb [signed-by=/usr/share/keyrings/tracelight.gpg] https://packages.tracelight.ru/apt stable main" \
  | sudo tee /etc/apt/sources.list.d/tracelight.list
sudo apt update && sudo apt install tracelight-php tracelight-daemon

# Composer: подключение закрытого репозитория
composer config repositories.tracelight composer https://composer.tracelight.ru
composer config http-basic.composer.tracelight.ru org $TL_TOKEN
composer require tracelight/profiler

SDK работает внутри процесса и поддерживает Node.js 22, 24 и 26. Scope @tracelight устанавливается только из внутреннего npm-реестра.

# .npmrc в корне проекта
@tracelight:registry=https://npm.tracelight.ru/
//npm.tracelight.ru/:_authToken=${TL_TOKEN}

# установка
npm install @tracelight/sdk

# загрузка source maps в CI
npx tracelight sourcemaps upload ./dist --release "$GIT_SHA"

Пакет поддерживает Python 3.11–3.15 и устанавливается из внутреннего индекса PyPI. Интеграции с FastAPI, Django, Celery и SQLAlchemy включаются автоматически.

# pip.conf или переменная окружения
export PIP_EXTRA_INDEX_URL=https://org:${TL_TOKEN}@pypi.tracelight.ru/simple

pip install "tracelight-apm[profiling]"

# Poetry
poetry source add --priority=supplemental tracelight https://pypi.tracelight.ru/simple
poetry config http-basic.tracelight org $TL_TOKEN
poetry add tracelight-apm

; /etc/php/8.5/mods-available/tracelight.ini
extension=tracelight.so
tracelight.dsn="${TRACELIGHT_DSN}"
tracelight.service="checkout-api"
tracelight.environment="production"
tracelight.sample_rate=0.25
tracelight.profiling=1

// instrument.ts — импортируйте до остального кода приложения
import { init } from "@tracelight/sdk";

init({
  dsn: process.env.TRACELIGHT_DSN,
  service: "storefront-web",
  environment: "production",
  tracesSampleRate: 0.25,
  profiling: { eventLoopLag: true },
});

import os
import tracelight_apm
from fastapi import FastAPI

tracelight_apm.init(
    dsn=os.environ["TRACELIGHT_DSN"],
    service="pricing-svc",
    environment="production",
    traces_sample_rate=0.25,
    profiling=True,
)

app = FastAPI()