vmware vrealize operations management pack for nagios · 3 blue medora vmware vrealize operations...

27
VMWARE VREALIZE OPERATIONS MANAGEMENT PACK FOR Nagios User Guide

Upload: vucong

Post on 18-Sep-2018

233 views

Category:

Documents


0 download

TRANSCRIPT

Page 1: VMWARE VREALIZE OPERATIONS MANAGEMENT PACK FOR Nagios · 3 Blue Medora VMware vRealize Operations Management Pack for Nagios User Guide 1. Purpose The Blue Medora VMware vRealize

VMWARE VREALIZE OPERATIONS MANAGEMENT PACK FOR

Nagios

User Guide

Page 2: VMWARE VREALIZE OPERATIONS MANAGEMENT PACK FOR Nagios · 3 Blue Medora VMware vRealize Operations Management Pack for Nagios User Guide 1. Purpose The Blue Medora VMware vRealize

2 Blue Medora VMware vRealize Operations Management Pack for Nagios User Guide

1. Purpose . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32. Introduction to the Management Pack . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3

2.1 How the Management Pack Collects Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32.2 Data the Management Pack Collects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32.3 Inventory Tree (Traversal Spec) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4

3. Dashboards . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53.1 Nagios Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53.2 Nagios System Status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63.3 Nagios Health Investigation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73.4 Nagios Service Group . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83.5 Nagios Host Group . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93.6 Nagios Host Workload Utilization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .10

4. Views . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .115. Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .126. Tags . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .137. Alerts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .138. Analysis Badges . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .149. Troubleshooting the Management Pack . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .15

9.1 Troubleshooting an Adapter Instance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .159.2 Testing Connection Failures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .159.3 Viewing System Log Files. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .16

10. Appendix I: Metrics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1711. Appendix II: Alerts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2612.  Appendix III: Capacity Definitions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .26

TABLE OF CONTENTS

NOTE: This document supports the version of each product listed, as well as all subsequent versions, until a new edition replaces it.

You can find the most up-to-date technical documentation on the Blue Medora support site at: http://support.bluemedora.com.

The Blue Medora website also provides the latest product updates. If you have comments about this documentation, submit your feedback to: [email protected].

Page 3: VMWARE VREALIZE OPERATIONS MANAGEMENT PACK FOR Nagios · 3 Blue Medora VMware vRealize Operations Management Pack for Nagios User Guide 1. Purpose The Blue Medora VMware vRealize

3 Blue Medora VMware vRealize Operations Management Pack for Nagios User Guide

1. Purpose

The Blue Medora VMware vRealize Operations (vROps) Management Pack for Nagios User Guide describes the primary features of the Management Pack for Nagios, including dashboards, views, reports, alerts, and metrics that allow users to optimize the monitoring and management of Nagios resources from within vRealize Operations.

2. Introduction to the Management Pack

The Management Pack for Nagios is an embedded adapter for vRealize Operations (vROps) that monitors Nagios systems remotely. The Management Pack retrieves data regarding resources by connecting to each supported Nagios device.

This section includes the following topics:•  How the Management Pack Collects Data•  Data the Management Pack Collects•  Inventory Tree (Traversal Spec)

2.1 How the Management Pack Collects Data

During each data collection cycle, the Management Pack opens a connection to the configured Nagios device and queries it to retrieve metrics regarding Nagios resources.

The collection interval for the adapter instance resource determines how often the Management Pack collects data. The default collection interval is five minutes.

The Management Pack supports Autodiscovery and manual discovery of resources. When you enable Autodiscovery for an adapter instance, the Management Pack creates resources in vRealize Operations and collects data after the main collection query runs. If a new resource belongs to a resource kind that does not exist in vROps, the Management Pack creates the resource kind.

2.2 Data the Management Pack Collects

The Management Pack can collect performance data, relationships, and events for the following Nagios resources:

1. Nagios Host2. Nagios Host Group3. Nagios Service Group4. Nagios System5. Nagios System Group

Page 4: VMWARE VREALIZE OPERATIONS MANAGEMENT PACK FOR Nagios · 3 Blue Medora VMware vRealize Operations Management Pack for Nagios User Guide 1. Purpose The Blue Medora VMware vRealize

4 Blue Medora VMware vRealize Operations Management Pack for Nagios User Guide

2.3 Inventory Tree (Traversal Spec)

The Inventory Tree (Traversal Spec) feature within vROps allows you to easily navigate your environment. The hierarchical structure implicitly shows relationships among resource kinds and enables quick drill-downs to root-cause issues.

In addition to internal relationships, the Management Pack also includes the following external relationships:•  VMware Host -> Nagios Host•  VMware VM -> Nagios Host•  VMware VM -> Nagios System

Figure 1: Example Traversal Spec

Page 5: VMWARE VREALIZE OPERATIONS MANAGEMENT PACK FOR Nagios · 3 Blue Medora VMware vRealize Operations Management Pack for Nagios User Guide 1. Purpose The Blue Medora VMware vRealize

