> 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/es/iot-query/schema-overview/transformation-layer/common-transformations/rule-based-driver-events.md).

# Eventos de conductor basados en reglas

Cómo la tabla de eventos del conductor basada en reglas convierte sus reglas de alerta en registros de infracciones de manejo, y cómo consultarla.

La transformación de eventos del conductor basada en reglas registra las infracciones de manejo como registros de eventos individuales y se evalúa frente a las reglas de alerta configuradas en su cuenta. Cada fila en `processed_common_data.rule_based_conductor_events` representa una infracción: qué regla la detectó, de qué tipo era, cuándo y dónde ocurrió, y a qué velocidad se movía el vehículo en ese momento.

A diferencia de la transformación basada en disparadores que reemplaza, esta se ejecuta según una programación fija. Una función de actualización vuelve a evaluar una ventana de datos recientes cada 15 minutos, de modo que una nueva fila puede retrasarse hasta 15 minutos con respecto al evento en el dispositivo.

{% hint style="info" %}

* Los umbrales para sobre exceso de velocidad y Ralentí provienen de sus propias reglas de alerta, no de los valores predeterminados de toda la plataforma. Dos dispositivos pueden generar eventos diferentes a partir de un Manejo idéntico si se les aplican reglas diferentes.
* Los eventos de hardware repetidos del mismo tipo provenientes del mismo dispositivo dentro de 10 segundos se combinan en una sola fila, ya que un dispositivo puede enviar múltiples señales para un mismo incidente.
* Los eventos basados en el Acelerómetro se ignoran mientras el vehículo está En movimiento por debajo de 3 km/h. Esto evita marcar como infracción la vibración causada por la carga o el estacionamiento.
* Todas las marcas de tiempo se almacenan en UTC.
  {% endhint %}

## Tabla de salida: processed\_common\_data.rule\_based\_conductor\_events

Cada fila representa una infracción detectada. La tabla está indexada por `device_id`, `device_time`, `rule_id`, y `hw_event_id`.

Varias columnas son copias desnormalizadas de valores almacenados en otro lugar, por lo que las consultas de tablero más comunes no necesitan joins en absoluto: `etiqueta de objeto` proviene del registro del Objeto, y `speed_limit`, `event_comment1`, y `event_comment2` provienen de la regla que produjo el evento.

<table><thead><tr><th width="180">Campo</th><th width="100">Tipo</th><th>Descripción</th></tr></thead><tbody><tr><td><code>device_id</code></td><td>entero</td><td>Identificador del dispositivo.</td></tr><tr><td><code>object_id</code></td><td>entero</td><td>Identificador de Objeto (vehículo o Activo) asociado con el dispositivo en el momento del evento.</td></tr><tr><td><code>etiqueta de objeto</code></td><td>texto</td><td>Nombre legible del Objeto. Ya está desnormalizado en esta tabla, por lo que no se necesita un join a <code>raw_business_data.objects</code> es necesario.</td></tr><tr><td><code>device_time</code></td><td>marca de tiempo</td><td>Marca de tiempo del evento, en UTC.</td></tr><tr><td><code>rule_id</code></td><td>entero</td><td>La Alerta que produjo el evento. Referencias <code>raw_business_data.rules</code>. Establézcalo en <code>0</code> para <code>rpm_exceeded</code> eventos, que no se rigen por reglas. Consulte <a href="#how-rules-shape-the-output">Cómo las reglas dan forma a la salida</a>.</td></tr><tr><td><code>event_type</code></td><td>texto</td><td>Categoría de infracción. Uno de cuatro valores. Consulte <a href="#violation-types">Tipos de infracción</a> a continuación.</td></tr><tr><td><code>hw_event_id</code></td><td>entero</td><td>Código de evento de hardware para infracciones detectadas por el Acelerómetro y el sensor. <code>0</code> para <code>aceleración</code> y <code>Ralentí_soft</code>, que se derivan en lugar de ser reportados por el dispositivo.</td></tr><tr><td><code>event_comment1</code></td><td>texto</td><td>Etiqueta de texto libre copiada de la regla. Se define cuando se configuró la regla y es útil para agrupar eventos por sus propias categorías. Nulo para <code>rpm_exceeded</code>.</td></tr><tr><td><code>event_comment2</code></td><td>texto</td><td>Segunda etiqueta de texto libre copiada de la regla. Nulo para <code>rpm_exceeded</code>.</td></tr><tr><td><code>speed_limit</code></td><td>entero</td><td>El umbral configurado en la regla, desnormalizado de <code>raw_business_data.rules</code>. Para <code>aceleración</code> las reglas este es el límite de velocidad en km/h; para <code>Ralentí_soft</code> las reglas es la tolerancia de ralentí en minutos.</td></tr><tr><td><code>speed_kmh</code></td><td>numeric</td><td>Velocidad del vehículo en el momento del evento, en km/h.</td></tr><tr><td><code>duration_sec</code></td><td>entero</td><td>Duración de la infracción en segundos, para tipos de evento que abarcan un período de tiempo en lugar de ocurrir instantáneamente.</td></tr><tr><td><code>zone_id</code></td><td>entero</td><td>Zona en la que ocurrió el evento, cuando la regla está limitada a zonas específicas. Nulo cuando la regla no tiene zonas asociadas, y también cuando la regla está configurada para activarse fuera de sus zonas. Véase <a href="#zone-scoping">Ámbito de zonas</a>.</td></tr><tr><td><code>zone_label</code></td><td>texto</td><td>Nombre legible de la zona, desnormalizado junto con <code>zone_id</code>.</td></tr><tr><td><code>latitud</code></td><td>doble precisión</td><td>Latitud en grados.</td></tr><tr><td><code>longitud</code></td><td>doble precisión</td><td>Longitud en grados.</td></tr><tr><td><code>extra_value</code></td><td>numeric</td><td>Medición dependiente del contexto, establecida para tipos de evento que registran una lectura distinta de la velocidad. Para <code>rpm_exceeded</code> eventos, la lectura de RPM que activó el evento.</td></tr><tr><td><code>created_at</code></td><td>marca de tiempo</td><td>Cuando la fila fue escrita por la función de actualización. Más tarde que <code>device_time</code> por hasta la duración de un ciclo de actualización.</td></tr></tbody></table>

