VMWARE VREALIZE OPERATIONS MANAGEMENT PACK FOR. Nagios. User Guide

Transcription

1 VMWARE VREALIZE OPERATIONS MANAGEMENT PACK FOR Nagios User Guide

2 TABLE OF CONTENTS 1. Purpose Introduction to the Management Pack How the Management Pack Collects Data Data the Management Pack Collects Inventory Tree (Traversal Spec) Dashboards Nagios Overview Nagios Health Investigation Workload Utilization Views Reports Tags Alerts Analysis Badges Troubleshooting the Management Pack Troubleshooting an Adapter Instance Testing Connection Failures Viewing System Log Files Appendix I: Metrics Appendix II: Alerts Appendix III: Capacity Definitions...26 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: The Blue Medora website also provides the latest product updates. If you have comments about this documentation, submit your feedback to: support@bluemedora.com. 2 Blue Medora VMware vrealize Operations Management Pack for Nagios User Guide

3 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: Blue Medora VMware vrealize Operations Management Pack for Nagios User Guide

4 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 -> VMware VM -> VMware VM -> Figure 1: Example Traversal Spec 4 Blue Medora VMware vrealize Operations Management Pack for Nagios User Guide

5 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 Health Investigation 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 5 Blue Medora VMware vrealize Operations Management Pack for Nagios User Guide

6 3.2 The 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: Dashboard 6 Blue Medora VMware vrealize Operations Management Pack for Nagios User Guide

7 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 7 Blue Medora VMware vrealize Operations Management Pack for Nagios User Guide

8 3.4 The 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: Dashboard 8 Blue Medora VMware vrealize Operations Management Pack for Nagios User Guide

9 3.5 The 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: Dashboard 9 Blue Medora VMware vrealize Operations Management Pack for Nagios User Guide

10 3.6 Workload Utilization The 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: Workload Utilization Dashboard 10 Blue Medora VMware vrealize Operations Management Pack for Nagios User Guide

11 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 s Trend Shows host counts over the last 30 days Nagios Aggregated Service 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 11 Blue Medora VMware vrealize Operations Management Pack for Nagios User Guide

12 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 Nagios Right Sizing Report Nagios Summary Report DESCRIPTION Shows CPU, Disk, and Memory used per host over the last 30 days for resource optimization Shows status counts for hosts and services per system as in Nagios System 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 ( your preferred format. ), then click Generated Reports, to select the report in Figure 9: Accessing Management Pack Reports 12 Blue Medora VMware vrealize Operations Management Pack for Nagios User Guide

13 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 13 Blue Medora VMware vrealize Operations Management Pack for Nagios User Guide

14 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 14 Blue Medora VMware vrealize Operations Management Pack for Nagios User Guide

15 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 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 ] 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 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] 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. 15 Blue Medora VMware vrealize Operations Management Pack for Nagios User Guide

16 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 ( folder > Select Edit Properties icon ( ) > Edit Root logger level. ) > Support > Logs > Select COLLECTOR 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. 16 Blue Medora VMware vrealize Operations Management Pack for Nagios User Guide

17 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 KIND Nagios Tag Nagios Tag GROUP Relationships Relationships Aggregated Host CPU Utilization Aggregated Host CPU Utilization Aggregated Host CPU Utilization Aggregated Host Memory Utilization Aggregated Host Memory Utilization Aggregated Host Memory Utilization Aggregated Host Memory Utilization Aggregated Host Memory Utilization System Children vsphere World Children CPU Host Maximum Used CPU Host Minimum Used CPU Host Average Used Memory Host Maximum Used Memory Host Minimum Used Memory Host Average Used Memory Host Total Used Memory Host Total Capacity TYPE Host Host Down Host Up Host Unreachable Host Pending Host Unhandled Problem DESCRIPTION List of child System resources List of child vsphere World resources The maximum CPU used across all Host descendants. The minimum CPU used across all Host descendants. The average CPU used across all Host descendants. The maximum memory used across all Host descendants. The minimum memory used across all Host descendants. The average memory used across all Host descendants. The total memory used across all Host descendants. The total memory capacity across all Host descendants. The total number of hosts in the system group. The total number of down hosts in the system group. The total number of up hosts in the system group. The total number of unreachable hosts in the system group. The total number of pending hosts in the system group. The total number of unhandled host problems in the system group. 17 Blue Medora VMware vrealize Operations Management Pack for Nagios User Guide

