Azure Network Watcher Connection Monitors Monitoring

Host Template: Cloud - Azure - Network Watcher - Connection Monitors

Azure Network Watchers allow you to monitor, diagnose, view metrics, and enable or disable logs for resources in an Azure virtual network. You can monitor communication between virtual machines and endpoints, and view the relationships between resources in a virtual network. Additionally, you can capture packets, troubleshoot and diagnose problems inside a virtual network.

This Host Template allows you to get information on the Connection Monitors belonging to a specific Network Watcher.

This Host Template includes the following Service Checks:

Service Check Name	Description	Default Thresholds (Warning, Critical)	UOM
Azure - Connection Monitors - Checks Failed Percent	The percent of checks failed for a connection monitor. Depending on the protocol used in the test configuration, connection monitor runs a series of checks for the source-destination pair. For HTTP, the service calculates the number of HTTP responses that returned a valid response code. If you use TCP or ICMP, the service calculates the packet-loss percentage to determine the percentage of failed checks. [Default Timespan = 5mins, Default Check Interval = 5mins]	checks_failed_percent=10,30	%
Azure - Connection Monitors - Round Trip Time	The round trip time in milliseconds. Depending on the protocol used in the test configuration, connection monitor runs a series of checks for the source-destination pair. For HTTP, to calculate RTT, the service measures the time between a HTTP Call and the response. If you use TCP or ICMP, to calculate RTT, the service measures the time taken to receive the acknowledgement (ACK) for the packets that were sent. [Default Timespan = 5mins, Default Check Interval = 5mins]	N/A	ms
Azure - Connection Monitors - Test Result	The test result for the connection monitor. Depending on the data that the checks return, tests can have the following states; Pass: Actual values for the percentage of failed checks and RTT are within the specific thresholds. Fail: Actual values for the percentage of failed checks or RTT exceed the specific thresholds. Warning: Actual values for the percentage of failed checks or RTT are more than 80% of the threshold. Indeterminate: No data in the Log Analytics workspace. [Default Timespan = 5mins, Default Check Interval = 5mins]	N/A	N/A

NOTE: The "Default Timespan" given for these Service Checks refers to the time period we use when retrieving metrics from Azure.

NOTE: See details about Nagios thresholds here.

Usage Instructions

To use this Host Template you will need to provide access to the subscription you wish to monitor

Navigate to the Subscriptions section and select your Subscription.

In the Subscription to be monitored, click Access Control (IAM).

Then click the Add button, select the required role and select the application, once for each of the following roles:

Reader

Repeat these steps for each subscription you wish to monitor.

Note:
Unlike in other Azure Host Templates, the Resource Group field (Arg1) and Resource Name field (Arg2) of the AZURE_RESOURCE_DETAILS variable should be set to the resource group and name of the Azure Network Watcher while the AZURE_CONNECTION_MONITOR_NAME variable should be set to the name of the Azure Connection Monitor you wish to monitor.

Step 1: Add this Host Template

Add the Cloud - Azure - Network Watcher - Connection Monitors Host Template to your Opsview Monitor host. If the resource you're monitoring has no hostname or public IP, then open the Advanced settings pane and change Host Check Command to Always assumed to be UP.

For more information, refer to Opsview Knowledge Center - Adding Host Templates to Hosts.

Step 2: Add and configure variables required for this Host Template

The Service Checks in this Host Template use the following variables, and they will be added to your Opsview Monitor instance when you import the Opspack:

AZURE_CREDENTIALS

The Value is not used and therefore can be set to anything. Override the arguments with your Azure Credentials.

Parameter	Position in Variable	Name	Description
--subscription-id	Arg1	Subscription ID	The Subscription ID of your Azure Subscription
--client-id	Arg2	Client ID	The Client ID of your Azure Subscription
--secret-key	Arg3	Secret Key	The Secret Key of your Azure Subscription
--tenant-id	Arg4	Tenant ID	The Tenant ID of your Azure Subscription

AZURE_RESOURCE_DETAILS

The Value is not used and therefore can be set to anything. Override the arguments with your Azure Resource Details.

Parameter	Position in Variable	Name	Description
--resource-group	Arg1	Resource Group	Name of the Azure resource group of your resource
--resource-name	Arg2	Resource Name	Name of the Azure resource to be monitored

AZURE_CONNECTION_MONITOR_NAME

Set the value of this variable to the name of the connection monitor you want to monitor. You can have multiple host variables to monitor the status of multiple connection monitors.

Use the AZURE_RESOURCE_DETAILS variable to specify your Azure Network Watcher details.

Note that your Network Watchers will by default be located in the 'NetworkWatcherRG' Resource Group:

When Network Watchers are created, by default they are called 'NetworkWatcher_{region}' e.g. 'NetworkWatcher_uksouth'.

For more information, see Microsoft Azure - Create a Network Watcher.

Your Network Watcher names and Resource Group could differ if not created via the Portal, or moved manually, so ensure the arguments you provide are correct for the Network Watcher you want to monitor.

Parameter	Position in Variable	Name	Description
--connection-monitor	Value	Network Watcher Connection Monitor Name	Name of the Azure Network Watcher Connection Monitor

For more information, refer to Opsview Knowledge Center - Adding Variables to Hosts.

For mode-specific help, run the plugin with the -h -m <mode> flags. This will list the required and optional Variable Arguments for that mode. The appropriate mode for each Service Check is listed here:

Service Check Name	Mode
Azure - Connection Monitors - Checks Failed Percent	`Az.Network.Watcher.CM.Checks.Failed.Percent`
Azure - Connection Monitors - Round Trip Time	`Az.Network.Watcher.CM.Round.Trip.Time`
Azure - Connection Monitors - Test Result	`Az.Network.Watcher.CM.Test.Result`