> For the complete documentation index, see [llms.txt](https://navixy.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://navixy.com/docs/analytics/ru/iot-query/schema-overview/transformation-layer/common-transformations/rule-based-driver-events.md).

# События водителя на основе правил

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

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

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

{% hint style="info" %}

* Пороги для превышения скорости и Стоит с включенным двигателем берутся из ваших собственных правил оповещений, а не из общих значений по умолчанию платформы. Два устройства могут создавать разные события при одинаковом Вождение, если к ним применяются разные правила.
* Повторяющиеся аппаратные события одного типа от одного и того же устройства в течение 10 секунд объединяются в одну строку, поскольку устройство может отправлять несколько сигналов по одному инциденту.
* События на основе Акселерометра игнорируются, пока транспортное средство Движется со скоростью ниже 3 км/ч. Это позволяет не считать вибрацию при погрузке или стоянке нарушением.
* Все временные метки хранятся в UTC.
  {% endhint %}

## Выходная таблица: processed\_common\_data.rule\_based\_driver\_events

Каждая строка представляет одно выявленное нарушение. Таблица индексируется по `device_id`, `device_time`, `rule_id`, и `hw_event_id`.

Несколько столбцов — это денормализованные копии значений, хранящихся в других местах, поэтому самым распространенным запросам панели мониторинга не нужны соединения вообще: `метка_объекта` берется из записи Объект, и `speed_limit`, `event_comment1`, и `event_comment2` берутся из правила, которое создало событие.

<table><thead><tr><th width="180">Поле</th><th width="100">Тип</th><th>Описание</th></tr></thead><tbody><tr><td><code>device_id</code></td><td>integer</td><td>Идентификатор устройства.</td></tr><tr><td><code>object_id</code></td><td>integer</td><td>Идентификатор Объект (транспортное средство или Актив), связанный с устройством на момент события.</td></tr><tr><td><code>метка_объекта</code></td><td>text</td><td>Читаемое имя Объект. Уже денормализовано в эту таблицу, поэтому соединение с <code>raw_business_data.objects</code> не требуется.</td></tr><tr><td><code>device_time</code></td><td>метка времени</td><td>Метка времени события в UTC.</td></tr><tr><td><code>rule_id</code></td><td>integer</td><td>Правило контроля событий, которое создало событие. Ссылки <code>raw_business_data.rules</code>. Установить в <code>0</code> для <code>Обороты двигателя превышены</code> события, которые не основаны на правилах. См. <a href="#how-rules-shape-the-output">Как правила формируют результат</a>.</td></tr><tr><td><code>event_type</code></td><td>text</td><td>Категория нарушения. Одно из четырех значений. См. <a href="#violation-types">Типы нарушений</a> ниже.</td></tr><tr><td><code>hw_event_id</code></td><td>integer</td><td>Код аппаратного события для нарушений, обнаруженных Акселерометром и датчиком. <code>0</code> для <code>ускорение</code> и <code>Стоит с включенным двигателем_soft</code>, которые вычисляются, а не передаются устройством.</td></tr><tr><td><code>event_comment1</code></td><td>text</td><td>Свободнотекстовая метка, скопированная из правила. Задается при настройке правила и полезна для группировки событий по вашим собственным категориям. Null для <code>Обороты двигателя превышены</code>.</td></tr><tr><td><code>event_comment2</code></td><td>text</td><td>Вторая текстовая метка свободного ввода, скопированная из правила. Null для <code>Обороты двигателя превышены</code>.</td></tr><tr><td><code>speed_limit</code></td><td>integer</td><td>Порог, настроенный в правиле, денормализованный из <code>raw_business_data.rules</code>. Для <code>ускорение</code> правила это ограничение скорости в км/ч; для <code>Стоит с включенным двигателем_soft</code> для правил это допуск по времени работы на холостом ходу в минутах.</td></tr><tr><td><code>speed_kmh</code></td><td>числовой</td><td>Скорость транспортного средства в момент события, км/ч.</td></tr><tr><td><code>duration_sec</code></td><td>integer</td><td>Длительность нарушения в секундах для типов событий, которые длятся в течение некоторого времени, а не происходят мгновенно.</td></tr><tr><td><code>zone_id</code></td><td>integer</td><td>Зона, в которой произошло событие, когда правило ограничено определенными зонами. Null, когда к правилу не привязаны зоны, а также когда правило настроено срабатывать вне своих зон. См. <a href="#zone-scoping">Ограничение по зонам</a>.</td></tr><tr><td><code>zone_label</code></td><td>text</td><td>Читаемое для человека название Зона, денормализованное вместе с <code>zone_id</code>.</td></tr><tr><td><code>широта</code></td><td>double precision</td><td>Широта в градусах.</td></tr><tr><td><code>longitude</code></td><td>double precision</td><td>Долгота в градусах.</td></tr><tr><td><code>extra_value</code></td><td>числовой</td><td>Контекстно-зависимое измерение, устанавливаемое для типов событий, которые фиксируют показание, отличное от скорости. Для <code>Обороты двигателя превышены</code> событий, показание Обороты двигателя, которое вызвало событие.</td></tr><tr><td><code>created_at</code></td><td>метка времени</td><td>Когда строка была записана функцией обновления. Позже, чем <code>device_time</code> до длительности одного цикла обновления.</td></tr></tbody></table>

### Типы нарушений

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

<table><thead><tr><th width="150">значение event_type</th><th width="230">Что это означает</th><th width="150">hw_event_id</th><th>Порог</th></tr></thead><tbody><tr><td><code>ускорение</code></td><td>Транспортное средство превысило ограничение скорости, установленное в правиле</td><td><code>0</code></td><td>По правилу, км/ч</td></tr><tr><td><code>агрессивное_вождение</code></td><td>Акселерометр или аппаратное событие, сообщаемое устройством: Ускорение, торможение, повороты, смена полосы и нарушения использования ремня безопасности</td><td><code>900</code>, <code>931</code>, <code>987</code>–<code>991</code>, <code>996</code></td><td>Обнаруживается устройством. Игнорируется ниже 3 км/ч</td></tr><tr><td><code>Стоит с включенным двигателем_soft</code></td><td>Транспортное средство стоит, когда Зажигание включено дольше, чем допускает правило</td><td><code>0</code></td><td>На правило, в минутах</td></tr><tr><td><code>Обороты двигателя превышены</code></td><td>Обороты двигателя выше порога платформы</td><td><code>9002</code></td><td>Зафиксировано на уровне 5,000 Обороты двигателя</td></tr></tbody></table>

{% hint style="warning" %}
Это `event_type` значения, и `hw_event_id` нумерация, отличается от таблицы событий производительности Водитель, которую заменяет это преобразование. Запросы, написанные для старой таблицы, требуют обновления значений фильтра, а не только имени таблицы. В частности, нарушения использования ремня безопасности больше не имеют собственного типа события: они приходят как `агрессивное_вождение` с `hw_event_id = 931`.
{% endhint %}

Примеры ниже показывают распространенные шаблоны запросов. Базовый запрос возвращает недавние нарушения, отсортированные по устройству и времени. Второй добавляет определение правила, стоящее за каждым событием. Третий фильтрует только Опасное вождение, обнаруженное оборудованием.

{% tabs %}
{% tab title="Базовый запрос" %}
{% code overflow="wrap" expandable="true" %}

```sql
SELECT
    device_id,
    метка объекта,
    device_time,
    event_type,
    speed_kmh,
    speed_limit,
    широта,
    longitude
FROM processed_common_data.rule_based_driver_events
WHERE device_time >= CURRENT_DATE - INTERVAL '7 days'
ORDER BY device_id, device_time;
```

{% endcode %}
{% endtab %}

{% tab title="С деталями правила" %}
{% code overflow="wrap" expandable="true" %}

```sql
SELECT
    e.device_id,
    e.object_label,
    e.device_time,
    e.event_type,
    e.speed_kmh,
    e.speed_limit,
    e.event_comment1,
    r.maximum AS rule_threshold
FROM processed_common_data.rule_based_driver_events e
LEFT JOIN raw_business_data.rules r
    ON r.rule_id = e.rule_id
WHERE e.device_time >= CURRENT_DATE - INTERVAL '7 days'
ORDER BY e.device_id, e.device_time;
```

{% endcode %}

Используйте `LEFT JOIN` вместо внутреннего соединения. `Обороты двигателя превышены` события содержат `rule_id = 0` и не имеют совпадающей строки в `raw_business_data.rules`, поэтому внутреннее соединение молча отбрасывает их.
{% endtab %}

{% tab title="Только опасное вождение" %}
{% code overflow="wrap" expandable="true" %}

```sql
SELECT
    device_id,
    метка объекта,
    device_time,
    hw_event_id,
    speed_kmh
FROM processed_common_data.rule_based_driver_events
WHERE event_type = 'harsh_driving'
  AND device_time >= CURRENT_DATE - INTERVAL '7 days'
ORDER BY device_id, device_time;
```

{% endcode %}

Фильтрация по одному `event_type` значение заменяет длинное `В` перечислите требуемую предыдущую таблицу, поскольку теперь все нарушения акселерометра и оборудования относятся к одной категории. Разделите их с помощью `hw_event_id` когда вам нужен отдельный маневр.
{% endtab %}
{% endtabs %}

## Как правила формируют результат

Строки в этой таблице не формируются логикой обнаружения на уровне платформы. За исключением `Обороты двигателя превышены`, каждое событие является результатом того, что в вашей учетной записи настроено Правило контроля событий, и это правило определяет как порог, так и область действия.

{% stepper %}
{% step %}

#### Правило задает порог

Каждое правило хранит свой порог в `raw_business_data.rules.maximum`: скорость в км/ч для `ускорение` правил, продолжительность в минутах для `Стоит с включенным двигателем_soft` правил. Преобразование копирует это значение в `speed_limit` в каждой строке, которую оно записывает, поэтому вы можете видеть, относительно чего измерялось транспортное средство, не делая повторного соединения с правилом.
{% endstep %}

{% step %}

#### Правило задает область действия

Правило применяется к объектам, связанным с ним через `rules2objects`, и, при необходимости, к геозонам, связанным через `rules2zones`. Устройство вне списка Объектов правила не генерирует для этого правила никаких событий, как бы оно ни управлялось.
{% endstep %}

{% step %}

#### Правило использует собственные метки

`event_comment1` и `event_comment2` это поля свободного текста, которые заполняются при настройке правила. Они копируются в каждое событие, чтобы панели мониторинга могли отображать вашу собственную терминологию без объединения.
{% endstep %}

{% step %}

#### Функция обновления оценивает окно

Каждые 15 минут, `refresh_rule_based_driver_events` повторно просматривает 40-минутное окно недавних данных и записывает все события, соответствующие условиям. Окно намеренно длиннее интервала, поэтому записи, которые поступают на платформу с задержкой, все равно будут подхвачены при следующем проходе.
{% endstep %}

{% step %}

#### Обороты двигателя — исключение

`Обороты двигателя превышены` события не основаны на правилах. Они используют фиксированный порог платформы 5,000 Обороты двигателя, переносят `rule_id = 0`, и не имеют `event_comment1` или `event_comment2` значений.
{% endstep %}
{% endstepper %}

### Ограничение по зонам

Когда к правилу привязаны геозоны через `rules2zones`, эти зоны определяют и то, будет ли записано событие, и то, будет ли `zone_id` заполняется. Геометрия зоны считывается из `processed_common_data.zones_geom`, материализовано из `raw_business_data.zones`.

<table><thead><tr><th width="260">Конфигурация правила</th><th width="200">Записанные события</th><th>значение zone_id</th></tr></thead><tbody><tr><td>Не прикреплены зоны</td><td>Везде</td><td>Null</td></tr><tr><td>Прикреплены зоны, <code>zone_inverted = false</code></td><td>Только внутри зон</td><td>Зона, в которой произошло событие</td></tr><tr><td>Прикреплены зоны, <code>zone_inverted = true</code></td><td>Только вне зон</td><td>Null</td></tr></tbody></table>

{% hint style="warning" %}
Пустое значение `zone_id` само по себе двусмысленно: это означает либо, что у правила не было геозон, либо что правило срабатывает вне своих геозон. Фильтрация с помощью `WHERE zone_id IS NULL` смешает оба случая вместе. Соедините с `rules2zones` когда вам нужно их различать.
{% endhint %}

<details>

<summary>Фиксированные константы платформы</summary>

Эти значения одинаковы для всех учетных записей и не настраиваются через правило. Пороги, задаваемые правилами, описаны в [Как правила формируют результат](#how-rules-shape-the-output).

<table><thead><tr><th width="220">Константа</th><th width="160">Значение</th><th>Описание</th></tr></thead><tbody><tr><td>Минимальная скорость для событий Акселерометр</td><td>3 km/h</td><td>Нарушения на основе Акселерометр ниже этой скорости игнорируются, чтобы не отмечать вибрацию во время стоянки или загрузки.</td></tr><tr><td>Порог Обороты двигателя</td><td>5,000 Обороты двигателя</td><td>Обороты двигателя должны превышать это значение для <code>Обороты двигателя превышены</code> чтобы событие было записано.</td></tr><tr><td>Окно дедупликации аппаратных событий</td><td>10 секунд</td><td>Повторяющиеся аппаратные события одного и того же типа с одного и того же устройства в пределах этого окна объединяются в одно.</td></tr><tr><td>Интервал обновления</td><td>15 минут</td><td>Как часто выполняется функция обновления.</td></tr><tr><td>Период ретроспективы обновления</td><td>40 минут</td><td>Насколько далеко назад каждый запуск повторно анализирует данные, чтобы поздно поступившие записи не были пропущены.</td></tr></tbody></table>

</details>

## Настройка преобразования

Для `ускорение` и `Стоит с включенным двигателем_soft`, настройка вообще не требует рабочего процесса. Оба порога берутся из правила контроля событий, так что изменение правила меняет то, что преобразование записывает начиная со следующего обновления. То же самое относится к области: измените объекты или геозоны, прикрепленные к правилу, чтобы изменить, какие транспорт и области генерируют события.

{% hint style="warning" %}
Функция обновления, которая заполняет `processed_common_data.rule_based_driver_events` не может быть отредактирована напрямую. Пороги, которые не задаются правилом, такие как нижний порог акселерометра 3 km/h или предел 5,000 оборотов двигателя, можно изменить только путем создания параллельного рабочего процесса в Конструкторе преобразований и его планирования как отдельного преобразования в `processed_custom_data`. Это не изменяет таблицу, описанную на этой странице.
{% endhint %}

Если вашему операционному сценарию нужны другие фиксированные пороги, обратитесь к **<iotquery@navixy.com>** чтобы запросить соответствующий шаблон рабочего процесса. После того как вы его получите, загрузите его в [Конструктор трансформаций](https://navixy.com/docs/analytics/ru/iot-query/schema-overview/transformation-layer/transformation-builder.md), скорректируйте соответствующие значения и запланируйте измененный рабочий процесс как пользовательское преобразование.

## Дальнейшие шаги

* [**Общие преобразования**](https://navixy.com/docs/analytics/ru/iot-query/schema-overview/transformation-layer/common-transformations.md): Назад к индексу преобразований.
* [**Поездки**](https://navixy.com/docs/analytics/ru/iot-query/schema-overview/transformation-layer/common-transformations/trips.md): Соседнее преобразование, которое формирует записи о поездках транспортных средств на основе необработанных телематических данных.
* [**Агрегация данных датчиков**](https://navixy.com/docs/analytics/ru/iot-query/schema-overview/transformation-layer/common-transformations/sensor-data-aggregation.md): Соседнее преобразование, которое агрегирует показания датчиков по временным интервалам.
* [**Слой сырых данных**](https://navixy.com/docs/analytics/ru/iot-query/schema-overview/bronze-layer.md): Изучить `tracking_data_core`, `состояния`, и `входных данных`, исходные таблицы, которые формируют события Водитель на основе правил.
* [**Конструктор трансформаций**](https://navixy.com/docs/analytics/ru/iot-query/schema-overview/transformation-layer/transformation-builder.md): Узнайте, как создать настраиваемую версию этого преобразования.
* [**Панель мониторинга Рейтинг водителей**](https://github.com/Navixy/navixy-iot-query-dashboard/blob/main/schemas/12-driver-performance-dashboard.md): Использует события Водителя на основе правил для оценки Безопасности Вождения для всего Автопарка.
* [**Панель мониторинга влияния поведения**](https://github.com/Navixy/navixy-iot-query-dashboard/blob/main/schemas/13-behavior-impact-dashboard.md): Использует события Водитель, основанные на правилах, для отслеживания тенденций поведения со временем.
* [**Панель мониторинга Безопасность и Охрана**](https://github.com/Navixy/navixy-iot-query-dashboard/blob/main/schemas/10-premium-safety-security-dashboard.md): Использует события Водитель на основе правил вместе с данными Зона и Поездка.
* [**Панель мониторинга лизинга**](https://github.com/Navixy/navixy-iot-query-dashboard/blob/main/schemas/06-leasing-dashboard.md): Использует запросы Опасное вождение и определения холостого хода из событий Водитель на основе правил.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://navixy.com/docs/analytics/ru/iot-query/schema-overview/transformation-layer/common-transformations/rule-based-driver-events.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