18 KIND GROUP TYPE Host Problem Service Service Down Service Up Aggregated Host Disk Utilization Aggregated Host Disk Utilization Aggregated Host Disk Utilization Aggregated Host Disk Utilization Aggregated Host Disk Utilization Service Unreachable Service Pending Service Unhandled Problem Service Problem Value of 100 for Capacity Calculations Disk Host Maximum Used Disk Host Minimum Used Disk Host Average Used Disk Host Total Used Disk Host Total Capacity DESCRIPTION The total number of host problems in the system group. The total number of services in the system group. The total number of down services in the system group. The total number of up services in the system group. The total number of unreachable services in the system group. The total number of pending services in the system group. The total number of unhandled service problems in the system group. The total number of service problems in the system group. Metric generated with purpose of Value of 100 for Capacity Calculations. The maximum disk used across all Host descendants. The minimum disk used across all Host descendants. The average disk used across all Host descendants. The total disk used across all Host descendants. The total disk capacity across all Host descendants. Relationships System Children List of children System resources Relationships Nagios Adapter Instance Parents CPU IO Wait CPU Idle CPU CPU System CPU Use List of Parent Nagios Adapter Instance resources The aggregated value of 'IO Wait' metrics from child Service resources. The aggregated value of 'Idle' metrics from child Service resources. The aggregated value of 'System' metrics from child Service resources. 18 Blue Medora VMware vrealize Operations Management Pack for Nagios User Guide

19 KIND GROUP CPU Used CPU (User + System + IO Wait) TYPE CPU User CPU Use Details Active Checks Enabled DESCRIPTION The aggregated value of User, System, and IO Wait metrics from child Service resources. The aggregated value of 'User' metrics from child Service resources. Whether or not active checks are enabled. Details Alias The alias of the Host. Details Details Event Handler Enabled Flap Detection Enabled Details Notifications Enabled Whether or not event handler is enabled. Whether or not flap detection is enabled. Whether or not notifications are enabled. Details Obsession Enabled Whether or not obsession is enabled. Details Details Details Passive Checks Enabled Performance Data Processing Enabled Problem Acknowledged Disk Disk Free Disk Disk Size Disk Disk Used Memory Buffers and Cached Memory Memory Free Memory Memory Shared Memory Memory Total Memory Memory Used Memory Whether or not passive checks are enabled. Whether or not the Host is configured to process performance data. Whether or not the problem has been acknowledged. The aggregated value of 'Free' metrics from child Service resources. The aggregated value of 'Total' metrics from child Service resources. The aggregated value of 'Used' metrics from child Service resources. The aggregated value of 'Buffers and Cached' metrics from child Service resources. The aggregated value of 'Free' metrics from child Service resources. The aggregated value of 'Shared' metrics from child Service resources. The aggregated value of 'Total' metrics from child Service resources. The aggregated value of 'Used' metrics from child Service resources. Check Type The type of check for the Host. Current Attempt Current check attempt for the Host. Current State Current state of the Host. Duration When the Host was powered on. Execution Time Execution time of the Host. 19 Blue Medora VMware vrealize Operations Management Pack for Nagios User Guide

