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 Alias | Service Template | Service Description | Default |
---|---|---|---|
Appliance-Status | Net-Cisco-Umbrella-Appliance-Status-SNMP | Check virtual appliance status | X |
Connectivity | Net-Cisco-Umbrella-Connectivity-SNMP | Check connectivity between Umbrella virtual appliance and DNS, local DNS, Umbrella dashboard | X |
Cpu | Net-Cisco-Umbrella-Cpu-SNMP | Check CPU usage | X |
Load-Average | Net-Cisco-Umbrella-Load-Average-SNMP | Check Load on 5m and 15m | X |
Memory | Net-Cisco-Umbrella-Memory-SNMP | Check memory usage | X |
Query | Net-Cisco-Umbrella-Query-SNMP | Check number of DNS queries per second over the last 5 and 15 minutes | X |
Storage-Usage | Net-Cisco-Umbrella-Storage-SNMP | Check storage usage | X |
Collected metrics & statusβ
- Appliance-Status
- Connectivity
- Cpu
- Load-Average
- Memory
- Query
- Storage-Usage
Metric Name | Unit |
---|---|
status |
Metric Name | Unit |
---|---|
DNS connectivity status | |
Local DNS connectivity status | |
Umbrella dashboard (cloud) connectivity status | |
AD connectors connectivity status |
Metric Name | Unit |
---|---|
cpu.user.utilization.percentage | % |
cpu.nice.utilization.percentage | % |
cpu.system.utilization.percentage | % |
cpu.idle.utilization.percentage | % |
cpu.wait.utilization.percentage | % |
cpu.kernel.utilization.percentage | % |
cpu.interrupt.utilization.percentage | % |
cpu.softirq.utilization.percentage | % |
cpu.steal.utilization.percentage | % |
cpu.guest.utilization.percentage | % |
cpu.guestnice.utilization.percentage | % |
Metric Name | Unit |
---|---|
load.1m.count | count |
load.5m.count | count |
load.15m.count | count |
Could not retrive metrics
Metric Name | Unit |
---|---|
dns.query.last.15m.persecond.count | count |
dns.query.last.5m.persecond.count | count |
Metric Name | Unit |
---|---|
storage.utilization.percentage | % |
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β
- Online License
- Offline License
- Install the package on every Centreon poller expected to monitor Cisco Umbrella resources:
yum install centreon-plugin-Network-Cisco-Umbrella-Snmp
- On the Centreon web interface, on page Configuration > Monitoring Connectors Manager, install the Cisco Umbrella Centreon Monitoring Connector.
- Install the package on every Centreon poller expected to monitor Cisco Umbrella resources:
yum install centreon-plugin-Network-Cisco-Umbrella-Snmp
- Install the Cisco Umbrella Centreon Monitoring Connector RPM on the Centreon central server:
yum install centreon-pack-network-cisco-umbrella-snmp
- On the Centreon web interface, on page Configuration > Monitoring Connectors 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.
Mandatory | Macro | Description |
---|---|---|
SNMPEXTRAOPTIONS | Configure 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.