Input data format requirements
Below are the data format requirements for sending time series data to Eyer
Eyer supports the ingestion of time series data. Time series data consists of sequential data points recorded at successive time intervals. Each data point includes a timestamp along with one or more measured values, enabling the tracking and analysis of metric changes over time.
All time series data must be provided in JSON format. Examples are shown below. Whenever possible, we recommend using “flatter” structures with limited nesting to ensure clarity and optimal performance.
Timestamps should always be in either epoch (
1745352000000) or ISO (2025-11-11T11:00:00Z) format.Eyer can process time series data at any interval (e.g., seconds, minutes). However, we recommend aggregating your data to a one-minute resolution before sending it to Eyer. For instance, if metrics are sampled every second, you may compute a one-minute average locally and transmit that aggregated value. This is because Eyer’s minimum operating resolution is one minute.
If local aggregation to one-minute intervals is not feasible, you may send unaggregated data directly. Eyer will automatically perform the necessary aggregation to per minute.
If no aggregation function is specified for a metric (e.g., average, max, sum, count), Eyer will assume average by default.
JSON time series examples
{
"metrics":
[
{
"fields":
{
"disk_reads_mean": 1.0121461361787716,
"disk_writes_per_sec_mean": 0.8571885607181682,
"last_Run_mean": 1740047577489,
"log_bytes_flushed_mean": 3.9596305549082618,
"logical_reads_mean": 914.9966524003087,
"total_sessions_mean": 14,
"waits_total": 0,
"waits_total_mean": 7.3
},
"name": "dbwatch",
"tags":
{
"host": "testmachine1",
"instance": "Database1",
"url": "http://localhost:8080/dashboard/dbWatch%2001/data/HkRmUaLz0Z.telegraf.json"
},
"timestamp": 1740047760
}
]
}
{
"metrics":
[
{
"fields":
{
"ifHCInOctets": 0,
"ifHCOutOctets": 0
},
"name": "Octets_field",
"tags":
{
"agent_host": "192.168.88.54",
"host": "DESKTOP-S01F7CP",
"hostname": "US-8-150W",
"ifName": "3/26"
},
"timestamp": 1741167360
},
{
"fields":
{
"ifHCInOctets": 0,
"ifHCOutOctets": 0
},
"name": "Octets_field",
"tags":
{
"agent_host": "192.168.88.54",
"host": "DESKTOP-S01F7CP",
"hostname": "US-8-150W",
"ifName": "3/11"
},
"timestamp": 1741167360
},
{
"fields":
{
"ifHCInOctets": 0,
"ifHCOutOctets": 0
},
"name": "Octets_field",
"tags":
{
"agent_host": "192.168.88.54",
"host": "DESKTOP-S01F7CP",
"hostname": "US-8-150W",
"ifName": "3/19"
},
"timestamp": 1741167360
}
]
}
[
{
"fields":
{
"value": 100
},
"name": "prometheus",
"tags":
{
"field_type": "go_gc_gogc_percent",
"host": "eyer-server-4.local",
"url": "http://localhost:9100/metrics"
},
"timestamp": 1763897800
},
{
"fields":
{
"value": 9223372036854776000
},
"name": "prometheus",
"tags":
{
"field_type": "go_gc_gomemlimit_bytes",
"host": "eyer-server-4.local",
"url": "http://localhost:9100/metrics"
},
"timestamp": 1763897800
},
{
"fields":
{
"value": 7
},
"name": "prometheus",
"tags":
{
"field_type": "go_goroutines",
"host": "eyer-server-4.local",
"url": "http://localhost:9100/metrics"
},
"timestamp": 1763897800
},
{
"fields":
{
"value": 1
},
"name": "prometheus",
"tags":
{
"field_type": "go_info",
"host": "eyer-server-4.local",
"url": "http://localhost:9100/metrics",
"version": "go1.23.7"
},
"timestamp": 1763897800
}
]