Локальные метрики

Статус: принято 4 августа 2026 года.

Контекст

Во время пилотного внедрения нужно понимать, удаётся ли пользователям завершать работу и восстанавливаться после ошибок. Постоянная телеметрия для этого не требуется. Нельзя также считать время изменения файлов достоверным признаком намерения пользователя или успешного результата.

GigaLoom уже хранит структурированные сведения о запусках, действиях, подтверждениях, восстановлении, маршрутах и процессах. Отчёт строится только на этих данных.

Решение

Создание отчёта

Отчёт ProductEvidenceReportV1 создаётся только по явной локальной команде:

giga evidence product-beta --project <id> --output <path>

Экспорт относится к одному проекту, ограничен по объёму и выдаёт одинаковый результат для одинакового набора исходных данных. Команда не загружает отчёт в сеть, не обращается к учётным записям и провайдерам, не запускает зависимости и не отправляет сообщения пользователям.

Состав метрик

Если необходимые исходные события существуют, отчёт может содержать:

• время от создания проекта до первого успешного запуска и принятого изменения;
• результат и причину остановки первого запуска;
• время ожидания подтверждения и число незавершённых подтверждений;
• вмешательства пользователя, отмены, восстановления и продолжения работы;
• время от начала проверки до принятия изменения;
• повторное использование разделов Work, Inbox, Automations и Library;
• использование и отклонение Thread Relay;
• долю успешных предварительных проверок шлюза и неподдерживаемых маршрутов;
• время первого и повторного подключения управляемого процесса шлюза.

Для каждой метрики указываются версия схемы, псевдоним проекта, ограниченный интервал времени, редакции и контрольные суммы источников, числитель и знаменатель либо счётчик, результат, а также причина отсутствия значения.

Если данных недостаточно, значение остаётся unknown. Время установки, намерение пользователя, успешность и повторное использование не выводятся из косвенных признаков файловой системы.

Конфиденциальность и совместимость

Отчёт не содержит:

• запросы и ответы моделей;
• переписку, исходный код и изменения файлов;
• полные пути и необработанные аргументы команд;
• учётные данные и сведения об аккаунтах;
• содержимое вложений и ответы провайдеров.

Допускаются перечислимые результаты, счётчики, ограниченные длительности, обобщённые классы ошибок и уже существующие контрольные суммы.

Для отчёта не создаётся отдельное хранилище событий, сессий, процессов, маршрутов или подтверждений. Если редакция источника неизвестна или устарела, соответствующая метрика получает значение unknown с объяснением причины. Успешное создание отчёта не означает, что зависимость, маршрут или запуск завершились успешно.

Условия пилотного внедрения отдельно определяет состав участников, правила конфиденциальности и поддержки, критерии остановки и возможные решения по итогам пилота. Любая отправка отчёта во внешнюю систему требует отдельного разрешения.

Миграция и откат

Отчёт является производным версионируемым файлом. Новая версия пересчитывается из существующих событий и не дополняет их придуманными значениями. При откате можно удалить только отчёты, явно выбранные пользователем. Исходные данные не изменяются; удалённого сборщика метрик нет.

Последствия

Команда даёт проверяемые локальные метрики пилотного внедрения без постоянной телеметрии и без передачи пользовательского содержимого. Публикация или совместное использование отчёта остаются отдельным действием пользователя.