5 Blue Medora VMware vRealize Operations Management Pack for Nagios User Guide

3. Dashboards

Dashboards are the primary user interface that allow users to monitor Nagios resources from within vRealize Operations.

The following dashboards are available in the Management Pack:•  Nagios Overview•  Nagios System Status•  Nagios Health Investigation•  Nagios Service Group•  Nagios Host Group•  Nagios Host Workload Utilization

3.1 Nagios Overview

The Nagios Overview dashboard provides at-a-glance heatmaps depicting the overall health of your Nagios resources.

Figure 2: Nagios Overview Dashboard

Page 6: VMWARE VREALIZE OPERATIONS MANAGEMENT PACK FOR Nagios · 3 Blue Medora VMware vRealize Operations Management Pack for Nagios User Guide 1. Purpose The Blue Medora VMware vRealize

6 Blue Medora VMware vRealize Operations Management Pack for Nagios User Guide

3.2 Nagios System Status

The Nagios System Status dashboard allows you to select a system to view its related system group, hosts, and alerts, as well as aggregated host status counts and aggregated service status counts.

Figure 3: Nagios System Status Dashboard

Page 7: VMWARE VREALIZE OPERATIONS MANAGEMENT PACK FOR Nagios · 3 Blue Medora VMware vRealize Operations Management Pack for Nagios User Guide 1. Purpose The Blue Medora VMware vRealize

7 Blue Medora VMware vRealize Operations Management Pack for Nagios User Guide

3.3 Nagios Health Investigation

The Nagios Health Investigation dashboard allows you to select a Nagios resource from the Environment Overview widget to view its alerts, scoreboard, and selected metrics charts.

Figure 4: Nagios Health Investigation Dashboard

Page 8: VMWARE VREALIZE OPERATIONS MANAGEMENT PACK FOR Nagios · 3 Blue Medora VMware vRealize Operations Management Pack for Nagios User Guide 1. Purpose The Blue Medora VMware vRealize

8 Blue Medora VMware vRealize Operations Management Pack for Nagios User Guide

3.4 Nagios Service Group

The Nagios Service Group dashboard allows you to select a system from the widget on the left to view its related service groups. Select a resource from the topology graph on the right to view its alerts.

Figure 5: Nagios Service Group Dashboard

Page 9: VMWARE VREALIZE OPERATIONS MANAGEMENT PACK FOR Nagios · 3 Blue Medora VMware vRealize Operations Management Pack for Nagios User Guide 1. Purpose The Blue Medora VMware vRealize

9 Blue Medora VMware vRealize Operations Management Pack for Nagios User Guide

3.5 Nagios Host Group

The Nagios Host Group dashboard provides details about your Nagios host groups. Select a Nagios host group to view its related Nagios hosts, VMware hosts and VMs, and datastores as well as alerts and scoreboards.

Figure 6: Nagios Host Group Dashboard

Page 10: VMWARE VREALIZE OPERATIONS MANAGEMENT PACK FOR Nagios · 3 Blue Medora VMware vRealize Operations Management Pack for Nagios User Guide 1. Purpose The Blue Medora VMware vRealize

10 Blue Medora VMware vRealize Operations Management Pack for Nagios User Guide

3.6 Nagios Host Workload Utilization

The Nagios Host Workload Utilization dashboard is useful for viewing workload distribution of Nagios systems, hosts, and host groups. Select a resource from the workload graph to view its workload trends and capacity information.

Figure 7: Nagios Host Workload Utilization Dashboard

Page 11: VMWARE VREALIZE OPERATIONS MANAGEMENT PACK FOR Nagios · 3 Blue Medora VMware vRealize Operations Management Pack for Nagios User Guide 1. Purpose The Blue Medora VMware vRealize

11 Blue Medora VMware vRealize Operations Management Pack for Nagios User Guide

4. Views

The vROps Management Pack for Nagios creates views that allow the user to view statistics of metrics for various Nagios resources. The views help give a broad picture of the entire system, as opposed to a more in depth view.

Table 1: Management Pack Views

VIEW TYPE DESCRIPTION

Nagios Aggregated Host Counts Trend Shows host counts over the last 30 days

Nagios Aggregated Service Count Trend Shows service counts over the last 30 days

Nagios Right Sizing View - CPU Trend Shows total used CPU over the last 30 days

Nagios Right Sizing View - Disk Trend Shows total disk use over the last 30 days

Nagios Right Sizing View - Memory Trend Shows total memory use over the last 30 days

To access the Management Pack views, go to Environment > All Objects > Nagios Adapter and double-click on the desired Object (resource). Select the Details tab, then Views. The available views for that resource are listed and can be selected.

Figure 8: Accessing Management Pack Views

Page 12: VMWARE VREALIZE OPERATIONS MANAGEMENT PACK FOR Nagios · 3 Blue Medora VMware vRealize Operations Management Pack for Nagios User Guide 1. Purpose The Blue Medora VMware vRealize

