Foundations

Everything you do is recorded

What the audit log captures, who can read it, and why a permanent record is on your side.

6 min · All staff · lesson v1

Every meaningful action in ChartVoyant is written to a permanent, tamper-evident log: who did it, what they did, which record, when, and whether it succeeded. Opening a chart counts. Searching for a patient counts. Signing a note, booking an appointment, running an eligibility check, reading the audit log itself — all recorded.

New users sometimes hear that as surveillance. It's worth reframing, because it mostly protects you.

Why a permanent record is on your side

It answers accusations. "Nobody told me about that result" is answerable when the record shows who saw what, when.

It makes a mistake fixable instead of mysterious. When a wrong value appears in a chart, the trail shows where it came from — a fax, a kiosk answer, a typo at the desk — so it can be corrected at the source.

It's a legal requirement, and one your practice must be able to demonstrate. HIPAA expects covered entities to record and review access to health information. A practice without that record has a problem no amount of good intentions fixes.

It keeps the AI accountable. Every action an agent takes is recorded the same way as a human's, with the actor marked as an agent. There is no path by which something happens to a chart and nobody can tell what caused it.

Reading the log

The full search lives in Admin → Audit search, so most staff won't open it day to day — but knowing what it holds tells you what your own footprint looks like.

  1. The card explains itself: Who did what, and when — the practice's tamper-evident record, for compliance review.

    Four quick views get you started without touching a filter:

    • Sign-ins & security — account events over the last week
    • Failed sign-ins — unsuccessful attempts over 30 days
    • Chart access — who opened a patient chart today
    • Everything today — the whole trail, unfiltered
    ChartVoyant screenshot
  2. Results come back as five columns: When, Who, What happened, Record, Outcome.

    What happened is in plain English — Opened patient chart, Signed a note, Booked an appointment, Checked insurance eligibility — with the raw system action underneath in monospace. Both are shown deliberately: the plain sentence is for people, and the raw string is what a compliance reviewer needs.

    Click a person to see everything they did. Click a record to see everything that happened to it.

    ChartVoyant screenshot

The per-record trail

You don't need the Admin console to see a single record's history. A fax in the Fax Inbox has View audit trail; an AI draft in the Clinician Console has View audit trail for this AI draft. Both show four columns — When, Action, Actor, Outcome — under a badge reading Tamper-evident audit chain: VALID ✓.

That badge is the whole point of the word "tamper-evident". The entries are chained together, so altering or deleting one breaks the chain and the badge turns to Audit chain: INVALID ✗. History can't be quietly rewritten.

Audit log versus Action Notes

They look similar and serve opposite purposes.

Audit logAction Notes
Written byThe system, automaticallyYou, deliberately
ForCompliance, investigation, evidenceThe next colleague to pick this up
ContainsActor, action, record, time, outcomeWhatever you type
Can be editedNoIt's an append-only log; you can pin an entry

If you want a colleague to know something, write an Action Note. Don't assume they'll go read the audit trail — that's not what it's for.

What your administrator can also do

Export the audit log to CSV for a date range, if the practice has enabled export. The export is itself logged.

Run the unusual-access report — flagging anyone who opened more than a set number of distinct charts in a day. It's a display-only report: a human reviews it and nothing is auto-actioned. The threshold is set by your practice.

Declare a retention period, with a HIPAA minimum of six years. Worth being precise about what that setting does: it declares policy. No audit record is deleted by it.

What usually goes wrong

Looking up someone you know. Curiosity about a neighbour, a colleague, or a celebrity patient is the most common cause of an access violation in healthcare, and Chart access shows exactly who opened which chart today. Open charts you have a reason to open.

Sharing a login. The log names the account, so a shared login attributes your colleague's actions to you — and yours to them.

Assuming a delete removes the history. It doesn't. The record of the change survives the change.

**Expecting the audit log to explain why.** It records what happened, not the reasoning. If a decision needs explaining, write it in the chart or in an Action Note at the time.

Check yourself

No score, no account — just make sure you can answer these before you move on.

  1. Reading the audit log — is that itself recorded?

    Show the answer

    Yes. Opening it writes an audit.viewed row, and exporting writes audit.exported. That's why the Audit search panel starts empty instead of auto-running a search: nobody wants a stray page load in the compliance record. The card says so outright — Reading this log is itself recorded.

  2. A patient claims their record was altered after the fact. How does ChartVoyant answer that?

    Show the answer

    The audit trail is a chained, tamper-evident record. A per-record trail shows Tamper-evident audit chain: VALID ✓ when the chain verifies, and would show INVALID ✗ if any entry had been altered or removed. Someone editing history is detectable rather than invisible.

  3. Are Action Notes the same as the audit log?

    Show the answer

    No, and the difference matters. Action Notes are what you deliberately write for colleagues — "1ST ATTEMPT-LVM". The audit log is written automatically by the system whether or not anyone types anything. One is communication; the other is evidence.