Even though we design our SQL Scripts with the best methods using best practices, or configure the SQL Server to perform correctly and in the optimized manner, you cannot prevent things going wrong. Luckily, SQL Server does a great job on logging all the issues which we will be encountering during the course. Things could have been worse if you need to go through the error log file using only a text editor like the ‘Note Pad’ application (Favorite text editor of majority people). But fortunately, SQL Server had provided us some help when you need to dig deep into Error Log.
But things could get more complicated if the Error Log contains lots of records and in those records if you require to swim for the issue which you are looking for.
Even though it provides you some searching and filtering capabilities, it could still be very challenging and time consuming.
However, we do have another workaround which might come in handy. That’s to query the Error Logs using T-SQL. This can be done using the system procedure ‘
sys.sp_readerrorlog’. This consists of a few parameters.
SET ANSI_NULLS ON
SET QUOTED_IDENTIFIER OFF
ALTER proc [sys].[sp_readerrorlog](
@p1 int = 0,
@p2 int = NULL,
@p3 nvarchar(4000) = NULL,
@p4 nvarchar(4000) = NULL)
if (not is_srvrolemember(N'securityadmin') = 1)
if (@p2 is NULL)
exec sys.xp_readerrorlog @p1
exec sys.xp_readerrorlog @p1,@p2,@p3,@p4
- @p1 –> This represents the error log which you need to inspect (0 ~ Current | 1 ~ Archive #1 etc..)
- @p2 –> Type of the error log which you want to inspect (NULL or 1 ~ Error Log | 2 ~ SQL Agent Log)
- @p3 –> 1st Search Parameter (A value which you want to search the contents for)
- @p4 –> 2nd Search Parameter (A value which you want to search to further refine the result set)
**Please note: Aforementioned parameters are optional. Therefore, if you don’t provide any parameters, it will return the whole contents of the current/active Error Log.
- This will return all entries in the current Error Log:
EXEC sys.xp_readerrorlog @p1 = 0
- This will return all the entries in the current SQL Agent Log:
EXEC sys.xp_readerrorlog @p1 = 0, @p2 = 2
- This will return all the entries in the current SQL Error log wherever the value ‘
EXEC sys.sp_readerrorlog @p1=0, @p2=1, @p3='CLR'
- This will return the entries in the current SQL Error log when the value ‘
CLR’ and ‘
EXEC sys.sp_readerrorlog @p1=0, @p2=1, @p3='CLR', @p4='Framework'
When we execute the stored procedure ‘
sys.sp_readerrorlog’, inside it will call an extended stored procedure which will accept 7 parameters, which is ‘
sys.xp_readerrorlog’. The parameter details are as follows:
|Param # ||Parameter ||Details |
|1 ||Log Number ||0 – Current / 1 – Archive #1 / 2 – Archive #2 etc… |
|2 ||Log Type ||1 – SQL Error Log / 2 – SQL Agent Log |
|3 ||Search Text 1 ||Search term which will be searched on the Text column |
|4 ||Search Text 2 ||Search term which will be searched on the Text column. **If both search texts are supplied it will return rows containing both texts. |
|5 ||Start Date ||Log entries which the ‘Log Date’ is newer than the date provided. (including the date provided) |
|6 ||End Date ||Log entries which is between the Start Date and End Date |
|7 ||Sort Order ||ASC – Ascending / DESC - Descending |
EXEC sys.xp_readerrorlog 0,1,N'',N'', _
I hope this information will help you when you need to query the Error Log in order to troubleshoot an issue.