Skip to main content
Note: Event monitoring replaces the Activity console drawer that was previously available in the bottom of your dashboard. Events for a single SIM are also listed in the History tab when viewing a SIM’s details page.

How to view event history

Navigate to the Event monitoring section in the main menu and open the Event history page.
Event history page
The page displays a list of all events created in the Hologram Cloud across your fleet. You can view specific types of events using the tabs at the top of the page, and narrow the list with the filters above the table. Events are processed and created shortly after the event occurs, and are not real-time. Auto-refresh is on by default and keeps the list up to date. When you turn it off, Last refreshed shows when events last loaded; press the refresh button to load new events. To set up notifications for events, select Manage alerts. Each event is displayed with the following information:
  • Inbound or outbound: Whether the event was inbound to a SIM or outbound from it.
  • SIM ID: The ID of the SIM that triggered the event.
  • Event date: The date and time in UTC that the event occurred.
  • Message data: The message data or JSON payload that was passed when the event occurred.
  • Event tags: Any event tags associated with the event. Event tags determine the type of event that occurred, the device affected by the event, and any SIM tags that were attached to SIMs affected by the event.
  • Errors: Any errors that occurred during the event, like an alert that failed to send. Errors display above the message data; hover over an error to see the full text.
Pressing the Details button will open a modal with more information about the event, including raw message contents and any errors. The actions menu next to Details has shortcuts for the event’s SIM: Send message to SIM…, and Simulate this message… for message events.

Create an alert from an event

If an event supports alerts, its actions menu also offers:
  • Create fleet-wide alert…: opens the Create alert form for this type of event across every SIM in your organization.
  • Create alert for SIM…: opens the same form limited to the event’s SIM.
The form is prefilled with the event’s alert type and event tag. Events that don’t support alerts don’t show these options. The count above the table shows how many events are loaded. Press Load more events at the bottom of the table to load older events.

How to filter events

Use the filters above the table to narrow the list:
  • Search events: Matches text in the event’s message data. Press Enter or click away from the search box to apply it.
  • Date: Choose All time, Last 24 hours, This month, Last 7 days, Last 30 days, or Last 90 days, or choose Custom range and set a Start date (UTC) and End date (UTC).
  • Event type: Show specific types of events. On a tab for one event type, the tab sets this filter.
  • Device: Show events for specific devices.
  • Tag: Show events with specific SIM tags.
  • Triggered alert: Show events that triggered specific alerts.
  • Errors: Show only events with errors.
Press Clear filters to remove every filter. Switching tabs clears the Event type and Errors filters and keeps the rest.
Tip: The Date filter and the tabs request matching events from Hologram. The other filters only search events that are already loaded. If you don’t find what you’re looking for, press Load more events or narrow the date range.

How to export events

Select Export at the top of the events table, then Export to CSV or Export to JSON. The export includes every event that’s loaded and matches your filters.

How to view specific types of events

The tabs at the top of the page allow you to filter events by type, including:
  • Recent: Displays all events created in the Hologram Cloud across your fleet, sorted by most recent first.
  • Errors: Displays all events where an error occurred during the event.
  • Data limit: Displays all events where a data limit was reached for a SIM and the SIM was paused.
  • Data warning: Displays all events where a SIM reached a data warning threshold.
  • First IMEI: Displays all events where an IMEI was detected for the first time for a SIM.
  • IMEI change: Displays all events where the IMEI or IMEI TAC of a SIM changed between data sessions.
  • Conductor: Displays all Conductor configuration change events. Displays only for organizations with Conductor enabled.
  • Profile changes: Displays all events where a SIM fell back to another profile or its enabled profile was switched.
  • Messaging: Displays all events where a message was sent or received by a SIM, including SMS, and TCP or UDP cloud messages.
  • API: Displays any API responses to events, such as messages that failed to deliver to a SIM.
The Event history page keeps your tab and filters in its URL, so you can bookmark or share a filtered view. You can also build a link yourself with these URL parameters: You can combine parameters with &, like /events?type=data_limit&deviceid=123456. The event types you can use with type are: Unrecognized event types are ignored. The Conductor tab only shows for organizations with Conductor enabled.
Note: The Fleet events pages have been retired. Links to them open Event history instead: usage thresholds open the Data warning tab, usage limits open the Data limit tab, IMEI changes open the IMEI change tab, and the main Fleet events page opens Recent filtered to all three.

About alerts and event monitoring

Read about how alerts work, event tags, and the types of events you can subscribe to.
Limited access: Some functionality in your dashboard is restricted to roles with access.