12 Blue Medora VMware vRealize Operations Management Pack for Nagios User Guide

5. Reports

The Management Pack for Nagios contains two out-of-the-box reports, as listed below. Most reports contain one or more of the views listed in section “4. Views”. These reports can be exported and easily shared with key stakeholders in either .pdf or .csv formats.

Table 2: Management Pack Reports

REPORT DESCRIPTION

Nagios Right Sizing Report Shows CPU, Disk, and Memory used per host over the last 30 days for resource optimization

Nagios Status Summary Report Shows status counts for hosts and services per system as in Nagios System Status dashboard

To access the Management Pack reports, go to Environment > All Objects > Nagios Adapter and double-click on the desired Object (resource). Select the Reports tab, then Report Templates.

To run the selected report, click the Run Template icon ( ), then click Generated Reports, to select the report in your preferred format.

Figure 9: Accessing Management Pack Reports

Page 13: VMWARE VREALIZE OPERATIONS MANAGEMENT PACK FOR Nagios · 3 Blue Medora VMware vRealize Operations Management Pack for Nagios User Guide 1. Purpose The Blue Medora VMware vRealize

13 Blue Medora VMware vRealize Operations Management Pack for Nagios User Guide

6. Tags

To further customize your views within the Management Pack, two tags are currently available for filtering by:•  Nagios•  VMware to Nagios

To select a tag, perform the following steps:

NOTE: Depending on the dashboard, the steps for selecting a tag may vary slightly.

1. Click on the Content navigation shortcut ( ).2. Click on the Dashboards view in the navigation pane.3. Select Edit ( ) on the widget.4. Select Edit Widget ( ) for the widget you want to edit.5. Expand the Nagios Tag option.6. Select the desired tag and click Save.

7. Alerts

The Management Pack pulls alerts and events from Nagios resources and displays them in vRealize Operations as alerts. Refer to section “11. Appendix II: Alerts” for the full list of alerts.

Figure 10: Alert Example

Page 14: VMWARE VREALIZE OPERATIONS MANAGEMENT PACK FOR Nagios · 3 Blue Medora VMware vRealize Operations Management Pack for Nagios User Guide 1. Purpose The Blue Medora VMware vRealize

14 Blue Medora VMware vRealize Operations Management Pack for Nagios User Guide

8. Analysis Badges

Using the predictive analytics capabilities of the vROps Analysis Badges through capacity definitions, the Management Pack populates capacity and utilization breakdowns for several Nagios resource kinds. Refer to section “12. Appendix III: Capacity Definitions” for the full list of resource kinds and capacity definitions.

Figure 11: Analysis Badge Example

Page 15: VMWARE VREALIZE OPERATIONS MANAGEMENT PACK FOR Nagios · 3 Blue Medora VMware vRealize Operations Management Pack for Nagios User Guide 1. Purpose The Blue Medora VMware vRealize

15 Blue Medora VMware vRealize Operations Management Pack for Nagios User Guide

9. Troubleshooting the Management Pack

Known troubleshooting information can help you diagnose and correct common problems with the Management Pack for Nagios.

This section includes the following topics:•  Troubleshooting an Adapter Instance•  Testing Connection Failures•  Viewing System Log Files

9.1 Troubleshooting an Adapter Instance

Perform these general troubleshooting steps to diagnose and correct problems with an adapter instance:•  Edit the adapter instance and click Test Connection to verify the connection to vROps. Refer to

section “9.2 Testing Connection Failures”.•  View the collection status and collection state for the adapter instance resource on the Inventory

Explorer page in vROps.•  Check the adapter and collector logs for errors. Refer to section “9.3 Viewing System Log Files”, for

details.

9.2 Testing Connection Failures

When clicking Test Connection in the Manage Solution window when adding an adapter instance, the following connection errors are possible.

9.2.1 Bad API Key

Unable to establish a valid connection to the target system. Unable to retrieve data from the API. Error requesting data from the API: [“Invalid API Key”]

9.2.2 Bad Host/Port

Unable to establish a valid connection to the target system. Unable to retrieve data from the API. Network is unreachable, or connection timed out. Ensure Host and Port are correct.

9.2.3 Illegal Host

Unable to establish a valid connection to the target system. ‘Host’ is invalid. Accepted Host formats are: [Host Name, Fully Qualified Domain Name, IPv4, IPv6]

9.2.4 Unable to Retrieve Data from the API

Problem: This error is possible when your server does not have SSL configured, but the adapter instance advanced setting SSL Configuration is set to ‘No Verify’ or ‘Verify’.

Cause: When the server settings and adapter instance settings do not match, API responses will return no information.

Solution: Log in to the Nagios XI web interface and verify that your server has SSL enabled.

