Events

The Events page is the platform-wide activity log and audit trail. Every meaningful action in Koios records an event: a device connecting or failing, a tag going into alarm, a model starting inference, a component throwing an error, a user changing a setting, or a service reporting its health. Open Events from the sidebar to see the full stream, newest first.

Each event captures what happened, which service reported it, which entity it relates to, and who triggered it (a user or an API client). Configuration changes also record the exact field values before and after.

Event Types

Every event has a type that sets its severity and color. Filter the list by one or more types.

Event Sources

The source is the service that recorded the event. Filter the list by one or more sources.

The Event List

The list shows one row per event with these columns:

Use the column filters to narrow by type, source, entity type, or a time range, and type in the message filter to search event text. Sort by time, type, source, or message. The list loads more rows as you scroll.

By default the list shows only unacknowledged events and hides events from muted entities. Use View all to include acknowledged and muted events. When new events arrive while you are scrolled down, a new events pill appears at the top; click it to jump back and load them.

Event Detail

Click any row to open the detail drawer. Depending on the event, it shows:

Acknowledging Events

Acknowledging an event marks it as handled and removes it from the default unacknowledged view. Acknowledge a single event from its detail drawer, select several rows and acknowledge them together, or use Acknowledge all to clear every unacknowledged event at once.

Acknowledging requires the Acknowledge events permission. Without it, the acknowledge controls are visible but disabled with a tooltip explaining why. See Roles & Permissions to grant it.

Muting

Muting suppresses your popup notifications without hiding events from the log. Muting is per-user, so it never affects what your teammates see.

• Mute an entity: from an event's detail drawer, mute the related device, tag, or model for a set duration or indefinitely. Muted entities are also hidden from the default event view.
• Mute all notifications: silence every popup notification for a duration or indefinitely from the notification bell in the header. Events still record; only the popups stop.

Manage these from the notification settings, reachable via the bell icon in the Events page header.

Related Events

When one root cause produces many events, such as a bulk enable touching hundreds of tags or a device failure cascading to its tags, Koios groups them. The originating event becomes the root, and the rest become its children.

The list collapses each group to its root row and shows a +N related badge with the child count. Use the Expand toggle to reveal child events inline. Open a root event to see the full Event Cascade timeline, drill into any child, and step back to the parent. Acknowledge All on a root acknowledges the root and every child together.

Real-Time Notifications

New events raise popup notifications in the corner of the screen for events you have not yet seen. During a sustained burst, Koios consolidates the individual popups into a single storm notification with a live counter, so a flood of events never buries the interface. The counter keeps climbing until activity quiets down. The event list itself is never collapsed; every event is always recorded and browsable.

Retention

Events are kept for a configurable number of days (90 by default) and older events are deleted automatically. Adjust the Event Retention period in Data Retention.

What's Next

• Data Retention: control how long events and other history are kept.
• Roles & Permissions: grant the Acknowledge events permission and control access.