20 KIND GROUP TYPE DESCRIPTION Last Check When the last check took place. Last Notification When the last notification occurred. Last State Change When the state of the Host last changed. Latency Latency of the Host. Next Check Service Service Problem When the next check is scheduled to occur. The number of Service descendants of this resource. The total number of Service descendants whose status is not 'OK'. Information information for the Host. Value of 100 for Capacity Calculations Metric generated with purpose of Value of 100 for Capacity Calculations. Relationships Host Parents List of parent Host resources Relationships Parent System Parent system Relationships Service Children List of child Service resources Relationships Virtual Machine Parent Parent virtual machine Relationships Host System Parent Parent host system Service Host Name The address of the Service resource. Service Service Description Service Check Latency Service State Service Execution Time Service Last Check Service Performance Data Service Problem Acknowledged Service Text The description of the Service resource. The latency of this Service on the associated Host resource. The current state of the Service resource. The execution time of the latest status check for this Service on the associated Host resource. The time of the last state change of the Service resource. The performance data returned from the latest status check for this Service on the associated Host resource. If there is a problem, whether or not it is acknowledged. The status text of the latest status check for this Service resource on the associated Host resource. Service Host Parents List of parent Host resources 20 Blue Medora VMware vrealize Operations Management Pack for Nagios User Guide

21 KIND GROUP Service CPU CPU CPU Service Parents Average CPU Use Maximum CPU Use Minimum CPU Use TYPE DESCRIPTION List of parent Service resources The average CPU used across all Host The maximum CPU used across all Host The minimum CPU used across all Host Details Alias The alias of the Host resource. Disk Disk Disk Disk Disk Memory Memory Memory Memory Memory Average Disk Use Maximum Disk Use Minimum Disk Use Total Disk Space Used Total Disk Use Average Memory Use (from Host children) Maximum Memory Use (from Host children) Minimum Memory Use (from Host children) Total Memory Capacity (from Host children) Used Total Memory Use (from Host children) The average disk used across all Host The maximum disk used across all Host The minimum disk used across all Host The total disk used across all Host The total disk used across all Host The average memory used across all Host The maximum memory used across all Host The minimum memory used across all Host The total memory across all Host The total memory used across all Host Host The total number of Host Host Down Host Pending Host Problem Host Unhandled Problem The total number of Host children where status is down. The total number of Host children where status is pending. The total number of Host children whose status is not 'OK'. The total number of Host children whose status is not 'OK' and have an unacknowledged problem. 21 Blue Medora VMware vrealize Operations Management Pack for Nagios User Guide

22 KIND GROUP Host Unreachable TYPE Host Up Value of 100 for Capacity Calculations DESCRIPTION The total number of Host children where status is unreachable. The total number of Host children where status is up. Metric generated with purpose of Value of 100 for Capacity Calculations. Relationships Host Children List of child Host resources Relationships Parent System List of parent System resources Host Host Down Host Pending Host Problem Host Unhandled Problems Host Unreachable Host Up Service Service Critical Service OK Service Pending Service Problem Service Unhandled Problem Service Unknown Service Warning The total number of hosts in Service The total number of hists in the Service where status is down. The total number of hosts in the Service where status is pending. The total number of problems in the Service. The total number of host problems in the Service that are unhandled. The total number of hosts in the Service where status is unreachable The total number of hosts in the Service where status is up. The total number of services in the Service The total number of services in the Service where status is critical. The total number of services in the Service where status is okay. The total number of services in the Service where status is pending. The total number of service problems in the Service The total number of service problems in the Service that are unhandled. The total number of services in the Service where status is unknown. The total number of services in the Service where status is warning. Relationships Service Children List of child Service resources 22 Blue Medora VMware vrealize Operations Management Pack for Nagios User Guide

