docs.tracekit.io

Центр разработчиков

Полная техническая документация, справочники по API и примеры кода для интеграции TraceKit в ваш стек микросервисов.

Быстрый старт

Настройте сбор метрик и трассировку за 3 команды. TraceKit разработан для минимального трения при внедрении.

01. Установка агента
02. Настройка API ключа
03. Первый трейд в Dashboard


            $ npm install @tracekit/agent

            $ tracekit init --env production

            // Initializing agent...

            // Config written to .tracekitrc

            

            ✔ Connected to collector.

            ✔ SDK v2.4.0 loaded.

Инструменты интеграции

Выберите метод подключения, который подходит под архитектуру вашего приложения.

GET /api/v2/traces

REST API Reference

Полный справочник по конечным точкам. Управление сборкой данных, фильтрация трейдов и экспорт метрик.

Открыть спецификацию →

import { trace }

Client SDKs

Нативные библиотеки для Node.js, Go, Python, Java и .NET. Автоматическая отправка контекста и обертки ошибок.

Скачать SDK →

{ config }

Настройка агентов

Глубокая настройка поведения агентов: сэмплирование, маскирование чувствительных данных и управление нагрузкой на сеть.

Параметры конфигурации →

Прозрачный код,
чистые данные

Наш SDK спроектирован так, чтобы не загрязнять ваш бизнес-код. Используйте декораторы для автоматической трассировки контроллеров или методы обертки для ручного контроля.

const tracer = TraceKit.init();

tracer.span('order.process', async (ctx) => {
ctx.set('user.id', '1024');
return await paymentService.charge();
});

Решение проблем

Агент не отправляет данные в облако

Проверьте наличие переменной окружения TRACEKIT_API_KEY. Убедитесь, что порт 443 открыт для исходящих соединений к ingest.tracekit.io.

Как уменьшить нагрузку на приложение?

Включите режим сэмплирования в конфигурации агента. Параметр sampling_rate: 0.1 отправит только 10% трейдов, сохранив репрезентативную выборку для анализа.

Совместимость с Docker и Kubernetes

TraceKit поддерживает автоматическое обнаружение метадат контейнеров (Pod Name, Namespace, Version) при запуске внутри кластера K8s. Документация по Helm-чарту доступна в разделе "Deploy".

Остались вопросы?

Присоединяйтесь к нашему сообществу разработчиков или откройте тикет в технической поддержке.

GitHub Discussions Открыть тикет