SQL Server AlwaysOn Availability Groups Inventory and Monitoring Scripts - Part ...

By:Alejandro Cobar | Last Updated: 2018-11-15 || Related Tips:More > Availability Groups

Problem

Whether you inherited a set of servers supporting SQL Server AlwaysOn Availability Groups or plan to implement them in the future, it is a very good idea to know which servers have Availability Groups configured. Once discovered, then the on-going monitoring status of each one of them is important to know when to react, in case there's something questionable occurring.

Solution

I will be presenting 2 T-SQL scripts that can help you keep track of SQL Server AlwaysOn Availability Groups and they can even be automated to save you time.

One script will be used to build the inventory of SQL Server instances (replicas) that have at least 1 Availability Group configured. The other script will be used to gather basic, but very useful information for each SQL Server Availability Group. Building the SQL Server Availability Groups Inventory

The purpose of the following T-SQL code is to gather the information for each particular Availability Group, from a "configuration/setup" standpoint.

I'm assuming that, up to this point, you already have an Availability Group configured in your environment. If you execute this T-SQL code against a secondary replica, then you will only get the information for that replica. However, if it is executed against the primary replica then the output will contain the information for all the replicas. For the sake of simplicity, the PowerShell script I'm including makes sure that the information retrieved comes only from a primary replica (for any given Availability Group). This particular T-SQL code won't work for an Availability Group in SQL 2012 or 2014 due to the seeding mode field introduced in SQL Server 2016. However, the PowerShell script uses a slightly different query depending on the SQL Server version. SELECT
ag.name AS 'GroupName'
,cs.replica_server_name AS 'Replica'
,rs.role_desc AS 'Role'
,REPLACE(ar.availability_mode_desc,'_',' ') AS 'AvailabilityMode'
,ar.failover_mode_desc AS 'FailoverMode'
,ar.primary_role_allow_connections_desc AS 'ConnectionsInPrimaryRole'
,ar.secondary_role_allow_connections_desc AS 'ConnectionsInSecondaryRole'
,ar.seeding_mode_desc AS 'SeedingMode'
,ar.endpoint_url AS 'EndpointURL'
,al.dns_name AS 'Listener'
FROM sys.availability_groups ag
JOIN sys.dm_hadr_availability_group_states ags ON ag.group_id = ags.group_id
JOIN sys.dm_hadr_availability_replica_cluster_states cs ON ags.group_id = cs.group_id
JOIN sys.availability_replicas ar ON ar.replica_id = cs.replica_id
JOIN sys.dm_hadr_availability_replica_states rs ON rs.replica_id = cs.replica_id
LEFT JOIN sys.availability_group_listeners al ON ar.group_id = al.group_id

Here you can look at a quick sample of the output this generates (from a primary replica):

PowerShell script to gather the information from all the SQL Server Availability Groups replicas

You can execute the above T-SQL code against each SQL Server instance under your care and store everything in a central database (which will be very helpful for the Part 2 of this tip).

The script has XXX in all the places where you will have to place the values according to your own environment. Since there can be Availability Groups with the same name, we might want to add a groupId to the mix just to keep things unique. $labServer = "XXX"
$inventoryDB = "XXX"
#Clean the XXX table so that the inventory is built every single time
Invoke-Sqlcmd -Query "TRUNCATE TABLE XXX" -Database $inventoryDB -ServerInstance $labServer
#Fetch all the instances with the respective SQL Server Version
/*
This is an example of the result set that your query must return
############################################################################
# name # version # instance #
############################################################################
# server1.domain.net,45000 # SQL Server 2012 RTM # server1\mssqlSERVER1 #
# server2.domain.net,45000 # SQL Server 2012 SP2 # server2 #
# server3.domain.net,45000 # SQL Server 2012 SP2 # server3 #
# server4.domain.net,45000 # SQL Server 2014 SP2 # server4\MSSQLSERVER_2K14#
# server5.domain.net,45000 # SQL Server 2016 SP2 # server5\SQLSERVER2016 #
############################################################################
*/
$instanceLookupQuery = /*Put in here the query that will return the set of instances to evaluate*/
$instances = Invoke-Sqlcmd -ServerInstance $labServer -Database $inventoryDB -Query $instanceLookupQuery
#Create a couple of temporary tables to store all the results fetched from all the instances
$tmpTableReplicasQuery = "
CREATE TABLE ##AlwaysOnReplicasInformation(
[GroupId] [int] NOT NULL,
[GroupName] [nvarchar](255) NOT NULL,
[Replica] [nvarchar](255) NOT NULL,
[Role] [nvarchar](255) NOT NULL,
[AvailabilityMode] [nvarchar](255) NOT NULL,
[FailoverMode] [nvarchar](255) NOT NULL,
[ConnectionsInPrimaryRole] [nvarchar](255) NOT NULL,
[ConnectionsInSecondaryRole] [nvarchar](255) NOT NULL,
[SeedingMode] [nvarchar](255),
[EndpointURL] [nvarchar](255) NOT NULL,
[Listener] [nvarchar](255) NOT NULL
)
"
Invoke-Sqlcmd -ServerInstance $labServer -Database 'tempdb' -Query $tmpTableReplicasQuery
#For each instance, grab the AlwaysOn replicas information
$groupId = 1
foreach ($instance in $instances){
#SQL Server 2012/2014 doesn't have a seeding mode description available as it was introduced in 2016
if($instance.version.Substring(11,4) -ge 2016){
$AlwaysOnReplicasInformationQuery = "
SELECT
ag.name AS 'GroupName'
,cs.replica_server_name AS 'Replica'
,rs.role_desc AS 'Role'
,REPLACE(ar.availability_mode_desc,'_',' ') AS 'AvailabilityMode'
,ar.failover_mode_desc AS 'FailoverMode'
,ar.primary_role_allow_connections_desc AS 'ConnectionsInPrimaryRole'
,ar.secondary_role_allow_connections_desc AS 'ConnectionsInSecondaryRole'
,ar.seeding_mode_desc AS 'SeedingMode'
,ar.endpoint_url AS 'EndpointURL'
,al.dns_name AS 'Listener'
FROM sys.availability_groups ag
JOIN sys.dm_hadr_availability_group_states ags ON ag.group_id = ags.group_id
JOIN sys.dm_hadr_availability_replica_cluster_states cs ON ags.group_id = cs.group_id
JOIN sys.availability_replicas ar ON ar.replica_id = cs.replica_id
JOIN sys.dm_hadr_availability_replica_states rs ON rs.replica_id = cs.replica_id
LEFT JOIN sys.availability_group_listeners al ON ar.group_id = al.group_id;
"
}
else{
$AlwaysOnReplicasInformationQuery = "
SELECT
ag.name AS 'GroupName'
,cs.replica_server_name AS 'Replica'
,rs.role_desc AS 'Role'
,REPLACE(ar.availability_mode_desc,'_',' ') AS 'AvailabilityMode'
,ar.failover_mode_desc AS 'FailoverMode'
,ar.primary_role_allow_connections_desc AS 'ConnectionsInPrimaryRole'
,ar.secondary_role_allow_connections_desc AS 'ConnectionsInSecondaryRole'
,NULL AS 'Seeding Mode'
,ar.endpoint_url AS 'EndpointURL'
,al.dns_name AS 'Listener'
FROM sys.availability_groups ag
JOIN sys.dm_hadr_availability_group_states ags ON ag.group_id = ags.group_id
JOIN sys.dm_hadr_