23 KIND GROUP TYPE DESCRIPTION Relationships Parent System List of parent System resources Service Host Name The address of the Service resource. Service Service Description Service Check Latency Service State Service Execution Time Service Last Check Service Performance Data Service Problem Acknowledged Service Text The description of the Service resource. The latency of this Service on the associated Host resource. The current state of the Service resource. The execution time of the latest status check for this Service on the associated Host resource. The time of the last state change of the Service resource. The performance data returned from the latest status check for this Service on the associated Host resource. If there is a problem, whether or not it is acknowledged. The status text of the latest status check for this Service resource on the associated Host resource. Service Host Parents List of parent Host resources Service Aggregate Host CPU Use Aggregate Host CPU Use Aggregate Host CPU Use Aggregate Host Disk Use Aggregate Host Disk Use Aggregate Host Disk Use Aggregate Host Disk Use Aggregate Host Disk Use Aggregate Host Memory Use Service Parents Average CPU Use Maximum CPU Use Minimum CPU Use Average Disk Use Maximum Disk Use Minimum Disk Use Total Disk Capacity Used Total Disk Use Average Memory Use (from Host children) List of parent Service resources The average CPU used across all Host The maximum CPU used across all Host The minimum CPU used across all Host The average disk used across all Host The maximum disk used across all Host The minimum disk used across all Host The total disk capacity across all Host The total disk used across all Host The average memory used across all Host 23 Blue Medora VMware vrealize Operations Management Pack for Nagios User Guide

24 KIND GROUP Aggregate Host Memory Use Aggregate Host Memory Use Aggregate Host Memory Use Aggregate Host Memory Use Maximum Memory Use (from Host children) Minimum Memory Use (from Host children) Total Memory Capacity (from Host children) Used Total Memory Use (from Host children) TYPE DESCRIPTION The maximum memory used across all Host The minimum memory used across all Host The total memory across all Host The total memory used across all Host Host Number of hosts within this system. Host Down Host Pending Host Problem Host Unhandled Problem Host Unreachable Host Up Is Currently Running* Number of hosts within this system that are down. Number of hosts within this system that are unreachable. Number of host problems within this system. Number of unhandled host problems within this system. Number of hosts within this system that are unreachable. Number of hosts within this system that are up. Whether or not the system is currently running. Service Number of services within this system. Service Critical Service OK Service Pending Service Problem Service Unhandled Problem Service Unknown Service Warning Value of 100 for Capacity Calculations Number of hosts within this system that have state 'critical'. Number of hosts within this system that have state 'OK'. Number of hosts within this system that have state 'pending'. Number of service problems within this system. Number of unhandled service problems within this system. Number of hosts within this system that have state 'unknown'. Number of hosts within this system that have state 'warning'. Metric generated with purpose of Value of 100 for Capacity Calculations. 24 Blue Medora VMware vrealize Operations Management Pack for Nagios User Guide

25 KIND GROUP User Configuration User Configuration User Configuration User Configuration User Configuration User Configuration Active Host Checks Enabled* Active Service Checks Enabled* Event Handlers Enabled* Notifications Enabled* Passive Host Checks Enabled* Passive Service Checks Enabled* TYPE DESCRIPTION Whether or not active host checks are enabled. Whether or not active service checks are enabled. Whether or not event handlers are enabled. Whether or not notifications are enabled. Whether or not passive host checks are enabled. Whether or not passive service checks are enabled. Relationships Host Children List of child Host resources Relationships Relationships Relationships System Parents Virtual Machine Parent Service Children List of parent System resources Parent virtual machine List of child Service resources Relationships Host Children List of child Host resources 25 Blue Medora VMware vrealize Operations Management Pack for Nagios User Guide

26 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 Host vrealize Calculated Host CPU Capacity vrealize Calculated Host Disk Capacity vrealize Calculated Host Memory Capacity Host vrealize Calculated Host CPU Capacity vrealize Calculated Host Disk Capacity vrealize Calculated Host Memory Capacity System vrealize Calculated System CPU Capacity vrealize Calculated System Disk Capacity vrealize Calculated System Memory Capacity System vrealize Calculated System CPU Capacity vrealize Calculated System Disk Capacity vrealize Calculated System Memory Capacity USE IN WORKLOAD yes yes yes yes yes yes yes yes yes yes yes yes 26 Blue Medora VMware vrealize Operations Management Pack for Nagios User Guide

27 You can find the most up-to-date technical documentation on the Blue Medora support site at: The Blue Medora website also provides the latest product updates. If you have comments about this documentation, submit your feedback to: 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 Medora 3225 N Evergreen Dr. NE Suite 103 Grand Rapids, MI bluemedora.com