Page 16: VMWARE VREALIZE OPERATIONS MANAGEMENT PACK FOR Nagios · 3 Blue Medora VMware vRealize Operations Management Pack for Nagios User Guide 1. Purpose The Blue Medora VMware vRealize

16 Blue Medora VMware vRealize Operations Management Pack for Nagios User Guide

9.3 Viewing System Log Files

You can view adapter errors in the adapter and collector log files. You can view the adapter and collector log files in the vROps user interface or in an external log viewer.

•  The adapter log files are in the $VCOPS_BASE/user/log/adapters/NagiosAdapter/ folder.•  The collector log files are in the $VCOPS_BASE/user/log/ folder.

The logging level is set to WARNING by default. To troubleshoot issues, set the logging level to INFO. To view detailed messages, including micro steps, queries, and returned results, set the logging level to DEBUG.

You can set the base log level for the collector via Administration ( ) > Support > Logs > Select COLLECTOR folder > Select Edit Properties icon ( ) > Edit Root logger level.

NOTE: If you set the logging level to DEBUG, log files can become large very quickly. Set the logging level to DEBUG only for short periods of time.

For complete information about viewing log files and modifying log levels, refer to the VMware vRealize Operations online help.

Page 17: VMWARE VREALIZE OPERATIONS MANAGEMENT PACK FOR Nagios · 3 Blue Medora VMware vRealize Operations Management Pack for Nagios User Guide 1. Purpose The Blue Medora VMware vRealize

17 Blue Medora VMware vRealize Operations Management Pack for Nagios User Guide

10. Appendix I: Metrics

The Management Pack for Nagios collects the following metrics by Nagios Resource Kinds.

NOTE: Certain metrics (indicated with an asterisk (*)) will not load without admin privileges.

Table 3: Management Pack Metrics

RESOURCE KIND

RESOURCE GROUP

RESOURCE ATTRIBUTE

ATTRIBUTE TYPE ATTRIBUTE DESCRIPTION

Nagios Tag Relationships System Group Children string List of child System Group resources

Nagios Tag Relationships vSphere World Children string List of child vSphere World resources

Nagios System Group

Aggregated Host CPU Utilization

CPU Host Maximum Used float The maximum CPU used across all

Host descendants.

Nagios System Group

Aggregated Host CPU Utilization

CPU Host Minimum Used float The minimum CPU used across all

Host descendants.

Nagios System Group

Aggregated Host CPU Utilization

CPU Host Average Used float The average CPU used across all Host

descendants.

Nagios System Group

Aggregated Host Memory Utilization

Memory Host Maximum Used float The maximum memory used across all

Host descendants.

Nagios System Group

Aggregated Host Memory Utilization

Memory Host Minimum Used float The minimum memory used across all

Host descendants.

Nagios System Group

Aggregated Host Memory Utilization

Memory Host Average Used float The average memory used across all

Host descendants.

Nagios System Group

Aggregated Host Memory Utilization

Memory Host Total Used float The total memory used across all Host

descendants.

Nagios System Group

Aggregated Host Memory Utilization

Memory Host Total Capacity float The total memory capacity across all

Host descendants.

Nagios System Group Status Host Count integer The total number of hosts in the system

group.

Nagios System Group Status Host Down Count integer The total number of down hosts in the

system group.

Nagios System Group Status Host Up Count integer The total number of up hosts in the

system group.

Nagios System Group Status Host Unreachable

Count integer The total number of unreachable hosts in the system group.

Nagios System Group Status Host Pending Count integer The total number of pending hosts in

the system group.

Nagios System Group Status Host Unhandled

Problem Count integer The total number of unhandled host problems in the system group.

Page 18: VMWARE VREALIZE OPERATIONS MANAGEMENT PACK FOR Nagios · 3 Blue Medora VMware vRealize Operations Management Pack for Nagios User Guide 1. Purpose The Blue Medora VMware vRealize

18 Blue Medora VMware vRealize Operations Management Pack for Nagios User Guide

RESOURCE KIND

RESOURCE GROUP

RESOURCE ATTRIBUTE

ATTRIBUTE TYPE ATTRIBUTE DESCRIPTION

Nagios System Group Status Host Problem Count integer The total number of host problems in

the system group.

Nagios System Group Status Service Count integer The total number of services in the

system group.

Nagios System Group Status Service Down Count integer The total number of down services in

the system group.

Nagios System Group Status Service Up Count integer The total number of up services in the

system group.

Nagios System Group Status Service Unreachable

Count integer The total number of unreachable services in the system group.

Nagios System Group Status Service Pending

Count integer The total number of pending services in the system group.

Nagios System Group Status Service Unhandled

Problem Count integer The total number of unhandled service problems in the system group.

Nagios System Group Status Service Problem

Count integer The total number of service problems in the system group.

Nagios System Group Status

Value of 100 for Capacity Calculations

float Metric generated with purpose of Value of 100 for Capacity Calculations.

Nagios System Group

Aggregated Host Disk Utilization

Disk Host Maximum Used float The maximum disk used across all

