Панель мониторинга метрик использования Copilot, API и файлы экспорта используют одни и те же базовые данные телеметрии, но агрегируют и представляют их по-разному. Понимание этих различий помогает согласовывать цифры из разных источников и доверять анализу при подготовке внутренних отчетов.
- Панели метрик использования Copilot доступны на уровне предприятия и организации .
- API метрик использования Copilot поддерживает корпоративные, организационные и пользовательские записи.
Предпосылка
Метрики использования на основе IDE Copilot зависят от телеметрии IDE пользователей. Если разработчик отключил телеметрию в своём IDE, его активность Copilot на основе IDE не будет отображаться в дашборде, отчётах API или экспортированных данных.
Если вы заметили отсутствие пользователей или неожиданно низкое число внедрений, проверьте параметры телеметрии интегрированной среды разработки, прежде чем устранять другие причины.
Второй пилот CLI метрики (daily_active_cli_users и totals_by_cli) собираются и отражаются отдельно от IDE-телеметрии. Использование CLI не влияет на количество активных пользователей на основе IDE или другие показатели IDE.
Выравнивание метрик
Панель мониторинга и API используют общие определения для ключевых показателей:
| Понятие | Метрика дашборда | API или поле экспорта | Примечания. |
|---|---|---|---|
| Активные пользователи | Ежедневные/еженедельные/общее количество активных пользователей |
`user_initiated_interaction_count` > 0 | Пользователь считается активным, если в этот день он взаимодействовал с Copilot в своей среде IDE. |
| Процент принятых | Процент принятия доработок кода |
code_acceptance_activity_count ÷ code_generation_activity_count | Оба источника рассчитывают коэффициент принятия одинаково, хотя округление может отличаться. |
| Внедрение агентов | Диаграмма внедрения агентов |
totals_by_feature где feature = "агент" | Отображает пользователей, которые взаимодействовали с Copilot агент. |
| Использование языка | Графики использования языков |
totals_by_language_feature или totals_by_language_model | Панель мониторинга визуализирует эти агрегированные поля. |
Полное описание полей см. в разделе АВТОЗАГОЛОВОК.
Расхождения между отчетами
Ожидаются небольшие расхождения между данными панели мониторинга, отчетами API и экспортом. Эти различия обычно вызваны различиями во временных окнах, области действия или актуальности данных.
Окна времени
Каждый источник данных агрегирует данные по-своему.
| Исходный материал | Временное окно | Метод агрегирования |
|---|---|---|
| Dashboard | 28-дневное скользящее окно | Метрики агрегируются непрерывно за последние 28 дней, чтобы сгладить колебания. |
| Программные интерфейсы | Ежедневно | Каждая запись представляет один день для каждого пользователя, что позволяет анализировать ежедневные тенденции. |
| Экспорт NDJSON | Ежедневно | Зеркалирование вывода API для инструментов бизнес-аналитики и долгосрочной отчетности. |
Согласование отчетного периода с 28-дневным окном панели обеспечивает согласованность сравнений.
Телеметрия с задержкой
Так как телеметрия интегрированной среды разработки обрабатывается асинхронно, данные за последние дни могут отображаться неполными или отсутствовать. Данные обычно обрабатываются в течение трех полных дней в формате UTC. Кажущееся снижение последних ежедневных метрик часто устраняется после полной обработки телеметрии.
Сроки экспорта
Файлы NDJSON отражают данные, доступные на момент экспорта. Если файл скачивается до обработки новых данных телеметрии, данные могут отставать от панели мониторинга или API. Повторный экспорт файла по истечении трехдневного окна обеспечивает наиболее точное представление.
`Unknown` Значения
Значение Unknown отображается в некоторых разбивках API или экспорта, когда в данных телеметрии от клиента IDE недостаточно подробностей для категоризации действия. Это ожидаемое поведение и не указывает на отсутствующие данные.
| Поломка | Explanation |
|---|---|
| Language | Отображается, когда Unknown среда IDE не может определить язык программирования активного файла. |
| Функция | Появляется, когда старый клиент отправляет общее событие без указания режима чата (например, chat_panel_unknown_mode). |
| Модель | Появляется, когда в событии отсутствует информация, идентифицирующая используемую модель. Некоторые внутренние модели (например, ) могут отображаться рядом gpt-4o-mini при использовании для операций, Unknownне связанных с пользователем, таких как суммаризация или обнаружение намерений. |
`Unknown` Значения исключены из визуализаций панели мониторинга, но отображаются в данных API и NDJSON для полноты картины. Объем `Unknown` данных уменьшается по мере того, как пользователи обновляются до более новых версий интегрированной среды разработки и расширений, которые отправляют более подробные данные телеметрии.