sys.dm_xe_session_events (Transact-SQL)
Applies to: 
SQL Server
Azure SQL Managed Instance
Returns information about events for active server-scoped sessions. Events are discrete execution points. Predicates can be applied to events to stop them from firing if the event does not contain the required information.
Azure SQL Database supports only database-scoped sessions. See sys.dm_xe_database_session_events.
| Column name | Data type | Description |
|---|---|---|
| event_session_address | varbinary(8) | The memory address of the event session. Is not nullable. |
| event_name | nvarchar(256) | The name of the event that an action is bound to. Is not nullable. |
| event_package_guid | uniqueidentifier | The GUID for the package containing the event. Is not nullable. |
| event_predicate | nvarchar(3072) | An XML representation of the predicate tree that is applied to the event. Is nullable. |
| event_fire_count | bigint | The number of times the event has fired (was published) since the session was started. Is not nullable. Applies to SQL Server 2022 (16.x) and later. |
| event_fire_average_time | bigint | The average time taken to publish the event, in microseconds. Is not nullable. Applies to SQL Server 2022 (16.x) and later. |
| event_fire_min_time | bigint | The minimum time taken to publish the event, in microseconds. Is not nullable. Applies to SQL Server 2022 (16.x) and later. |
| event_fire_max_time | bigint | The maximum time taken to publish the event, in microseconds. Is not nullable. Applies to SQL Server 2022 (16.x) and later. |
Note
The event_fire_count and event_fire_average_time columns are populated only when trace flag 9708 is enabled.
Permissions
Requires VIEW SERVER STATE permission on the server.
Permissions for SQL Server 2022 and later
Requires VIEW SERVER PERFORMANCE STATE permission on the server.
Relationship cardinalities
| From | To | Relationship |
|---|---|---|
| sys.dm_xe_session_events.event_session_address | sys.dm_xe_sessions.address | Many-to-one |
| sys.dm_xe_session_events.event_package_guid, sys.dm_xe_session_events.event_name |
sys.dm_xe_objects.name, sys.dm_xe_objects.package_guid |
Many-to-one |
Next steps
Learn more about related concepts in the following articles: