> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://docs.emnify.com/system-events/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.emnify.com/_mcp/server. # emnify system events > Learn the basics and structure of emnify system events The emnify system generates several types of events. These events allow you to track notable system occurrences based on behavior and provide information about lifecycle transitions and configuration changes. > **Note** > > Event history is stored for 30 days. ## Use cases Some common use cases for events on emnify include: * **Triggers for custom business processes** (for example, authentication or custom usage limitations configured on the [emnify Portal](/system-events/usage#emnify-portal)) * **Monitoring** (for example, SIM or data connection lifecycles) * **Input for custom billing systems** (for example, updating billing configuration or processing invoices) ## Structure Each event is represented by an object based on the [generic Event Object and its associated properties](/developers/reference/events). Depending on the event type, some generic properties may not apply, and some events may have additional custom fields to provide information about what happened. ### Event type For an overview of the specific events generated by our platform, see [Event types](/system-events/event-types). ### Event severity Events are distinguished by three severity levels: | Severity Level | Description | | -------------- | ------------------------------------------------------------------------------------------------------------------------------ | | Info | Expected behavior of the executed event (for example, a device successfully attaches to a network). | | Warn | Problem or unusual behavior, but doesn't necessarily require immediate action (for example, a credit card expires in 60 days). | | Critical | Serious issue that likely requires additional follow-up (for example, charging for an invoice failed). | Find more information in the [API reference](/developers/reference/events#event-severity-object). ### Event source Every event is triggered by one of four available event sources: | Event source | Description | | -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | Network | The cellular network your device is connected to (for example, a location is updated or purged). | | Policy control | Both the emnify system and your Workspace can define and enforce policies, quotas, or other limitations - The emnify system can block devices that exceed predefined traffic limits. - Your Workspace could configure the maximum SMS usage for devices to limit SMS traffic. | | API | The [emnify REST API](/developers/api). | | Semantic | The emnify event processing engine, which evaluates the conditions you configure for [custom events](/system-events/event-types/custom-events). | > **Note** > > Any events triggered in the [emnify Portal](/system-events/usage#emnify-portal) show **API** as the event source, because the Portal uses the API to make its changes. Find more information in the [API reference](/developers/reference/events#event-source-object). ### User tracking for auditing [Device status management events](/system-events/event-types/device-status-management) include information about who performed the action. When viewing these events in the Portal, click an event row to see the **Action performed by** field, which displays the user's name, email, and user ID. > **Note** > > User information is available for actions performed through the Portal or API with [user credentials](/developers/auth/user-credentials). > Actions authenticated with application tokens don't include user details. ## Working with events There are three main ways you can access and trigger events: * [Data Streamer](/system-events/usage#data-streamer) * [Event API](/system-events/usage#event-api) * [emnify Portal](/system-events/usage#emnify-portal) More information on these systems and how they compare is available on the [Work with events](/system-events/usage) page. To react to events automatically with rules and notifications, see [Automations](/services/automations). > Learn the basics and structure of emnify system events ## Docs - [Event types](https://docs.emnify.com/system-events/event-types.md): List of all available event types in the emnify platform - [Generic events](https://docs.emnify.com/system-events/event-types/generic-events.md): Generic system events in the emnify platform - [Network attachment and location](https://docs.emnify.com/system-events/event-types/network-attachment-and-location.md): Network attachment and location events in the emnify platform - [Data connection lifecycle](https://docs.emnify.com/system-events/event-types/data-connection-lifecycle.md): Data connection lifecycle events in the emnify platform - [Network Flow Logs](https://docs.emnify.com/system-events/event-types/flow-logs.md): Network Flow Log events in the emnify platform - [Application and user authentication](https://docs.emnify.com/system-events/event-types/application-and-user-authentication.md): Application and user authentication events in the emnify platform - [User management](https://docs.emnify.com/system-events/event-types/user-management.md): User management events in the emnify platform - [Device status management](https://docs.emnify.com/system-events/event-types/device-status-management.md): Device status management events in the emnify platform - [Limit enforcement](https://docs.emnify.com/system-events/event-types/limit-enforcement.md): Limit enforcement events in the emnify platform - [Data quota management](https://docs.emnify.com/system-events/event-types/data-quota-management.md): Data quota management events in the emnify platform - [SMS quota management](https://docs.emnify.com/system-events/event-types/sms-quota-management.md): SMS quota management events in the emnify platform - [Cloud Connect lifecycle](https://docs.emnify.com/system-events/event-types/cloud-connect-lifecycle.md): Cloud Connect lifecycle events in the emnify platform - [OpenVPN lifecycle](https://docs.emnify.com/system-events/event-types/openvpn-lifecycle.md): OpenVPN lifecycle events in the emnify platform - [Organization and billing](https://docs.emnify.com/system-events/event-types/organization-and-billing.md): Organization and billing events in the emnify platform - [Custom events](https://docs.emnify.com/system-events/event-types/custom-events.md): Custom events in the emnify platform - [Work with system events](https://docs.emnify.com/system-events/usage.md): Manage events with emnify's Data Streamer, REST API, or Portal