Consultas históricas y gráficos de tendencias

Elige la consulta según la finalidad: un volumen pequeño de muestras originales para diagnosticar, tendencias agrupadas en intervalos para analizar cambios y exportación asíncrona para grandes volúmenes.

Modalidades de consulta

Necesidad	Modalidad	Descripción
Consultar muestras originales	Detalle histórico	Consulta paginada por punto e intervalo de tiempo
Comparar tendencias	Consulta de gráficos	Selecciona automáticamente intervalos temporales y limita los puntos devueltos
Personalizar estadísticas	Consulta de agregación	Configura estadísticas y granularidad temporal por separado para varios puntos
Guardar grandes volúmenes de detalle	Exportación histórica	Genera CSV o ZIP en segundo plano

Los históricos de adquisición, agregación y datos compartidos permiten analizar tendencias. Para puntos compartidos, especifica código de dispositivo y dataKey para evitar mezclar puntos homónimos de distintos dispositivos.

Cómo procesan los datos los gráficos de tendencias

• La granularidad puede seleccionarse automáticamente o definirse mediante unidad e intervalo de tiempo.
• Se admiten media, máximo, mínimo, recuento, primer valor y último valor, según el tipo de datos.
• Los intervalos temporales se alinean con la zona horaria indicada para facilitar comparaciones diarias u horarias.
• Los intervalos sin muestras conservan valores nulos; el gráfico debe mostrar discontinuidades en lugar de ceros.
• Los datos no numéricos no son adecuados para calcular medias; utiliza recuento, primer valor o último valor. La interfaz devuelve advertencias de datos que deben mostrarse junto al gráfico.

Analiza la energía acumulada mediante la diferencia entre los valores inicial y final y teniendo en cuenta los reinicios del contador. No sumes directamente las lecturas acumulativas.

Ejemplo de interfaz

POST /ems-data/chart/query, con el token de inicio de sesión en la cabecera:

{
  "series": [{"dataKey": "demo_temperature", "statistics": ["AVG", "MAX"]}],
  "startTime": "2026-10-01T00:00:00+08:00",
  "endTime": "2026-10-02T00:00:00+08:00",
  "bucketMode": "AUTO",
  "targetPoints": 200,
  "timezone": "Asia/Shanghai"
}

series[].statistics contiene las curvas estadísticas. La respuesta también incluye el intervalo temporal utilizado y warnings. Sustituye el punto de ejemplo por uno real del dispositivo.

El detalle histórico utiliza POST /ems-data/history; la agregación personalizada, POST /ems-data/aggregate/query. Esta última devuelve resultados de éxito o fallo por elemento en data.items[]; no tiene la misma estructura que la interfaz de gráficos.

También puedes consultar y analizar mediante la Skill de gráficos históricos. Para conservar datos a largo plazo, configura Archivado periódico.