### Tipos de infracción

La tabla a continuación enumera cada tipo de infracción que la transformación registra, el valor exacto `event_type` almacenado para él y de dónde proviene su umbral. Use la `event_type` el valor de la columna directamente al filtrar o agrupar consultas.

<table><thead><tr><th width="150">valor de event_type</th><th width="230">Qué significa</th><th width="150">hw_event_id</th><th>Umbral</th></tr></thead><tbody><tr><td><code>aceleración</code></td><td>El vehículo superó el límite de velocidad establecido en la regla</td><td><code>0</code></td><td>Por regla, en km/h</td></tr><tr><td><code>brusco_Manejo</code></td><td>Acelerómetro o evento de hardware reportado por el dispositivo: Aceleración brusca, frenado, giros, cambios de carril y violaciones del cinturón de seguridad</td><td><code>900</code>, <code>931</code>, <code>987</code>–<code>991</code>, <code>996</code></td><td>Detectado por el dispositivo. Ignorado por debajo de 3 km/h</td></tr><tr><td><code>Ralentí_soft</code></td><td>Vehículo estacionario con Ignición activada durante más tiempo del que permite la regla</td><td><code>0</code></td><td>Por regla, en minutos</td></tr><tr><td><code>rpm_exceeded</code></td><td>RPM del motor por encima del umbral de la plataforma</td><td><code>9002</code></td><td>Fijo a 5,000 RPM</td></tr></tbody></table>

{% hint style="warning" %}
El `event_type` valores, y el `hw_event_id` la numeración, difieren de la tabla de eventos de desempeño del Conductor que esta transformación reemplaza. Las consultas escritas para la tabla antigua necesitan que se actualicen sus valores de filtro, no solo el nombre de la tabla. En particular, las infracciones del cinturón de seguridad ya no tienen su propio tipo de evento: llegan como `brusco_Manejo` con `hw_event_id = 931`.
{% endhint %}

Los siguientes ejemplos muestran patrones comunes de consulta. La consulta básica devuelve infracciones recientes ordenadas por dispositivo y hora. La segunda agrega la definición de la regla detrás de cada evento. La tercera filtra solo Conducción peligrosa detectada por hardware.

{% tabs %}
{% tab title="Consulta básica" %}
{% code overflow="wrap" expandable="true" %}

```sql
SELECT
    device_id,
    etiqueta de objeto,
    device_time,
    event_type,
    speed_kmh,
    límite de velocidad,
    latitud,
    longitud
FROM processed_common_data.rule_based_Conductor_events
WHERE device_time >= CURRENT_DATE - INTERVAL '7 days'
ORDER BY device_id, device_time;
```

{% endcode %}
{% endtab %}

{% tab title="Con detalles de la regla" %}
{% code overflow="wrap" expandable="true" %}

