How can we help? 👋

Using the Audit Log

Review a timestamped record of every data change in your portfolio — filter by event type and date, and inspect the details of each change.

Purpose of this article

How to read, filter, and interpret the Audit Log — Scaler's record of every data change made at portfolio or asset level.


Where to find the Audit Log

The Audit Log is available in both the Data Collection Portal and the Analytics Portal, at portfolio and asset level:

  • Portfolio-level — navigate to Portfolio → Audit Log: every change across the portfolio.
  • Asset-level — navigate to Asset → Audit Log: the same log, scoped to a single asset. Breadcrumbs at the top of the page show the asset name and its Scaler asset IDs.
Notion image

How to read a row

Each entry shows:

  • Timestamp — when the change was made
  • Event typeCreate / Update / Delete / Rollback
  • Entity — the record type affected (e.g. Meters, Consumptions, Certifications)
  • Entity ID — the record's numeric ID in Scaler
  • User — who made the change
  • Reason — where the change originated (e.g. in_meters record updated, Imported via spreadsheet, Deleted via import)

Click the eye icon on the right of any row to open the detail panel with the full change context.

💡

About Rollback events: Rollbacks are system-generated, not user-initiated. They appear when a service recorded an audit entry but then hit an internal error before the underlying data change could be persisted — the rollback "undoes" the audit record so the log only reflects changes that actually landed in the database. A Rollback row does not mean a user or Scaler engineer reverted client data.

Notion image

Filtering the log

Two filters control what you see:

  • Event Type — All · Create · Update · Delete · Rollback
  • Date range — start and end date pickers in the top right

Filters combine, so you can narrow to (for example) all deletions in the last two weeks.


What's tracked

Every user-driven change to portfolio data is logged. Entities covered include:

  • Asset records — asset characteristics, reporting data, financial data, building units, physical climate
  • Meters and consumptions — Meters, Meters History, Consumptions
  • Assessments and measures (including roadmap measures)
  • Certifications
  • Emission factor changes
  • Admin overrides of locked consumption periods — the override reason message is recorded alongside the entry
  • Rollback events — system-generated entries that undo a previous audit record when the underlying change failed to persist (see note above)

Changes made via a Scaler Spreadsheet upload appear with a reason of Imported via spreadsheet, Updated via import, or Deleted via import, so you can tell UI edits from imports at a glance.


When to use the Audit Log

  • Investigating unexpected data changes — who changed what, when.
  • Reviewing a colleague's edits during reporting season.
  • Providing a timestamped record to external reviewers.
  • Confirming a Scaler Spreadsheet upload landed as expected.
💡

Tip: Narrow the date range first. In data-heavy portfolios the default view can return a lot of entries.


Additional resources

Did this answer your question?
😞
😐
🤩