Tarn следит за качеством данных в вашем проекте Amplitude

Tarn получает события через Export API и каталог через Taxonomy API. Он рассчитывает почасовые показатели и сравнивает их с планом. Менять сбор событий в Amplitude не требуется.

APAmplitude

Что вы вводите при подключении

Мы просим доступ только на чтение. Всё, что вы введёте, шифруется перед записью и обратно не показывается.

API keyКлюч проекта Amplitude. Мы используем его как имя пользователя при обычной HTTP-аутентификации.
Secret keyСекрет того же проекта. Мы шифруем его перед записью и обратно не показываем.
Регионeu или us — от него зависит, к какому домену Amplitude мы обращаемся. По умолчанию мы берём eu.

Куда именно Tarn ходит

Мы вызываем только эти методы вендора — и только на чтение.

GET /api/2/exportСырые события за окно с точностью до часа. Из них мы считаем почасовые счётчики и срезы.
GET /api/2/taxonomy/eventСписок событий проекта — из него собирается план трекинга.
GET /api/2/taxonomy/event-propertyСвойства событий: тип, обязательность и перечисление допустимых значений.

Что Tarn забирает из события

По полученным событиям Tarn рассчитывает почасовой объём и показатели по срезам. Сырые события не сохраняются.

Что нужно TarnОткуда берётся
Имя событияevent_type
Время событияevent_time, иначе client_event_time
Платформаplatform, иначе os_name
Версия приложенияapp_version, version_name, version
Регионregion, иначе country
Параметрыevent_properties
Идентификатор пользователяuser_id, amplitude_id или device_id

Откуда берётся план трекинга

Tarn импортирует из Taxonomy API события и доступные описания параметров: типы, обязательность и допустимые значения. Служебные события с префиксом «[Amplitude]» в план не добавляются.

Если Taxonomy API недоступен, импорт продолжается без описаний свойств. Типы параметров определяются по полученным событиям.

Что стоит знать заранее

Мы перечисляем это здесь, а не выясняем на пилоте.

  • Мы не сдвигаем окно назад с поправкой на задержку выгрузки: события, которые Amplitude ещё не отдал, попадут в следующую проверку.
  • Если Amplitude отвечает 429, мы читаем заголовок retry-after и считаем проверку временно неудавшейся. Источник переходит в статус ошибки только после трёх подряд неудач.
  • Пустое окно (ответ 404) мы считаем нормой, а не сбоем: за этот час событий просто не было.
  • Проверки объёма требуют базового периода. Имена событий и состав параметров можно проверить после подключения источника.
Мониторинг Amplitude — Tarn