Отчеты о дорожно-транспортных происшествиях

Когда адаптер выходит из строя, в журнал записывается сообщение об ошибке. Разработчик видит его только в том случае, если кто-то сообщает о проблеме. Именно этот пробел и заполняют отчеты о сбоях: вышедший из строя адаптер автоматически отправляет сообщение об ошибке разработчику, и никому не нужно создавать заявку в службу поддержки.

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

Передаётся сообщение об ошибке программы, а не состояние вашей системы.

Что передается

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

Ваше имя, адрес электронной почты или IP-адрес передаваться не будут. Сообщения будут удалены максимум через 90 дней.

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

Какие адаптеры это умеют?

В списке адаптеров адаптеры, сообщающие о сбоях, отмечены специальным символом: зеленые горы . Это позволяет с первого взгляда увидеть на плитке адаптера, известно ли разработчику о сбое.

Та же информация доступна в списке экземпляров в обзоре столбцов: там символ для каждого экземпляра указывает, сообщает ли этот экземпляр о сбоях.

Выключить

Существует три уровня, и они функционируют независимо друг от друга.

Вся настройка установки осуществляется через «Системные настройки», вкладка «Статистика» . Если там не выбран ни один параметр , согласно сообщению диалогового окна, ни статистика использования, ни отчеты о сбоях передаваться не будут. Эта настройка предназначена для тех, кто вообще не хочет ничего отправлять. Подробную информацию о внешнем виде вкладки можно найти в разделе «Статистика использования» .

Для использования отдельного хоста или экземпляра через командную строку:

iobroker plugin disable sentry
iobroker plugin disable sentry --instance adaptername.0

Первая команда применяется к хосту, на котором она выполняется, вторая — только к указанному экземпляру.enable вместоdisable Его снова включат.

В дереве объектов , если вы уже там. Переключатель находится вsystem.host.NAME.plugins.sentry.enabled для хоста и вsystem.adapter.NAME.INSTANCE.plugins.sentry.enabled Например, это тот же параметр, что и в командной строке, только устанавливается вручную.

Для разработчиков

Адаптер получает отчеты о сбоях через plugin-sentry . Эти данные регистрируются в журнале.io-package.json подcommon.plugins.sentry сdsn Обязательно укажите название вашего проекта Sentry. При желании можно добавить или исключить пути и типы ошибок, чтобы предотвратить попадание в вашу почту всех ненужных исключений.

Любой, кто хочет полностью предотвратить отправку отчетов по какому-либо случаю, устанавливаетcommon.disableDataReporting в объекте экземпляра. Поля описаны в разделе «Схема объекта» .