Audit Event Types Reference
Every security-relevant action in Athena is written to the audit trail
as an event with a stable event type — a short identifier like
LoginFailure, AgentRevoked, or DeploymentExecuted. This page
is the catalog of those event types, grouped by area and tagged with the severity Athena assigns.
Use it to build SIEM correlation rules and alerts, to decide what to watch for, and to filter the
audit log to exactly the activity you care about.
The same event types appear in the on-box audit log, in the console's audit view, and — when you turn on audit forwarding — in the copy streamed to your SIEM. The event-type string is stable, so a search or alert you write against it keeps working as the product evolves.
Anatomy of an event#
Beyond the event type, each audit record carries a consistent set of fields. These are the fields you filter, group, and correlate on in a SIEM:
| Field | Meaning |
|---|---|
| Event type | The stable identifier for what happened (the values catalogued below). |
| Severity | Information, Warning, Error, or Critical (see Severity levels). |
| Timestamp | When the event occurred; a UTC form is also emitted for SIEM ingestion. |
| Username | The actor who triggered it — blank for system events. |
| IP address | The client source IP — blank for agent-side or system events. |
| Agent | Agent ID and hostname when the event concerns a specific agent. |
| Resource type / ID | What was acted on — for example User, Agent, Deployment, Certificate, Settings. |
| Action | The verb — Create, Update, Delete, Execute, Login, and so on. |
| Outcome | Success or failure, plus an error message when it failed. |
| Description | A human-readable summary of the event. |
| Old / new value | Before-and-after values on updates, so a change is self-documenting. |
| Event ID & schema version | A unique ID per event and a schema version, so downstream searches stay stable. |
For how those fields map onto the wire when forwarding to a collector (RFC 5424, RFC 3164, CEF, or JSON), see Message formats.
Severity levels#
Athena assigns each event one of these severities. Failures are generally escalated above their success counterpart — a successful login is Information, a failed one is Warning. In the audit view and in the PowerShell and REST filters, a severity filter is a minimum: choosing Warning returns Warning, Error, and Critical.
| Severity | Use it for |
|---|---|
| Information | Normal, successful activity — routine operations and reads worth recording. |
| Warning | Something to notice — a failed login, a revocation or deletion, an unattended remote session, an off-box copy of credentials being used. |
| Error | An operation failed — a deployment, command, or scheduled job that did not succeed. |
| Critical | The highest-risk events — uploading a new agent executable, pushing an agent update to a machine, turning automatic remediation on or off for a compliance rule, or a blocked external script-injection attempt. |
The event catalog#
The tables below list the event types Athena records, by area. Severity is the level assigned when the event is written; where an action has both a success and a failure form, both are shown.
Authentication & sessions#
| Event type | Severity | When it fires |
|---|---|---|
LoginSuccess | Information | A user signs in. The provider that authenticated (Local or LDAP) is noted in the description. |
LoginFailure | Warning | A sign-in attempt is rejected. The failure is deliberately generic to avoid revealing whether an account exists. |
Logout | Information | A user signs out; the reason (for example an idle timeout) is recorded when there is one. |
Users & access#
| Event type | Severity | When it fires |
|---|---|---|
UserCreated | Information | A new user account is created. |
UserUpdated | Information | A user account's details are changed. |
UserDeleted | Warning | A user account is deleted. |
UserRoleChanged | Warning | A user's role is reassigned; the old and new role are recorded. |
UserEnabled / UserDisabled | Information / Warning | A user account is enabled or disabled. |
RolePermissionGranted / RolePermissionRevoked | Warning | A permission is added to or removed from a role. The change applies immediately to every user holding that role — see Permission Model. |
PasswordChanged | Information | A user changes their own password successfully. |
PasswordChangeFailed | Warning | A self-service password change is rejected (for example, the current password was wrong). |
PasswordReset | Warning | An administrator resets another user's password. |
ProfileUpdated | Information | A user edits their own profile (display name or email). |
ProfileUpdateFailed | Warning / Error | A self-service profile edit fails. |
Agents & certificates#
| Event type | Severity | When it fires |
|---|---|---|
AgentRegistered | Information | An agent enrolls and receives its identity. |
AgentUpdated | Information | An agent's editable details are changed. |
AgentTagsUpdated | Information | An agent's manual tags are replaced; the new tag list is in the description. |
AgentRevoked | Warning | An agent's certificate is revoked so it can no longer connect. |
AgentDeleted | Warning | An agent record is removed. |
AgentUninstallCodeIssued | Warning | A tamper-protection uninstall code is issued for an agent; records who, the expiry and the code's last four characters. |
AgentUninstallCodeUsed | Warning | An agent reports that it accepted a valid uninstall code and is uninstalling. |
AgentTamperDetected | Critical | An agent reports a tamper attempt (its protections removed, or an uninstall refused); the action holds the event kind. |
AgentLocalCheckInRequested / AgentLocalInventoryRequested / AgentLocalPolicyStatusRequested / AgentLocalScanRequested / AgentLocalUpdateScanRequested / AgentLocalConnectivityTestRun / AgentLocalCertificateRefreshRequested / AgentLocalCacheCleared | Information (Warning when failed or refused) | Someone at the computer ran an action from the Athena Agent Control Panel applet: one type per action. The user is the Windows account; a refusal records its reason (AdminRequired, RateLimited, NoServerConnected, NotEnabled), once per user, action and reason per cooldown window. |
AgentRemovedUnexpectedly | Critical (Warning after a valid code) | An agent went offline right after a tamper event or code use and did not come back. |
AgentMaintenanceEnabled / AgentMaintenanceDisabled | Information | Maintenance mode is turned on or off for an agent. |
AgentMaintenanceChanged | Information | Maintenance mode is changed through the agents REST API. Depending on where the change was made, a maintenance change is recorded under this type or under the Enabled/Disabled pair above — filter on all three to see every one. |
AgentRestartRequested | Warning | Someone asks Athena to restart one or more computers. One event per request; the description gives the delay, who asked, and which devices were sent the restart, offline, not supported, failed or not found. |
AgentUnattendedChanged | Information | An agent's unattended-access setting is changed. |
InventoryRefreshRequested | Information | Someone asks agents to collect inventory now, or runs Scan for Missing Updates. One event per request; the action is CollectInventory or UpdateScan, and the description lists who asked and which devices were sent the request, offline, failed or not found. |
AgentRecordPolicyChanged | Information | An agent's session-recording policy is changed. |
AgentRustDeskConsentChanged | Information | An agent's RustDesk consent setting is changed. |
AgentUpdatePushed / AgentUpdatePushFailed | Critical | An agent update is pushed to a machine — Critical either way, because it delivers new code to the endpoint. |
AgentUpdateCompleted / AgentUpdateFailed | Information / Error | An agent reports the result of an update. |
AgentMigrationStarted / AgentMigrationStartFailed | Warning / Error | An agent is directed to move to a different server. |
AgentInstallScriptGenerated | Information | An install script for deploying the agent is generated. |
AgentBundleDownloaded | Information | An agent install bundle is downloaded. |
CACreated | Information | The root certificate authority is created. |
CAExtended | Information | The root CA's validity is extended; existing agent certificates stay valid. |
CARegenerated | Information | The root CA is regenerated with a new key; existing agent certificates are revoked. |
VaultReencrypted | Information | Written just before CARegenerated: the stored secrets (credential, RustDesk and BitLocker passwords and PINs) were re-encrypted under the new CA key. The description gives the number of secrets. See What regenerate does to stored secrets. |
AgentRevoked, AgentDeleted, and CARegenerated all
change what can connect to your server. See Certificates &
PKI and Retiring & Removing Agents for the
operations behind them.
Agent binaries#
| Event type | Severity | When it fires |
|---|---|---|
AgentBinaryUploaded | Critical | A new agent executable is uploaded — high-risk, because it becomes deployable code. |
AgentBinaryActivated | Warning | An uploaded binary is made the active version that agents receive. |
AgentBinaryDeactivated | Warning | A binary is stood down from active use. |
AgentBinaryDeleted | Warning | An uploaded binary is removed. |
Deployments, commands & jobs#
| Event type | Severity | When it fires |
|---|---|---|
DeploymentCreated / DeploymentUpdated / DeploymentDeleted | Information | A software deployment is defined, edited, or removed. |
DeploymentStarted | Information | A deployment begins dispatching to its targets. |
DeploymentPaused / DeploymentRetried | Information | A running package deployment is paused, or a deployment is retried. |
DeploymentCancelled | Information | A deployment is cancelled. |
DeploymentFailed | Information | A package deployment is marked failed as a whole. Per-machine failures are recorded separately as DeploymentExecuted at Error. |
DeploymentExecuted | Information / Error | A deployment runs on an agent — Error on failure. |
CommandCreated | Information | A remote command is queued. |
CommandStarted | Information | A queued command is dispatched to its agent. |
CommandExecuted | Information / Error | A remote command runs on an agent — Error on failure. |
CommandRetried | Information | A command is re-run. |
CommandCancelled | Information | A remote command is cancelled. |
CommandDeleted | Information | A command record is removed. |
CommandFailed:NoCredential / CommandFailed:CredentialDecryptFailed | Information | A command set to run as a stored credential was refused at execution time — no credential was attached, or it could not be decrypted. The command is not run as SYSTEM instead. |
ScheduledJobCreated / ScheduledJobUpdated / ScheduledJobDeleted | Information | A scheduled job is created, changed, or removed. |
ScheduledJobPaused / ScheduledJobResumed | Information | A scheduled job is paused or resumed. |
ScheduledJobTriggered / ScheduledJobTriggeredManually | Information | A job is run on demand — ScheduledJobTriggered from the Scheduler page, ScheduledJobTriggeredManually through the REST API or PowerShell. |
ScheduledJobExecuted | Information / Error | A scheduled job runs; the affected/success/failure counts are recorded. |
Compliance, scans & reports#
| Event type | Severity | When it fires |
|---|---|---|
ComplianceRuleCreated / ComplianceRuleUpdated / ComplianceRuleDeleted | Warning | A compliance rule is created, changed, or removed. |
ComplianceBaselineCreated / ComplianceBaselineUpdated / ComplianceBaselineDeleted | Warning | A compliance baseline is created, changed, or removed. |
ComplianceBaselineMembershipChanged | Warning | The set of rules inside a baseline is changed. |
BaselineAssignmentCreated / BaselineAssignmentUpdated / BaselineAssignmentDeleted | Warning | A baseline is assigned to, or unassigned from, a collection. |
ComplianceAutoRemediateActivated / ComplianceAutoRemediateDeactivated | Critical | Automatic remediation is switched on or off for a rule. Activating it lets the rule's remediation script run on every agent the rule's baselines are assigned to. |
ComplianceRemediationSucceeded / ComplianceRemediationFailed | Warning / Error | An agent reports that it ran a rule's remediation script — Succeeded when the re-check then passed, Failed when the script errored or the finding remained. |
ComplianceEvaluateNow | Warning | An on-demand compliance evaluation is triggered. |
ScanDefinitionCreated / ScanDefinitionUpdated / ScanDefinitionDeleted | Information | A scan definition is created, changed, or removed. |
ReportDefinitionCreated / ReportDefinitionUpdated | Information | A saved report definition is created or changed. |
ReportDefinitionDeleted | Warning | A saved report definition is removed. |
Tagging rules, monitors & alerts#
| Event type | Severity | When it fires |
|---|---|---|
TaggingRuleCreated / TaggingRuleUpdated / TaggingRuleDeleted | Warning | An automatic tagging rule is created, changed, or removed. Warning because a tag rule changes which machines a command, deployment, or scheduled job reaches. |
MonitorCreated / MonitorUpdated / MonitorDeleted | Warning | A monitor is created, changed, or removed. |
MonitorEnabled / MonitorDisabled | Warning | A monitor is switched on or off — disabling one silently stops alerting for the machines it watched. |
MonitorRun | Warning | An on-demand run of a monitor is triggered; the number of targeted agents is recorded. |
AlertLifecycle | Information | An alert is acknowledged or resolved by a user. The Action field says which. |
AlertDeleted | Warning | An alert is deleted. The alert's severity, state, monitor, and machine are written into the description, because after deletion this row is the only record the alert existed. |
Collections & credentials#
| Event type | Severity | When it fires |
|---|---|---|
CollectionCreated / CollectionUpdated | Information | A collection is created or changed. |
CollectionDeleted | Warning | A collection is removed. |
CredentialCreated | Information | A credential is added to the vault. |
CredentialUpdated | Information / Warning | A credential is edited — Warning when the secret itself changes. |
CredentialDeleted | Warning | A credential is removed from the vault. |
CredentialUsed | Information | A stored credential is used to authenticate an operation. |
CredentialSecretRevealed | Warning | The value of a Secret credential was shown to a user: "Secret '<name>' revealed by <user>". The value is never recorded, and if this entry cannot be written the value is withheld. See Revealing a Secret. |
Registration tokens#
| Event type | Severity | When it fires |
|---|---|---|
TokenCreated | Information | An enrollment token is issued. |
TokenRevoked | Information | A token is revoked before it expires. |
TokenDeleted | Information | A token record is removed. |
Settings sync#
With Settings Sync, the sending server records the push and the receiving server records what it did with it — so look on both sides.
| Event type | Severity | When it fires |
|---|---|---|
SettingsSyncTokenCreated / SettingsSyncTokenRevoked / SettingsSyncTokenDeleted | Information | A sync token — the credential a receiving server issues so another server may push settings to it — is created, revoked, or removed. |
SettingsSyncPeerCreated / SettingsSyncPeerUpdated / SettingsSyncPeerDeleted | Information | A push target (peer) is added, edited, or removed on the sending server. |
SettingsSyncTrustedCaAdded / SettingsSyncTrustedCaDeleted | Information | On the sending server, a receiver's CA certificate is added to or removed from Settings → Sync → Trusted CAs. The description names the CA and its SHA-256 fingerprint. See Trusting a peer server. |
SettingsSyncPushed | Information | The sending server pushes settings to a peer. A failed push is recorded under the same type with a failed outcome and the error in the description. |
SettingsSyncApplied | Information / Warning | The receiving server applies a push — Warning when only some of the setting groups were applied. |
SettingsSyncRejected | Warning | The receiving server refuses a push. |
Remote sessions & recordings#
| Event type | Severity | When it fires |
|---|---|---|
ScreenShareSessionStarted | Information / Warning | A screen-share session begins — Warning when it is an unattended session. |
ScreenShareSessionEnded | Information | A screen-share session ends. |
ScreenShareClipboardSynced | Information | Clipboard content is synced during a session. |
VideoStreamRequested | Information | A remote video stream is requested. |
VideoStreamDenied | Warning | A remote video stream request is denied. |
RelayProvisioned | Warning | A screen-share relay (TURN) is provisioned. |
RecordingStarted | Information | Capture of a session recording begins. |
RecordingFinalized | Information | A recording is completed and saved. |
RecordingPartial / RecordingFailed | Warning | A recording was saved only in part, or could not be saved. |
RecordingViewed | Information | A saved session recording is viewed. |
RecordingDownloaded | Warning | A saved session recording is downloaded off the server. |
RecordingDeleted | Warning | A recording is deleted by a user. |
RecordingPurged | Information | A recording is removed automatically by the retention policy. |
RustDesk remote access#
The RustDesk session events mirror the screen-share ones above, so a SIEM rule written for one remote path can be extended to the other.
| Event type | Severity | When it fires |
|---|---|---|
RustDeskSessionStarted / RustDeskSessionEnded | Information | A RustDesk session begins or ends. |
RustDeskSessionReconnected | Information | A live session re-established its connection without asking the person at the machine again, because they had already consented to this session. Count these against the matching Started row to see how many connections one consent covered. |
RustDeskSessionDenied | Warning | A RustDesk session attempt is refused. |
RustDesk.PasswordSet / RustDesk.GlobalPasswordSet | Information | A RustDesk access password is set for one agent, or globally. |
RustDesk.RotationScheduleUpdated / RustDesk.GlobalRotationScheduleUpdated | Information | The password-rotation schedule is changed for one agent, or globally. |
RustDesk.InstallRequested | Information | A RustDesk install is requested on an agent. |
RustDesk.ConfigSent | Information | RustDesk configuration is sent to an agent. |
RustDeskRecordingViewed / RustDeskRecordingDownloaded | Information | A RustDesk recording is viewed or downloaded. |
Remote file browser#
Every action taken in the remote file browser on an agent is recorded. Reads are Information; anything that changes the endpoint's file system is Warning.
| Event type | Severity | When it fires |
|---|---|---|
FileBrowser.FileRead | Information | A file on an agent is opened for viewing. |
FileBrowser.FileWrite | Warning | An edited file is saved back to an agent. |
FileBrowser.FileCreate / FileBrowser.DirectoryCreate | Warning | A new file or folder is created on an agent. |
FileBrowser.FileDelete / FileBrowser.DirectoryDelete | Warning | A file or folder is deleted from an agent. |
Server, database & security#
| Event type | Severity | When it fires |
|---|---|---|
ServerStarted | Information | The server starts up. |
ServerStopping | Warning | The server begins a clean shutdown. |
ServerRestartRequested | Warning | An administrator restarts the server from Settings or POST api/system/restart; written before the shutdown, with the user and IP address. See Restarting the Server. |
ServerStopped | — | Legacy: no longer written (shutdown is now recorded as ServerStopping), but still offered in the filter so older rows stay searchable. |
SettingsChanged | Information | A server setting is changed; the old and new values are recorded. |
GettingStartedGuideHidden / GettingStartedGuideShown | Information | An admin hides the Dashboard’s Getting started checklist for everyone on the server, or shows it again. |
DatabaseBackup | Information | A database backup is taken. |
DatabaseOptimize | Information | A database optimization runs. |
EmergencyUnlock | Warning | An emergency unlock is performed. |
EmergencyIpBan | Warning | An IP address is banned via the emergency controls. |
CspViolation | Warning | A Content Security Policy violation is reported. |
CspViolationAttack | Critical | A CSP report is classified as an external script-injection attempt and blocked. |
HtmlSanitized | Warning | Unsafe HTML was stripped from an in-app Help document before it was displayed. |
System health & metrics#
These events cover the System Health view and the optional
/metrics scrape token. They are recorded with the resource type Metrics, and the
Action field shows how each one happened.
| Event type | Severity | When it fires |
|---|---|---|
SystemHealthViewed | Information | Someone opens Settings → System Health (Action View), or the System Health report is read over the REST API at GET /api/metrics/summary (Action Read, one event per request). |
MetricsScrapeTokenGenerated | Information | A /metrics scrape token is generated or rotated, in the console or with POST /api/metrics/scrape-token. From then on, every scrape must send the token. |
MetricsScrapeTokenRevoked | Information | The scrape token is revoked, in the console or with DELETE /api/metrics/scrape-token. Scrapes no longer need a token, but any IP allow-list still applies. |
Individual Prometheus scrapes of /metrics are counted in the metrics output, not written
to the audit trail, so a busy scraper does not flood the log. To track who manages scraping access,
filter on the two scrape-token events above.
Licensing#
These events give you a durable record of every license change and every operation the license refused.
| Event type | Severity | When it fires |
|---|---|---|
LicenseUploaded | Warning | A license file is uploaded — whether or not it was accepted. A rejected upload is recorded under the same type with a failed outcome, so repeated failed attempts sit next to the one that succeeded. |
LicenseExpiring | Warning | Written once as the license enters each stage of the expiry countdown (14, 7, and 3 days out, then the grace period) — not on every check. |
LicenseLapsed | Error | Written once when the server stops being licensed — the grace period ended, or there is no usable license at all. The description says which. Recorded with a failed outcome. |
LicenseBlocked | Warning | The license refused an operation — for example enrolling an agent past the agent limit, creating a user past the account limit, dispatching work on a lapsed license, or using a feature the license does not include. The Action field names which operation was refused. |
Module event types#
Optional modules add their own event types to the catalog, and they appear in the Audit Log filter only when the module is present. The console shows each with a friendly name; the stored identifier is the one below. See each module's page for severities and details.
| Module | Event types |
|---|---|
| BIOS Configuration | bios.baseline-changed, bios.remediation-requested, bios.remediation-result, bios.password-requested, bios.password-result |
| BitLocker | bitlocker.key-escrowed, bitlocker.key-revealed, bitlocker.key-reveal-failed, bitlocker.policy-changed, bitlocker.assignment-changed, bitlocker.override-changed, bitlocker.enforcement-applied, bitlocker.enforcement-failed, bitlocker.decrypt-sent, bitlocker.enforcement-toggled, bitlocker.key-rotation-requested, bitlocker.key-rotated, bitlocker.key-rotation-failed, bitlocker.compliance-baseline-changed, bitlocker.pin-changed, bitlocker.pin-revealed, bitlocker.pin-pushed |
| FileVault | filevault.key-escrowed, filevault.key-revealed, filevault.key-reveal-failed, filevault.key-rotation-requested, filevault.key-rotation-failed |
| Power Management | power.policy-changed, power.assignment-changed, power.enforcement-toggled, power.apply-requested, power.apply-incomplete, power.status-failed |
| Sysmon | SysmonConfigUploaded, SysmonConfigDeployed, SysmonConfigurationRenamed, SysmonEnforcementEnabled, SysmonEnforcementDisabled, SysmonEnforcementChanged |
No BitLocker event ever contains a recovery password or PIN — a reveal row records who, which machine and volume, and the reason given, never the value.
For Power Management, only power.apply-requested records a change actually sent to a
machine. Policy, assignment and switch events record the desired state only. Both switches write
power.enforcement-toggled at Warning severity, and the resource id shows which one changed
(EnforcementEnabled or AutoConvergeEnabled). Applies started automatically are
recorded under the user name power.autoconverge rather than an operator's name.
power.apply-incomplete is written once per result, never once per setting.
New capabilities add their own event types over time. The tables above cover the current set;
treat the audit view's own event-type filter (or
Get-AthenaAuditEventTypes) as the live source of truth for what a given build can emit
(see Filtering by event type).
Filtering by event type#
In the console, open Audit Log and use the Event Type and
Severity filters to narrow the view — for example, show only
LoginFailure at Warning and above over the last day. The audit view populates its
event-type list from the server, so it always matches your build.
The list offers every event type the server can write — including module types —
plus any other type actually found in your stored audit history (for example a legacy type from an
older version). A type that has never occurred is still offered, so you can confirm that something
never happened. In the list, identifiers are spaced out for readability — AlertDeleted
shows as Alert Deleted and FileBrowser.FileRead as File Browser: File
Read — but filters, exports, and SIEM rules always use the exact identifier, which is never
translated.
To get the same list programmatically, call the catalog endpoint. The optional
fromDate / toDate parameters limit the range searched for observed types:
GET api/Audit/event-types
GET api/Audit/event-types?fromDate=2026-01-01
From PowerShell, Get-AthenaAuditEventTypes returns the same list:
# Every event type related to the remote file browser
Get-AthenaAuditEventTypes | Where-Object { $_ -like "FileBrowser.*" }
Filtering from PowerShell#
The PowerShell module queries the same trail. Filter by event type, severity, actor, text, and date range:
# Failed logins in the last 24 hours
Get-AthenaAudit -EventType "LoginFailure" -StartDate (Get-Date).AddDays(-1)
# Everything at Warning severity or above this week, all pages
Get-AthenaAudit -Severity Warning -StartDate (Get-Date).AddDays(-7) -All
# Deployment activity for a specific operator
Get-AthenaAudit -Username "jsmith" -Search "deployment"
-Severity is a minimum, mirroring the console. -StartDate and
-EndDate also accept the -FromDate / -ToDate aliases. Add
-All to page through every match instead of a single page.
Filtering over the REST API#
The same filters are available on the read API. Every audit endpoint requires the
audit.view permission (see Permission Model) — reading
the trail does not require any right to change settings.
| Request | What it does |
|---|---|
GET api/Audit?eventType=LoginFailure&severity=Warning | Page through the audit log filtered by event type and minimum severity. Also supports username, fromDate, toDate, success, search, page, and pageSize. |
GET api/Audit/recent?count=10 | The most recent events, for a quick pulse (default 10). |
GET api/Audit/event-types | Every cataloged event type plus any type observed in the store; optional fromDate / toDate. |
GET api/Audit/stats | Summary counts: total events today and this week, successful and failed logins today, and Warning and Error-or-higher events this week. |
For the on-disk file locations, the audit providers, and how to forward this trail to a SIEM, see Audit & SIEM and Audit Forwarding to SIEM.
Related#
- Audit & SIEM — the audit trail, its providers, and how to query it.
- Audit Forwarding to SIEM — stream these events to a syslog collector or SIEM.
- Roles & Permissions — who can read the audit trail.
- Security Settings — lockout, session, and password controls that generate many of these events.
- System Health & Prometheus Metrics — the System Health view and the
/metricsscrape token behind the metrics events. - PowerShell Module — automate audit queries and exports.