Host descendants.

Nagios System Group

Aggregated Host Disk Utilization

Disk Host Minimum Used float The minimum disk used across all Host

descendants.

Nagios System Group

Aggregated Host Disk Utilization

Disk Host Average Used float The average disk used across all Host

descendants.

Nagios System Group

Aggregated Host Disk Utilization

Disk Host Total Used float The total disk used across all Host descendants.

Nagios System Group

Aggregated Host Disk Utilization

Disk Host Total Capacity float The total disk capacity across all Host

descendants.

Nagios System Group Relationships System Children string List of children System resources

Nagios System Group Relationships Nagios Adapter

Instance Parents string List of Parent Nagios Adapter Instance resources

Nagios Host CPU IO Wait float The aggregated value of 'IO Wait' metrics from child Service resources.

Nagios Host CPU Idle CPU float The aggregated value of 'Idle' metrics from child Service resources.

Nagios Host CPU System CPU Use float The aggregated value of 'System' metrics from child Service resources.

Page 19: VMWARE VREALIZE OPERATIONS MANAGEMENT PACK FOR Nagios · 3 Blue Medora VMware vRealize Operations Management Pack for Nagios User Guide 1. Purpose The Blue Medora VMware vRealize

19 Blue Medora VMware vRealize Operations Management Pack for Nagios User Guide

RESOURCE KIND

RESOURCE GROUP

RESOURCE ATTRIBUTE

ATTRIBUTE TYPE ATTRIBUTE DESCRIPTION

Nagios Host CPU Used CPU (User + System + IO Wait) float

The aggregated value of User, System, and IO Wait metrics from child Service resources.

Nagios Host CPU User CPU Use float The aggregated value of 'User' metrics from child Service resources.

Nagios Host Details Active Checks Enabled string Whether or not active checks are

enabled.

Nagios Host Details Alias string The alias of the Host.

Nagios Host Details Event Handler Enabled string Whether or not event handler is

enabled.

Nagios Host Details Flap Detection Enabled string Whether or not flap detection is 

enabled.

Nagios Host Details Notifications Enabled string Whether or not notifications are enabled.

Nagios Host Details Obsession Enabled string Whether or not obsession is enabled.

Nagios Host Details Passive Checks Enabled string Whether or not passive checks are

enabled.

Nagios Host Details Performance Data Processing Enabled string Whether or not the Host is configured 

to process performance data.

Nagios Host Details Problem Acknowledged string Whether or not the problem has been

acknowledged.

Nagios Host Disk Disk Free float The aggregated value of 'Free' metrics from child Service resources.

Nagios Host Disk Disk Size float The aggregated value of 'Total' metrics from child Service resources.

Nagios Host Disk Disk Used float The aggregated value of 'Used' metrics from child Service resources.

Nagios Host Memory Buffers and Cached Memory float

The aggregated value of 'Buffers and Cached' metrics from child Service resources.

Nagios Host Memory Free Memory float The aggregated value of 'Free' metrics from child Service resources.

Nagios Host Memory Shared Memory float The aggregated value of 'Shared' metrics from child Service resources.

Nagios Host Memory Total Memory float The aggregated value of 'Total' metrics from child Service resources.

Nagios Host Memory Used Memory float The aggregated value of 'Used' metrics from child Service resources.

Nagios Host Status Check Type integer The type of check for the Host.

Nagios Host Status Current Attempt integer Current check attempt for the Host.

Nagios Host Status Current State integer Current state of the Host.

Nagios Host Status Duration string When the Host was powered on.

Nagios Host Status Execution Time float Execution time of the Host.

Page 20: VMWARE VREALIZE OPERATIONS MANAGEMENT PACK FOR Nagios · 3 Blue Medora VMware vRealize Operations Management Pack for Nagios User Guide 1. Purpose The Blue Medora VMware vRealize

20 Blue Medora VMware vRealize Operations Management Pack for Nagios User Guide

RESOURCE KIND

RESOURCE GROUP

RESOURCE ATTRIBUTE

ATTRIBUTE TYPE ATTRIBUTE DESCRIPTION

Nagios Host Status Last Check string When the last check took place.

Nagios Host Status Last Notification string When the last notification occurred.

Nagios Host Status Last State Change string When the state of the Host last changed.

Nagios Host Status Latency float Latency of the Host.

Nagios Host Status Next Check string When the next check is scheduled to occur.

Nagios Host Status Service Count integer The number of Service descendants of this resource.

Nagios Host Status Service Problem Count integer The total number of Service

descendants whose status is not 'OK'.

Nagios Host Status Status Information string Status information for the Host.

Nagios Host StatusValue of 100 for Capacity Calculations

integer Metric generated with purpose of Value of 100 for Capacity Calculations.

Nagios Host Relationships Host Group Parents string List of parent Host Group resources

Nagios Host Relationships Parent System string Parent system

Nagios Host Relationships Service Children string List of child Service resources

