How To Send SQL Server CPU Utilization Alerts Using SQL Server Agent

 This article explains how to send an email alert using SQL Server alerts when the SQL Server CPU utilization reaches a specific threshold.

In Microsoft SQL Server, you can use T-SQL and SQL Server Agent to generate an alert when CPU usage exceeds a threshold, such as 80%. Here's an example of how you can achieve this:

Create a SQL Server Agent alert: Open SQL Server Management Studio (SSMS) and connect to your SQL Server instance. Navigate to the SQL Server Agent node in the Object Explorer, right-click on the "Alerts" folder, and select "New Alert."

Configure the alert properties: In the "New Alert" dialog, configure the following properties:

Name: Provide a name for the alert.

Type: Select the type of alert as "SQL Server performance condition alert."

Object: Choose the "Resource Pool Stats."

Counter: Choose the "CPU Usage target %" counter.

 Instance: Select "default" to monitor the overall CPU usage of the entire system.

Alert if counter: Choose "Rises above" to trigger the alert when CPU usage exceeds the threshold.

Value: Enter "0.8" to set the threshold for CPU usage to 80%.

 Enable this alert: Check this option to enable the alert.

Response: Choose the appropriate response action, such as "Notify operators" or "Execute job" to determine what action should be taken when the alert is triggered.

Additional actions: As needed, you can configure additional actions, such as sending an email or running a script.

Click on "OK" to create the alert.

Once the alert is created, SQL Server Agent will automatically monitor the CPU usage based on the specified threshold. When the CPU usage exceeds 80%, the alert will be triggered, and the configured response action will be executed, such as sending notifications or running a script.

T-SQL Stored Procedure To Send CPU-Intensive Queries

Let us understand this with a simple demonstration. Suppose I want to create an alert when the CPU utilization reaches 80%; the SQL Server automatically sends the alert along with the list of the top 10 CPU-intensive queries. We will email the queries in an HTML table.

We can use the following query to populate the top 10 CPU-intensive queries list.


SELECT TOP 10 session.session_id, 

           req.cpu_time, 

           req.logical_reads, 

           req.reads, 

           req.writes, 

           SUBSTRING(sqltext.TEXT, (req.statement_start_offset / 2) + 1, 

           ((CASE req.statement_end_offset 

                WHEN -1 THEN DATALENGTH(sqltext.TEXT) 

                ELSE req.statement_end_offset 

            END - req.statement_start_offset) / 2) + 1) AS statement_text, 

           COALESCE(QUOTENAME(DB_NAME(sqltext.dbid)) + N'.' + QUOTENAME(OBJECT_SCHEMA_NAME(sqltext.objectid, sqltext.dbid))  

           + N'.' + QUOTENAME(OBJECT_NAME(sqltext.objectid, sqltext.dbid)), '') AS command_text, 

       req.command, 

           session.login_name, 

           session.host_name, 

           session.program_name, 

           session.last_request_end_time,

           session.login_time   

FROM sys.dm_exec_sessions AS session 

JOIN sys.dm_exec_requests AS req ON req.session_id = session.session_id CROSS APPLY sys.Dm_exec_sql_text(req.sql_handle) AS sqltext 

WHERE req.session_id != @@SPID 

ORDER BY req.cpu_time DESC 

Query Output:



The entire stored procedure is following:

USE ajay --- change Database

 go

 Create PROCEDURE Sp_send_highcpu_alert

 AS

   BEGIN

       CREATE TABLE #tbl_highcpu_query_output

         (

            sessionid             INT,

            cpu_time              BIGINT,

            logicalreads          BIGINT,

            reads                 BIGINT,

            writes                BIGINT,

            querystatement        VARCHAR(max),

            command_text          VARCHAR(max),

            command               VARCHAR(1500),

            login_name            VARCHAR(1000),

            hostname              VARCHAR(50),

            program_name          VARCHAR(500),

            last_request_end_time DATETIME,

            login_time            DATETIME

         )

       INSERT INTO #tbl_highcpu_query_output

       SELECT TOP 10 session.session_id,

                     req.cpu_time,

                     req.logical_reads,

                     req.reads,

                     req.writes,

                     Substring(sqltext.text, ( req.statement_start_offset / 2 ) +

                                             1

                     , (

                     (

                     CASE req.statement_end_offset

                       WHEN -1 THEN Datalength(sqltext.text)

                       ELSE req.statement_end_offset

                     END - req.statement_start_offset ) / 2 ) + 1)

                     AS statement_text,

                     COALESCE(Quotename(Db_name(sqltext.dbid)) + N'.'

                              + Quotename(Object_schema_name(sqltext.objectid,

                              sqltext.dbid))

                              + N'.'

                              + Quotename(Object_name(sqltext.objectid,

                              sqltext.dbid)),

                     '') AS

                     command_text,

                     req.command,

                     session.login_name,

                     session.host_name,

                     session.program_name,

                     session.last_request_end_time,

                     session.login_time

       FROM   sys.dm_exec_sessions AS session

              JOIN sys.dm_exec_requests AS req

                ON req.session_id = session.session_id

              CROSS apply sys.Dm_exec_sql_text(req.sql_handle) AS sqltext

       WHERE  req.session_id != @@SPID

       ORDER  BY req.cpu_time DESC


       DECLARE @HTMLString NVARCHAR(max)

       DECLARE @SUBJECT VARCHAR(max) = 'High CPU Alert on: ' + @@servername + '.'


       SET @HTMLString= '   <H2>Top 10 CPU Intesnive Queries</H2>   <table id="AutoNumber1" borderColor="#111111" border="1">      <tr>     <td bgcolor="#99CC33">session ID</td>     <td bgColor="#99CC33">CPU Time</td>     <td bgcolor="#99CC33">Logical Reads<</b></td>     <td bgcolor="#99CC33">Reads</td>     <td bgcolor="#99CC33">Writes</td>     <td bgcolor="#99CC33">Query Statement</td>     <td bgcolor="#99CC33">Stored Procedure</td>     <td bgcolor="#99CC33">Command</td>     <td bgcolor="#99CC33">Login name</td>     <td bgcolor="#99CC33">hostname</td>     <td bgColor="#99CC33">program_name</td>     <td bgcolor="#99CC33">last_request_end_time</b></td>     <td bgcolor="#99CC33">login_time</td>      </tr>'

                        + Cast((SELECT DISTINCT td = sessionid, ' ', td= cpu_time

                        ,

                        ' ',

                        td = logicalreads, ' ', td = reads, ' ', td = writes, ' '

                        ,

                        td =

                        querystatement, ' ', td = command_text, ' ', td = command

                        ,

                        ' ',

                        td = login_name, ' ', td = hostname, ' ', td=

                        program_name,

                        ' '

                        , td = last_request_end_time, ' ', td = login_time, ' '

                        FROM

                        #tbl_highcpu_query_output WHERE program_name NOT LIKE

                        '%Mail%'

                        FOR xml path('tr'), type) AS NVARCHAR(max))

                        + '</table>'


       SELECT @HTMLString


       -- Send email using sp_send_dbmail  

       EXEC msdb.dbo.Sp_send_dbmail

         @profile_name = 'SQLmail',

         -- Replace with the name of your DbMail profile  

         @recipients = 'sqldbanow@gmail.com',

         @subject = @subject,

         @body = @HTMLString,

         @body_format = 'HTML';

   END 


Configure Alert

Create a database alert, as I explained at the article's beginning. The alert parameters should be as shown in the screenshot below.



When the alert is raised, we want to send the list of CPU-intensive queries. To do that, we must create an SQL Job. I have created a SQL Server Agent job named Populate_High_CPU_Queries. The SQL Job executes the sp_send_HIGHCPU_Alert stored procedure.

In our case, the job step should look like the following image:



Once the SQL job named Populate_High_CPU_Queries is created, you can specify the job name in the response option of the alert. Below is the image of the Response tab for reference.


Sample Email report







No comments:

Post a Comment