Skip to content
omnismith docs

History and Chart

Every entity in Omnismith includes dedicated History and Chart workspace tabs for detailed audit logging and real-time metric analytics.

1. The History Tab (Immutable Audit Log)

Section titled “1. The History Tab (Immutable Audit Log)”

The History tab tracks every modification made to an entity’s dimensions, list options, and references over time.

Features & Controls:

Section titled “Features & Controls:”
  • Before / After Comparison: Shows the exact previous value and new value for changed attributes.
  • Timestamp & Attribution: Displays exact date, time, and user account (or API key) responsible for the update.
  • Date Range Filters: Filter historical changes by custom time windows.
  • Attribute Filtering: Isolate changes to specific fields (e.g. Show only changes to the Status field).

2. The Chart Tab (Time-Series Metric Analytics)

Section titled “2. The Chart Tab (Time-Series Metric Analytics)”

The Chart tab plots numeric Metric attributes over time using TimescaleDB analytics.

Chart Controls:

Section titled “Chart Controls:”
  • Metric Selectors: Select one or multiple metric fields to plot simultaneously (e.g. CPU Usage and Memory Usage).
  • Aggregation Functions:
    • AVG: Average value over each time bucket.
    • SUM: Total cumulative sum.
    • MIN / MAX: Minimum or maximum peak value recorded.
    • FIRST / LAST: Beginning or ending reading in each bucket.
  • Bucket Width: Aggregate readings into 1 minute, 5 minutes, 1 hour, 1 day, or 1 month time buckets.
  • Interactive Tooltips: Hover over plot lines to inspect exact data readings and timestamps.

Entity chart controls showing metric selector, aggregation function, bucket width, and rendered plot

3. Backfilled & Out-of-Order Data Support

Section titled “3. Backfilled & Out-of-Order Data Support”

If your metrics are logged from IoT devices, mobile apps, or background scripts with custom updated_at timestamps:

  • Omnismith automatically inserts backfilled metric readings at their exact historical location in the timeline.
  • Charts and audit logs correctly reflect past events without creating gaps or artificial spikes.

💡 Developer Architecture Note

Section titled “💡 Developer Architecture Note”

[!NOTE] TimescaleDB Hyper-table Architecture: Metric attributes bypass standard transactional tables and write directly into TimescaleDB hyper-tables. This allows Omnismith to process millions of time-series readings per project while delivering sub-second chart rendering times.

Next Steps

Section titled “Next Steps”

[!TIP]

  • Combine metric charts into unified operational portals in Dashboards.
  • Set up automatic alerts when metrics cross thresholds in Automations.