Nagios Host Relationships Virtual Machine Parent string Parent virtual machine

Nagios Host Relationships Host System Parent string Parent host system

Nagios Host Service Host Name string The address of the Service resource.

Nagios Host Service Service Description string The description of the Service resource.

Nagios Host Service Check Latency float The latency of this Service on the associated Host resource.

Nagios Host Service State integer The current state of the Service resource.

Nagios Host Service Execution Time floatThe execution time of the latest status check for this Service on the associated Host resource.

Nagios Host Service Last Check string The time of the last state change of the Service resource.

Nagios Host Service Performance Data stringThe performance data returned from the latest status check for this Service on the associated Host resource.

Nagios Host Service Problem Acknowledged string If there is a problem, whether or not it

is acknowledged.

Nagios Host Service Status Text stringThe status text of the latest status check for this Service resource on the associated Host resource.

Nagios Host Service Host Parents string List of parent Host resources

Page 21: VMWARE VREALIZE OPERATIONS MANAGEMENT PACK FOR Nagios · 3 Blue Medora VMware vRealize Operations Management Pack for Nagios User Guide 1. Purpose The Blue Medora VMware vRealize

21 Blue Medora VMware vRealize Operations Management Pack for Nagios User Guide

RESOURCE KIND

RESOURCE GROUP

RESOURCE ATTRIBUTE

ATTRIBUTE TYPE ATTRIBUTE DESCRIPTION

Nagios Host Service Service Group Parents string List of parent Service Group resources

Nagios Host Group CPU Average CPU Use

(from Host children) float The average CPU used across all Host children.

Nagios Host Group CPU Maximum CPU Use

(from Host children) float The maximum CPU used across all Host children.

Nagios Host Group CPU Minimum CPU Use

(from Host children) float The minimum CPU used across all Host children.

Nagios Host Group Details Alias string The alias of the Host resource.

Nagios Host Group Disk Average Disk Use

(from Host children) float The average disk used across all Host children.

Nagios Host Group Disk Maximum Disk Use

(from Host children) float The maximum disk used across all Host children.

Nagios Host Group Disk Minimum Disk Use

(from Host children) float The minimum disk used across all Host children.

Nagios Host Group Disk Total Disk Space

(from Host children) float The total disk used across all Host children.

Nagios Host Group Disk Used Total Disk Use

(from Host children) float The total disk used across all Host children.

Nagios Host Group Memory

Average Memory Use (from Host children)

float The average memory used across all Host children.

Nagios Host Group Memory

Maximum Memory Use (from Host children)

float The maximum memory used across all Host children.

Nagios Host Group Memory

Minimum Memory Use (from Host children)

float The minimum memory used across all Host children.

Nagios Host Group Memory

Total Memory Capacity (from Host children)

float The total memory across all Host children.

Nagios Host Group Memory

Used Total Memory Use (from Host children)

float The total memory used across all Host children.

Nagios Host Group Status Host Count integer The total number of Host children.

Nagios Host Group Status Host Down Count integer The total number of Host children

where status is down.

Nagios Host Group Status Host Pending Count integer The total number of Host children

where status is pending.

Nagios Host Group Status Host Problem Count integer The total number of Host children

whose status is not 'OK'.

Nagios Host Group Status Host Unhandled

Problem Count integerThe total number of Host children whose status is not 'OK' and have an unacknowledged problem.

Page 22: VMWARE VREALIZE OPERATIONS MANAGEMENT PACK FOR Nagios · 3 Blue Medora VMware vRealize Operations Management Pack for Nagios User Guide 1. Purpose The Blue Medora VMware vRealize

22 Blue Medora VMware vRealize Operations Management Pack for Nagios User Guide

RESOURCE KIND

RESOURCE GROUP

RESOURCE ATTRIBUTE

ATTRIBUTE TYPE ATTRIBUTE DESCRIPTION

Nagios Host Group Status Host Unreachable

Count integer The total number of Host children where status is unreachable.

Nagios Host Group Status Host Up Count integer The total number of Host children

where status is up.

Nagios Host Group Status

Value of 100 for Capacity Calculations

integer Metric generated with purpose of Value of 100 for Capacity Calculations.

Nagios Host Group Relationships Host Children string List of child Host resources

Nagios Host Group Relationships Parent System string List of parent System resources

Nagios Service Group Status Host Count integer The total number of hosts in Service

Group

Nagios Service Group Status Host Down Count integer The total number of hists in the Service

Group where status is down.

Nagios Service Group Status Host Pending Count integer The total number of hosts in the

Service Group where status is pending.

Nagios Service Group Status Host Problem Count integer The total number of problems in the

Service Group.

Nagios Service Group Status Host Unhandled

Problems Count integer The total number of host problems in the Service Group that are unhandled.

Nagios Service Group Status Host Unreachable

Count integerThe total number of hosts in the Service Group where status is unreachable