```sql
SELECT
    e.device_id,
    e.objeto_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 %}

Use un `LEFT JOIN` en lugar de un inner join. `rpm_exceeded` los eventos contienen `rule_id = 0` y no tienen una fila coincidente en `raw_business_data.rules`, por lo que un inner join los descarta silenciosamente.
{% endtab %}

{% tab title="Conducción peligrosa solamente" %}
{% code overflow="wrap" expandable="true" %}

```sql
SELECT
    device_id,
    etiqueta de objeto,
    device_time,
    hw_event_id,
    speed_kmh
FROM processed_common_data.rule_based_Conductor_events
WHERE event_type = 'harsh_driving'
  AND device_time >= CURRENT_DATE - INTERVAL '7 days'
ORDER BY device_id, device_time;
```

{% endcode %}

Filtrado de un solo `event_type` el valor sustituye al long `en` enumere la tabla anterior requerida, ya que ahora todas las infracciones de Acelerómetro y de hardware comparten una sola categoría. Sepárelas con `hw_event_id` cuando necesite la maniobra individual.
{% endtab %}
{% endtabs %}

## Cómo las reglas dan forma a la salida

Las filas de esta tabla no son generadas por la lógica de detección de toda la plataforma. Con la excepción de `rpm_exceeded`, cada evento es el resultado de una Alerta configurada en su cuenta, y la regla determina tanto el umbral como el alcance.

{% stepper %}
{% step %}

#### La regla establece el umbral

Cada regla almacena su umbral en `raw_business_data.rules.maximum`: una velocidad en km/h para `aceleración` reglas, una duración en minutos para `Ralentí_soft` reglas. La transformación copia ese valor en `speed_limit` en cada fila que escribe, para que pueda ver contra qué se midió el vehículo sin volver a unirlo con la regla.
{% endstep %}

{% step %}

#### La regla establece el alcance

Una regla se aplica a los objetos vinculados a ella a través de `rules2objects`, y opcionalmente a las geocercas vinculadas a través de `reglas2zonas`. Un dispositivo fuera de la lista de objetos de una regla no genera eventos para esa regla, por más que se maneje.
{% endstep %}

{% step %}

#### La regla proporciona sus propias etiquetas

`event_comment1` y `event_comment2` son campos de texto libre que se completan cuando se configura la regla. Se copian en cada evento para que los tableros puedan mostrar su propia terminología sin una unión.
{% endstep %}

{% step %}

#### La función de actualización evalúa la ventana

Cada 15 minutos, `actualizar_eventos_de_conductor_basados_en_reglas` reexamina una ventana de 40 minutos de datos recientes y registra cualquier evento que cumpla con los criterios. La ventana es deliberadamente más larga que el intervalo, por lo que los registros que llegan tarde a la plataforma aún se toman en cuenta en una pasada posterior.
{% endstep %}

{% step %}

#### RPM es la excepción

`rpm_exceeded` los eventos no se basan en reglas. Usan un umbral fijo de la plataforma de 5,000 RPM, llevan `rule_id = 0`, y no tienen `event_comment1` o `event_comment2` valores.
{% endstep %}
{% endstepper %}

### Ámbito de zonas

Cuando una regla tiene geocercas asociadas mediante `reglas2zonas`, esas zonas deciden tanto si se registra un evento como si `zone_id` se completa. La geometría de la zona se lee de `processed_common_data.zones_geom`, materializada a partir de `raw_business_data.zones`.

<table><thead><tr><th width="260">Configuración de la regla</th><th width="200">Eventos registrados</th><th>valor de zone_id</th></tr></thead><tbody><tr><td>No hay zonas asociadas</td><td>En todas partes</td><td>Nulo</td></tr><tr><td>Zonas asociadas, <code>zone_inverted = false</code></td><td>Solo dentro de las zonas</td><td>La zona en la que ocurrió el evento</td></tr><tr><td>Zonas asociadas, <code>zone_inverted = true</code></td><td>Solo fuera de las zonas</td><td>Nulo</td></tr></tbody></table>

{% hint style="warning" %}
Un valor nulo `zone_id` es ambiguo por sí solo: significa ya sea que la regla no tenía zonas, o que la regla se activa fuera de sus zonas. Al filtrar con `WHERE zone_id IS NULL` mezclará ambos casos. Haga un JOIN con `reglas2zonas` cuando necesite distinguirlos.
{% endhint %}

<details>

<summary>Constantes fijas de la plataforma</summary>

Estos valores son los mismos para cada cuenta y no se pueden configurar mediante una regla. Los umbrales definidos por reglas se tratan en [Cómo las reglas dan forma a la salida](#how-rules-shape-the-output).

<table><thead><tr><th width="220">Constante</th><th width="160">Valor</th><th>Descripción</th></tr></thead><tbody><tr><td>Velocidad mínima para eventos del Acelerómetro</td><td>3 km/h</td><td>Las infracciones basadas en el Acelerómetro por debajo de esta velocidad se ignoran, para evitar marcar vibración mientras está Aparcado o cargando.</td></tr><tr><td>Umbral de RPM</td><td>5,000 RPM</td><td>Las RPM del motor deben superar este valor para un <code>rpm_exceeded</code> evento sea registrado.</td></tr><tr><td>Ventana de deduplicación de hardware</td><td>10 segundos</td><td>Los eventos de hardware repetidos del mismo tipo del mismo dispositivo dentro de esta ventana se fusionan en uno solo.</td></tr><tr><td>Intervalo de actualización</td><td>15 minutos</td><td>Con qué frecuencia se ejecuta la función de actualización.</td></tr><tr><td>Periodo retrospectivo de actualización</td><td>40 minutos</td><td>Hasta qué punto cada ejecución reexamina los datos, para que no se pierdan los registros que llegan tarde.</td></tr></tbody></table>

</details>

## Personalizar la transformación

Para `aceleración` y `Ralentí_soft`, la personalización no requiere en absoluto un flujo de trabajo. Ambos umbrales se leen de la Alerta, por lo que cambiar la regla cambia lo que la transformación registra a partir del siguiente refresco. Lo mismo aplica al alcance: ajuste los objetos o geocercas vinculados a la regla para cambiar qué Gestión de vehículos y áreas generan eventos.

{% hint style="warning" %}
La función de actualización que llena `processed_common_data.rule_based_conductor_events` no se puede editar directamente. Los umbrales que no dependen de la regla, como el límite de 3 km/h del Acelerómetro o el límite de 5,000 RPM, solo pueden modificarse creando un flujo de trabajo paralelo en Transformation Builder y programándolo como una transformación separada en `datos personalizados procesados`. Eso no cambia la tabla descrita en esta página.
{% endhint %}

Si su escenario operativo necesita diferentes umbrales fijos, comuníquese con **<iotquery@navixy.com>** para solicitar la plantilla de flujo de trabajo correspondiente. Una vez que la tenga, cárguela en [Transformation Builder](https://navixy.com/docs/analytics/es/iot-query/schema-overview/transformation-layer/transformation-builder.md), ajuste los valores relevantes y programe el flujo de trabajo modificado como una transformación personalizada.

## Siguientes pasos

* [**Transformaciones comunes**](https://navixy.com/docs/analytics/es/iot-query/schema-overview/transformation-layer/common-transformations.md): Volver al índice de transformaciones.
* [**Recorridos**](https://navixy.com/docs/analytics/es/iot-query/schema-overview/transformation-layer/common-transformations/trips.md): Una transformación hermana que produce registros de Recorrido de vehículos a partir de datos telemáticos en bruto.
* [**Agregación de datos del sensor**](https://navixy.com/docs/analytics/es/iot-query/schema-overview/transformation-layer/common-transformations/sensor-data-aggregation.md): Una transformación hermana que agrupa las lecturas de sensores en intervalos de tiempo.
* [**Capa de datos brutos**](https://navixy.com/docs/analytics/es/iot-query/schema-overview/bronze-layer.md): Explorar `Seguimiento_datos_principales`, `estados`, y `entradas`, las tablas de origen que alimentan los eventos de Conductor basados en reglas.
* [**Transformation Builder**](https://navixy.com/docs/analytics/es/iot-query/schema-overview/transformation-layer/transformation-builder.md): Aprenda a crear una versión personalizada de esta transformación.
* [**Panel de Calificación de manejo**](https://github.com/Navixy/navixy-iot-query-dashboard/blob/main/schemas/12-driver-performance-dashboard.md): Usa eventos del Conductor basados en reglas para la puntuación de Seguridad de Manejo para toda la Flota.
* [**Panel de impacto del comportamiento**](https://github.com/Navixy/navixy-iot-query-dashboard/blob/main/schemas/13-behavior-impact-dashboard.md): Utiliza eventos del Conductor basados en reglas para rastrear tendencias de comportamiento a lo largo del tiempo.
* [**Panel de Seguridad y Seguridad**](https://github.com/Navixy/navixy-iot-query-dashboard/blob/main/schemas/10-premium-safety-security-dashboard.md): Utiliza eventos del conductor basados en reglas junto con datos de Zona y del Recorrido.
* [**Panel de arrendamiento**](https://github.com/Navixy/navixy-iot-query-dashboard/blob/main/schemas/06-leasing-dashboard.md): Utiliza consultas de Conducción peligrosa y de detección de ralentí de eventos del conductor basados en reglas.


---

# 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/es/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.
