Skip to content

Historian writer ​

Optional separate process. The runtime rotates the spool into ready/; the writer drains those files into durable storage.

Env ​

VariableMeaning
VION_SPOOL_DIRRequired. Same spool root as the runtime
VION_HISTORIANcolumnar or postgres
VION_HISTORIAN_DIRColumnar VIONCOL1 root
VION_HISTORIAN_DATABASE_URLHistorian PostgreSQL (not the engineering DB)
VION_HISTORIAN_RETENTION_DAYSDrop older samples (source_ts)
VION_HISTORIAN_RETENTION_SECSSame window in seconds (tests; secs wins if both set)

Embedded path ​

If runtime has VION_HISTORIAN_DIR, it flushes its own spool to columnar files. Do not run both embedded flush and historian-writer on the same spool.

History reads: runtime GET /api/v1/tags/{id}/history. With VION_HISTORIAN_DATABASE_URL the runtime reads PG (it does not append).