Nagios Service Group Status Host Up Count integer The total number of hosts in the

Service Group where status is up.

Nagios Service Group Status Service Count integer The total number of services in the

Service Group

Nagios Service Group Status Service Critical

Count integer The total number of services in the Service Group where status is critical.

Nagios Service Group Status Service OK Count integer The total number of services in the

Service Group where status is okay.

Nagios Service Group Status Service Pending

Count integer The total number of services in the Service Group where status is pending.

Nagios Service Group Status Service Problem

Count integer The total number of service problems in the Service Group

Nagios Service Group Status Service Unhandled

Problem Count integer The total number of service problems in the Service Group that are unhandled.

Nagios Service Group Status Service Unknown

Count integerThe total number of services in the Service Group where status is unknown.

Nagios Service Group Status Service Warning

Count integer The total number of services in the Service Group where status is warning.

Nagios Service Group Relationships Service Children string List of child Service resources

Page 23: VMWARE VREALIZE OPERATIONS MANAGEMENT PACK FOR Nagios · 3 Blue Medora VMware vRealize Operations Management Pack for Nagios User Guide 1. Purpose The Blue Medora VMware vRealize

23 Blue Medora VMware vRealize Operations Management Pack for Nagios User Guide

RESOURCE KIND

RESOURCE GROUP

RESOURCE ATTRIBUTE

ATTRIBUTE TYPE ATTRIBUTE DESCRIPTION

Nagios Service Group Relationships Parent System string List of parent System resources

Nagios Service Group Service Host Name string The address of the Service resource.

Nagios Service Group Service Service Description string The description of the Service

resource.

Nagios Service Group Service Check Latency float The latency of this Service on the

associated Host resource.

Nagios Service Group Service State integer The current state of the Service

resource.

Nagios Service Group Service Execution Time float

The execution time of the latest status check for this Service on the associated Host resource.

Nagios Service Group Service Last Check string The time of the last state change of the

Service resource.

Nagios Service Group Service Performance Data string

The performance data returned from the latest status check for this Service on the associated Host resource.

Nagios Service Group Service Problem

Acknowledged string If there is a problem, whether or not it is acknowledged.

Nagios Service Group Service Status Text string

The status text of the latest status check for this Service resource on the associated Host resource.

Nagios Service Group Service Host Parents string List of parent Host resources

Nagios Service Group Service Service Group

Parents string List of parent Service Group resources

Nagios System Aggregate Host CPU Use

Average CPU Use (from Host children) float The average CPU used across all Host

children.

Nagios System Aggregate Host CPU Use

Maximum CPU Use (from Host children) float The maximum CPU used across all

Host children.

Nagios System Aggregate Host CPU Use

Minimum CPU Use (from Host children) float The minimum CPU used across all

Host children.

Nagios System Aggregate Host Disk Use

Average Disk Use (from Host children) float The average disk used across all Host

children.

Nagios System Aggregate Host Disk Use

Maximum Disk Use (from Host children) float The maximum disk used across all

Host children.

Nagios System Aggregate Host Disk Use

Minimum Disk Use (from Host children) float The minimum disk used across all Host

children.

Nagios System Aggregate Host Disk Use

Total Disk Capacity (from Host children) float The total disk capacity across all Host

children.

Nagios System Aggregate Host Disk Use

Used Total Disk Use (from Host children) float The total disk used across all Host

children.

Nagios System Aggregate Host Memory Use

Average Memory Use (from Host children)

float The average memory used across all Host children.

Page 24: VMWARE VREALIZE OPERATIONS MANAGEMENT PACK FOR Nagios · 3 Blue Medora VMware vRealize Operations Management Pack for Nagios User Guide 1. Purpose The Blue Medora VMware vRealize

24 Blue Medora VMware vRealize Operations Management Pack for Nagios User Guide

RESOURCE KIND

RESOURCE GROUP

RESOURCE ATTRIBUTE

ATTRIBUTE TYPE ATTRIBUTE DESCRIPTION

Nagios System Aggregate Host Memory Use

Maximum Memory Use (from Host children)

float The maximum memory used across all Host children.

Nagios System Aggregate Host Memory Use

Minimum Memory Use (from Host children)

float The minimum memory used across all Host children.

Nagios System Aggregate Host Memory Use

Total Memory Capacity (from Host children)

float The total memory across all Host children.

Nagios System Aggregate Host Memory Use

Used Total Memory Use (from Host children)

float The total memory used across all Host children.

Nagios System Status Host Count integer Number of hosts within this system.

Nagios System Status Host Down Count integer Number of hosts within this system that are down.

Nagios System Status Host Pending Count integer Number of hosts within this system that are unreachable.

Nagios System Status Host Problem Count integer Number of host problems within this system.

Nagios System Status Host Unhandled Problem Count integer Number of unhandled host problems

within this system.

Nagios System Status Host Unreachable Count integer Number of hosts within this system

that are unreachable.

