Create Manual Traces using Stored Procedures
Applies to: SQL Server
Microsoft SQL Server provides Transact-SQL system stored procedures to create traces on an instance of the SQL Server Database Engine. These system stored procedures can be used from within your own applications to create traces manually, instead of using SQL Server Profiler. This allows you to write custom applications specific to the needs of your enterprise.
In This Section
The following table lists the system stored procedures for tracing an instance of the SQL Server Database Engine.
Stored procedure | Task performed |
---|---|
sys.fn_trace_geteventinfo (Transact-SQL) | Returns information about events included in a trace. |
sys.fn_trace_getinfo (Transact-SQL) | Returns information about a specified trace or all existing traces. |
sp_trace_create (Transact-SQL) | Creates a trace definition. The new trace will be in a stopped state. |
sp_trace_generateevent (Transact-SQL) | Creates a user-defined event. |
sp_trace_setevent (Transact-SQL) | Adds an event class or data column to a trace, or removes one from it. |
sp_trace_setstatus (Transact-SQL) | Starts, stops, or closes a trace. |
sys.fn_trace_getfilterinfo (Transact-SQL) | Returns information about filters applied to a trace. |
sp_trace_setfilter (Transact-SQL) | Applies a new or modified filter to a trace. |
To define your own trace using stored procedures
Specify the events to capture using sp_trace_setevent.
Specify any event filters. For more information, see Set a Trace Filter (Transact-SQL).
Specify the destination for the captured event data using sp_trace_create.
For an example of using trace stored procedures, see Create a Trace (Transact-SQL).
To set trace definition defaults
To set trace display defaults
To create a trace
To add or remove events from a trace template