---
title: "Host Template: Cloud - Azure - Network Watcher - Connection Monitors"
description: ""
url: "https://docs.itrsgroup.com/docs/opsview/6.11.7/opspacks/cloud-azure-opspack/cloud-azure-network-watcher-connection-monitors-host-template/index.html"
---## Overview

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&nbsp;Check&nbsp;Name | Description | Default&nbsp;Thresholds (Metric:&nbsp;Warning,&nbsp;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: &#8203;`$WARNINGDT;10;25$`,`$CRITICALDT;30;45$`
[[Supports Dynamic Thresholds]](#dynamic-thresholds-support) | % |
| 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 [Monitoring Plugin thresholds here](https://www.monitoring-plugins.org/doc/guidelines.html#THRESHOLDFORMAT).



### Dynamic Thresholds Support

Some Service Checks within this Host Template support [Dynamic Thresholds for Opsview Enterprise](https://docs.itrsgroup.com/docs/opsview/6.11.7/integrations/dynamic-thresholds/configuring-dynamic-thresholds/index.html#configure-service-checks).

## Prerequisites for monitoring

### Provide Subscription Access

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**

![Add Subscription to Application](https://docscdn.itrsgroup.com/opsview/images/opspacks-cloud-azure-add_subscription_1.png)

![Add Subscription to Application](https://docscdn.itrsgroup.com/opsview/images/opspacks-cloud-azure-add_subscription_2.png)

Repeat these steps for each subscription you wish to monitor.

## Usage Instructions

Please review the overall [Cloud - Azure Opspack](https://docs.itrsgroup.com/docs/opsview/6.11.7/opspacks/cloud-azure-opspack/cloud-azure-opspack/index.html) documentation for details on prerequisites, known issues, and other necessary configurations that apply to all Host Templates in the Opspack.

### 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**.


**Note**


For more information, refer to the documentation on [Adding Host Templates to Hosts](https://docs.itrsgroup.com/docs/opsview/6.11.7/host/index.html#host-templates).



### Add and configure Variables

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

- [**AZURE_CREDENTIALS**](#azure_credentials)
- [**AZURE_RESOURCE_DETAILS**](#azure_resource_details)
- [**AZURE_CONNECTION_MONITOR_NAME**](#azure_connection_monitor_name)


**Note**


For more information, refer to the documentation on [Adding Variables to Hosts](https://docs.itrsgroup.com/docs/opsview/6.11.7/adding-a-new-variable/index.html#adding-a-variable-to-a-host).



### Apply Changes

Apply Changes and the system will now be monitored:

![View Output](https://docscdn.itrsgroup.com/opsview/images/opspacks-cloud-azure-output-cloud-azure-network-watcher-connection-monitors.png)

## Additional Information

**Note:**

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

## Available Variables

### AZURE_CREDENTIALS

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

| Plugin&nbsp;Parameter | Position&nbsp;in Variable | Name | Description |
|:---------------------:|:-------------------------:|:-----|:------------|
| N/A (Opsview UI Only) | Value | Credentials | The credentials for your Azure Subscription |
| `--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.

| Plugin&nbsp;Parameter | Position&nbsp;in Variable | Name | Description |
|:---------------------:|:-------------------------:|:-----|:------------|
| N/A (Opsview UI Only) | Value | Resource Details | The details of your Azure Resource |
| `--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**](#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:

![NetworkWatcherRG](https://docscdn.itrsgroup.com/opsview/images/opspacks-cloud-azure-network_watcher_resource_group.png)

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


**Note**


For more information, see [Microsoft Azure - Create a Network Watcher](https://docs.microsoft.com/en-us/azure/network-watcher/network-watcher-create#create-a-network-watcher-in-the-portal).



![Network Watchers](https://docscdn.itrsgroup.com/opsview/images/opspacks-cloud-azure-network_watchers.png)

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.

| Plugin&nbsp;Parameter | Position&nbsp;in Variable | Name | Description |
|:---------------------:|:-------------------------:|:-----|:------------|
| `--connection-monitor` | Value | Network Watcher Connection Monitor Name | Name of the Azure Network Watcher Connection Monitor |

## Plugin help

Plugin: `check_azure`


**Secure Args**


This plugin uses the [Secure Args](https://docs.itrsgroup.com/docs/opsview/6.11.7/configuration/secure-arguments/index.html) feature for argument passing.



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&nbsp;Check&nbsp;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` |