Nagios System Status Host Up Count integer Number of hosts within this system that are up.

Nagios System Status Is Currently Running* string Whether or not the system is currently running.

Nagios System Status Service Count integer Number of services within this system.

Nagios System Status Service Critical Count integer Number of hosts within this system

that have state 'critical'.

Nagios System Status Service OK Count integer Number of hosts within this system that have state 'OK'.

Nagios System Status Service Pending Count integer Number of hosts within this system

that have state 'pending'.

Nagios System Status Service Problem Count integer Number of service problems within this

system.

Nagios System Status Service Unhandled Problem Count integer Number of unhandled service problems

within this system.

Nagios System Status Service Unknown Count integer Number of hosts within this system

that have state 'unknown'.

Nagios System Status Service Warning Count integer Number of hosts within this system

that have state 'warning'.

Nagios System StatusValue of 100 for Capacity Calculations

integer Metric generated with purpose of Value of 100 for Capacity Calculations.

Page 25: VMWARE VREALIZE OPERATIONS MANAGEMENT PACK FOR Nagios · 3 Blue Medora VMware vRealize Operations Management Pack for Nagios User Guide 1. Purpose The Blue Medora VMware vRealize

25 Blue Medora VMware vRealize Operations Management Pack for Nagios User Guide

RESOURCE KIND

RESOURCE GROUP

RESOURCE ATTRIBUTE

ATTRIBUTE TYPE ATTRIBUTE DESCRIPTION

Nagios System User Configuration

Active Host Checks Enabled* string Whether or not active host checks are

enabled.

Nagios System User Configuration

Active Service Checks Enabled* string Whether or not active service checks

are enabled.

Nagios System User Configuration

Event Handlers Enabled* string Whether or not event handlers are

enabled.

Nagios System User Configuration

Notifications Enabled* string Whether or not notifications are 

enabled.

Nagios System User Configuration

Passive Host Checks Enabled* string Whether or not passive host checks are

enabled.

Nagios System User Configuration

Passive Service Checks Enabled* string Whether or not passive service checks

are enabled.

Nagios System Relationships Host Group Children string List of child Host Group resources

Nagios System Relationships System Group Parents string List of parent System Group resources

Nagios System Relationships Virtual Machine Parent string Parent virtual machine

Nagios System Relationships Service Group Children string List of child Service Group resources

Nagios System Relationships Host Children string List of child Host resources

Page 26: VMWARE VREALIZE OPERATIONS MANAGEMENT PACK FOR Nagios · 3 Blue Medora VMware vRealize Operations Management Pack for Nagios User Guide 1. Purpose The Blue Medora VMware vRealize

26 Blue Medora VMware vRealize Operations Management Pack for Nagios User Guide

11. Appendix II: Alerts

The Management Pack for Nagios populates alerts originating from the Nagios XI API and makes them available in vROps. Refer to the full list of alerts as shown below:

•  Service State Critical•  Service State Warning•  Host State Critical•  Host State Warning

12. Appendix III: Capacity Definitions

The Management Pack uses the following capacity definitions, which help determine the value of Analysis Badges (refer to section “8. Analysis Badges”) within vRealize Operations. For more information on using Analysis Badges, refer to the VMware vRealize Operations online help.

Table 4: Capacity Definitions

CONTAINER USE IN WORKLOAD

Host

vRealize Calculated Host CPU Capacity yes

vRealize Calculated Host Disk Capacity yes

vRealize Calculated Host Memory Capacity yes

Host Group

vRealize Calculated Host Group CPU Capacity yes

vRealize Calculated Host Group Disk Capacity yes

vRealize Calculated Host Group Memory Capacity yes

System

vRealize Calculated System CPU Capacity yes

vRealize Calculated System Disk Capacity yes

vRealize Calculated System Memory Capacity yes

System Group

vRealize Calculated System Group CPU Capacity yes

vRealize Calculated System Group Disk Capacity yes

vRealize Calculated System Group Memory Capacity yes

Page 27: VMWARE VREALIZE OPERATIONS MANAGEMENT PACK FOR Nagios · 3 Blue Medora VMware vRealize Operations Management Pack for Nagios User Guide 1. Purpose The Blue Medora VMware vRealize

Copyright © 2016 Blue Medora Inc. All rights reserved. U.S. and international copyright and intellectual property laws protect this product. Blue Medora is a registered trademark or trademark of Blue Medora in the United States and/or other jurisdictions.

The Nagios name and logo are trademarks or registered trademarks of Nagios Enterprises, LLC in the United States and/or other jurisdictions. All other marks and names mentioned herein may be trademarks of their respective companies.

Blue Medora3225 N Evergreen Dr. NE Suite 103Grand Rapids, MI 49525

bluemedora.com

You can find the most up-to-date technical documentation on the Blue Medora support site at: http://support.bluemedora.com.

The Blue Medora website also provides the latest product updates. If you have comments about this documentation, submit your feedback to: [email protected].