Exportación de datos & API (es)

Descripción general

Este artículo de referencia describe todas las métricas disponibles a través de la exportación de datos (CSV) y la API. Las métricas se dividen en dos categorías:

Métricas universales — devueltas para todos los dispositivos eléctricos, incluidos los sensores de corriente y los medidores de potencia.
Métricas de medidores de potencia — devueltas exclusivamente para dispositivos medidores de potencia, proporcionando mediciones eléctricas extendidas.

Consejo: Si una columna aparece en su exportación pero muestra valores NULL, verifique que su dispositivo sea un medidor de potencia y que el tipo de medición correspondiente sea compatible con su configuración de hardware.

Métricas universales

Las siguientes métricas se devuelven para todos los dispositivos eléctricos, tanto en exportaciones CSV como en respuestas de la API.

Nombre de columna	Descripción
`external_id`	Un identificador único asignado al activo seleccionado. Se utiliza para hacer referencia al dispositivo en sistemas externos e integraciones.
`asset_name`	El nombre del activo tal como está configurado en la plataforma.
`Customer`	El nombre del sitio de cliente al que pertenece el activo.
`time_zone`	La zona horaria en la que se encuentra el activo. Consulte aquí para obtener una lista completa de los identificadores de zona horaria admitidos y sus descripciones.
`measured_at`	La marca de tiempo de la medición en hora local (basada en la zona horaria configurada del activo).
`utc_time`	La marca de tiempo de la medición en Tiempo Universal Coordinado (UTC).
`power`	Potencia activa medida. Este campo siempre contiene un valor — si no se recibió ninguna medición del dispositivo, se establece en 0. Para los sensores de corriente, este es un valor calculado derivado de la corriente medida, el factor de potencia configurado y la tensión configurada. Para los medidores de potencia, este valor es medido directamente por el dispositivo.
`energy`	Energía calculada. Derivada directamente del valor de potencia medido o calculado a lo largo del tiempo.

Métricas de medidores de potencia

Las siguientes métricas solo se devuelven para dispositivos medidores de potencia. No aparecerán en exportaciones de sensores de corriente. Algunos campos pueden contener valores NULL si un tipo de medición específico no es compatible con el hardware conectado.

Nombre de columna	Descripción
`active_power_total`	Potencia activa medida. Equivalente al campo power, excepto que muestra los valores faltantes (NULL) cuando no se recibió ninguna medición del dispositivo.
`apparent_power_total`	Potencia aparente medida. Representa la potencia total que fluye en el circuito, incluyendo los componentes activo y reactivo.
`reactive_power_total`	Potencia reactiva medida. Representa la porción de potencia que no realiza trabajo útil.
`current_l1`	Corriente medida en la fase 1 (L1).
`current_l2`	Corriente medida en la fase 2 (L2).
`current_l3`	Corriente medida en la fase 3 (L3).
`current_n`	Corriente del neutro medida.
`current_total`	La corriente de línea trifásica equivalente. Calculada como: apparent_power_total ÷ (√3 × voltage_ll_average).
`power_factor_total`	Factor de potencia medido (rango de -1 a 1). Representa la relación entre potencia activa y potencia aparente. Un valor de 1 o -1 indica una carga puramente resistiva; los valores más cercanos a 0 indican una menor proporción de potencia reactiva.
`voltage_average`	Tensión promedio línea a neutro en todas las fases.
`voltage_l1_l2`	Tensión línea a línea medida entre la fase 1 (L1) y la fase 2 (L2).
`voltage_l1_n`	Tensión línea a neutro medida en la fase 1 (L1).
`voltage_l2_l3`	Tensión línea a línea medida entre la fase 2 (L2) y la fase 3 (L3).
`voltage_l2_n`	Tensión línea a neutro medida en la fase 2 (L2).
`voltage_l3_l1`	Tensión línea a línea medida entre la fase 3 (L3) y la fase 1 (L1).
`voltage_l3_n`	Tensión línea a neutro medida en la fase 3 (L3).
`voltage_ll_average`	Tensión promedio línea a línea en todos los pares de fase.

Notas adicionales

Valores NULL vs. cero

Existe una distinción importante entre los campos power y active_power_total:

power siempre contendrá un valor numérico. Las mediciones faltantes se representan como 0.
active_power_total puede contener NULL cuando no se recibió ninguna medición, lo que le permite distinguir entre una lectura genuinamente cero y un punto de datos faltante.

Sensores de corriente vs. medidores de potencia

Algunas métricas se calculan de manera diferente según el tipo de dispositivo:

Sensores de corriente calculan la potencia indirectamente usando la corriente medida combinada con la tensión y el factor de potencia configurados.
Medidores de potencia miden la potencia activa directamente y proporcionan un conjunto más completo de mediciones eléctricas, incluyendo tensiones y corrientes por fase y factor de potencia.

Cálculo de energía

El campo energy se deriva del campo power mediante integración temporal. Refleja el consumo de energía acumulado durante el intervalo de medición.