Skip to main content

Cisco Umbrella

Pack Assets

Templates

The Centreon Monitoring Connector Cisco Umbrella brings a host template:

  • Net-Cisco-Umbrella-SNMP-custom

It brings the following service templates:

Service AliasService TemplateService DescriptionDefault
Appliance-StatusNet-Cisco-Umbrella-Appliance-Status-SNMPCheck virtual appliance statusX
ConnectivityNet-Cisco-Umbrella-Connectivity-SNMPCheck connectivity between Umbrella virtual appliance and DNS, local DNS, Umbrella dashboardX
CpuNet-Cisco-Umbrella-Cpu-SNMPCheck CPU usageX
Load-AverageNet-Cisco-Umbrella-Load-Average-SNMPCheck Load on 5m and 15mX
MemoryNet-Cisco-Umbrella-Memory-SNMPCheck memory usageX
QueryNet-Cisco-Umbrella-Query-SNMPCheck number of DNS queries per second over the last 5 and 15 minutesX
Storage-UsageNet-Cisco-Umbrella-Storage-SNMPCheck storage usageX

Collected metrics & status

Metric NameUnit
status

Prerequisites

SNMP Configuration

To use this pack, the SNMP service must be properly configured on your Cisco Umbrella server. Please refer to the official documentation from Cisco:

Network flow

The target server must be reachable from the Centreon poller on the UDP/161 SNMP port.

Setup

  1. Install the package on every Centreon poller expected to monitor Cisco Umbrella resources:
yum install centreon-plugin-Network-Cisco-Umbrella-Snmp
  1. On the Centreon web interface, on page Configuration > Monitoring Connector Manager, install the Cisco Umbrella Centreon Monitoring Connector.

Configuration

Host

  • Log into Centreon and add a new host through Configuration > Hosts.
  • Fill the Name, Alias & IP Address/DNS fields according to your Cisco Umbrella server settings.
  • Apply the Net-Cisco-Umbrella-SNMP-custom template to the host.

If you are using SNMP Version 3, use the SNMPEXTRAOPTIONS macro to configure your own SNMPv3 credentials combo.

MandatoryMacroDescription
SNMPEXTRAOPTIONSConfigure your own SNMPv3 credentials combo

How to check in the CLI that the configuration is OK and what are the main options for?

Once the plugin is installed, log into your Centreon poller's CLI using the centreon-engine user account (su - centreon-engine) and test the plugin by running the following command:

/usr/lib/centreon/plugins//centreon_cisco_umbrella_snmp.pl \
--plugin=network::cisco::umbrella::snmp::plugin \
--mode=query \
--hostname='10.0.0.1' \
--snmp-version='2c' \
--snmp-community='my-snmp-community' \
--warning-5m='' \
--critical-5m='' \
--warning-15m='' \
--critical-15m='' \
--use-new-perfdata

The expected command output is shown below:

OK: Query rate: 3/s (5m), 5/s (15m) | 'dns.query.last.5m.persecond.count'=3;;;0; 'dns.query.last.15m.persecond.count'=5;;;0; 

All available options for a given mode can be displayed by adding the --help parameter to the command:

/usr/lib/centreon/plugins//centreon_cisco_umbrella_snmp.pl \
--plugin=network::cisco::umbrella::snmp::plugin \
--mode=query \
--help

All available modes can be displayed by adding the --list-mode parameter to the command:

/usr/lib/centreon/plugins//centreon_cisco_umbrella_snmp.pl \
--plugin=network::cisco::umbrella::snmp::plugin \
--list-mode

Troubleshooting

Please find the troubleshooting documentation for Centreon Plugins typical issues.