Learn more about SQL Server tools

mssqltips logo
giveaway
 

Tutorials          DBA          Dev          BI          Career          Categories          Webcasts          Whitepapers          Today's Tip          Join

Tutorials      DBA      Dev      BI      Categories      Webcasts

DBA    Dev    BI    Categories

 

How to Change the SQL Server Agent Log File Path


By:   |   Read Comments (3)   |   Related Tips: More > SQL Server Agent


SQL Server Conference Giveaway - click to learn more


Problem

SQL Server Agent has its own log file that captures certain events from this service.  By default the file is located in the LOG folder where SQL Server is installed.  In this tip I will explain how to change the path of your SQL Server Agent log file "SQLAGENT.OUT" from an existing location to a new location.

Solution

We had a requirement to move the SQL Server Agent log file SQLAGENT.OUT from the current drive to a different drive. It was a part of our best practices in which we are streamlining our entire SQL Server environment. We made these changes by using two undocumented stored procedures.

  • SP_GET_SQLAGENT_PROPERTIES
  • SP_SET_SQLAGENT_PROPERTIES

The first stored procedure is used to retrieve the SQL Server Agent properties and the second stored procedure is used to set/change the properties for the SQL Agent service.

I strongly suggest testing any undocumented stored procedures in a lab environment first, before changing your production servers.

Steps to move the SQL Agent log file

Step 1

First check the existing location of the SQL Server Agent log file. Run the below undocumented stored procedure to get the current location. This stored procedure will let us know the SQL Agent properties of a particular server. This stored procedure can be found in the msdb database.

USE MASTER
GO
EXEC msdb..sp_get_sqlagent_properties
GO

We can see below the different settings that are returned when we run this command.  We are interested in the errorlog_file column for the change we need to make.  Here we can see the current location is the C drive.

Find the current location of sql server agent log file

Step 2

Now we will change the location of the file from the C drive to the G drive.

First we need to create the new destination folders where we want to put the SQLAGENT.OUT file. So, I created the folder "Microsoft SQL Server\MSSQL.1\MSSQL\LOG" on the G drive. If you do not create these folders you will have issues when the SQL Server Agent service restarts.

After the new folder has been created, run the below stored procedure to change the location.

USE MASTER
GO
EXEC msdb.dbo.sp_set_sqlagent_properties 
@errorlog_file=N'G:\Microsoft SQL Server\MSSQL.1\MSSQL\LOG\SQLAGENT.OUT'
GO

Change the agent logfile location to different path

Step 3

Now we will verify whether the SQL Server Agent log file path has changed or not. We will be run the same command as in step 1 to get the SQL Server agent properties. We can see in the below screenshot that the path for the SQL Server Agent log file has been changed to the G drive.

Verify the change of agent log file location

Note, this change will not go into effect until you restart your the SQL Agent service. You can verify this by checking the new location to see if the file SQLAGENT.OUT exists or not.

Step 4

Now restart your SQL Server Agent service to bring the changes into effect. If you have any issues or the SQL Server Agent service does not start (you might get an error like below) then you should check the path you have set in step 2. The path has to be valid to successfully start this service.

Issue during SQL Agent service restart

Once the SQL Server Agent service successfully restarts you can check the new location of the SQL Server Agent log file. You should now see that the SQLAGENT.OUT file has been created in the new location which we have set in step 2.

log file creation in new location
Next Steps

Follow this process to move your SQL Server Agent log file SQLAGENT.OUT to some other location. If you want to explore more knowledge on SQL Server Agent then take a look at the tips about SQL Server Agent.



Last Update:


signup button

next tip button



About the author
MSSQLTips author Manvendra Singh Manvendra Singh has over 5 years of experience with SQL Server and has focused on Database Mirroring, Replication, Log Shipping, etc.

View all my tips
Related Resources





Post a comment or let the author know this tip helped.

All comments are reviewed, so stay on subject or we may delete your comment. Note: your email address is not published. Required fields are marked with an asterisk (*).

*Name    *Email    Notify for updates 


SQL tips:

*Enter Code refresh code     



Friday, July 22, 2016 - 4:18:51 AM - Achim Stienen Back To Top

 Good article.

Be sure that the new log path exists and the SQLAgent service account has sufficiant permissions on that path.

Otherwise, the SQLAgent service will not start and there is no way to change the path using msdb.dbo.sp_set_sqlagent_properties because the SP needs the SQLAgent service running.

 You can change the path outside SQL in the registry by setting the HKLM\SOFTWARE\Microsoft\Microsoft SQL Server\\SQLServerAgent\Errorlogfile value data to the correct file path + '\SQLAGENT.OUT'

 

 


Sunday, December 08, 2013 - 10:33:02 PM - manu Back To Top

Good one undocumented stored procedures are useful..


Tuesday, November 05, 2013 - 2:00:29 PM - Srinath Back To Top

Nice one..Learnt an item today !!


Learn more about SQL Server tools