16 April 2013

Current role of a database

by Grant Fritchey

8,161 1 Mirroring

This metric allows you to keep track of the role of a given database within your mirroring set up. The single value returned tells you whether the database is the principal or the mirror.

Install metric...

Metrics install automatically if you have Redgate Monitor installed.

If you are using Redgate’s SQL Server monitoring tool, Redgate Monitor, you can instantly install and run this metric on your servers.

This metric is described in Grant Fritchey’s Custom Metrics for monitoring mirroring article on Simple Talk.

The metric returns the current role of a given database within your mirroring set up. The single value returned tells you whether the database is the principal or the mirror, which is important information if you always want one server to act as the principal.

Important setup information

Before you can start using this metric, you need to:

Run the following Microsoft procedure on the msdb database you’ll use in the custom metric:
[sql]USE msdb;
GO
EXEC sp_dbmmonitoraddmonitoring;
GO
[/sql]

This sets up a SQL Agent job that periodically updates information about the mirrored databases on your server. For more information, see http://msdn.microsoft.com/en-us/library/ms403582.aspx.
Make sure the SQL Agent is configured and running on the server. Then you can retrieve information using the sp_dbmmonitorresults procedure.

Metric definition

Name

Current role of database 'InsertDatabaseNameHere'

Description

This metric returns the current role of this database within your mirroring set up. Roles are represented by the following values:

1 = Principal
2 = Mirror

The T-SQL query that will collect data


		
			
			
Transact-SQL
			
			DECLARE	@MonitorResults AS TABLE (
	database_name VARCHAR(255),
	role INT,
	mirror_state TINYINT,
	witness_status TINYINT,
	log_generat_rate INT,
	unsent_log INT,
	sent_rate INT,
	unrestored_log INT,
	recovery_rate INT,
	transaction_delay INT,
	transaction_per_sec INT,
	average_delay INT,
	time_recorded DATETIME,
	time_behind DATETIME,
	local_time DATETIME);
 
INSERT	INTO @MonitorResults
		EXEC sp_dbmmonitorresults 
			@database_name = 'InsertDatabaseNameHere',
			@mode = 0,
			@update_table = 0;
 
SELECT role
FROM	@MonitorResults;
			
				
					
				
					1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
				
						DECLARE	@MonitorResults AS TABLE (
	database_name VARCHAR(255),
	role INT,
	mirror_state TINYINT,
	witness_status TINYINT,
	log_generat_rate INT,
	unsent_log INT,
	sent_rate INT,
	unrestored_log INT,
	recovery_rate INT,
	transaction_delay INT,
	transaction_per_sec INT,
	average_delay INT,
	time_recorded DATETIME,
	time_behind DATETIME,
	local_time DATETIME);
 
INSERT	INTO @MonitorResults
		EXEC sp_dbmmonitorresults 
			@database_name = 'InsertDatabaseNameHere',
			@mode = 0,
			@update_table = 0;
 
SELECT role
FROM	@MonitorResults;

Instances to collect from

Select all

Databases to collect from

msdb

Collection frequency

Use collected or calculated values

Leave the Use a calculated rate of change between collections check box unchecked

Metric collection

Enabled

Alert definition

Alert name

Database 'InsertDatabaseNameHere' role changed

Description

This alert is raised when the role of the database changes from principal to mirror. The value returned by the metric on which this alert is based is either:

1 = Principal
2 = Mirror

Raise an alert when the metric value goes

Above the defined threshholds

Default threshold values

High:	1
Medium:	Leave unchecked
Low:	Leave unchecked

Raise an alert when the threshold is passed for

1 collection

Alert is

Enabled

8,161 Rate

Click to rate this post!

[Total: 0 Average: 0]

Current role of a database

Metric definition

Name

Description

The T-SQL query that will collect data

Instances to collect from

Databases to collect from

Collection frequency

Use collected or calculated values

Metric collection

Alert definition

Alert name

Description

Raise an alert when the metric value goes

Default threshold values

Raise an alert when the threshold is passed for

Alert is

What are custom metrics?

What is Redgate Monitor?

Featured custom metrics

Total database file size

Number of active backups and restores

Full backup to odd path

Find metrics