User Guide

VMWare VMD

The nep-vmware-vmd uses NetEye VMD module to deliver VMware monitoring without further access to the VMware infrastructure. With this package, it is possible to monitor:

  • VMware Host Systems

  • VMware Virtual Machines

  • VMware datastores

It has also the ability to automatically create Monitoring Objects, including parent-child relationships, using Icinga Director Automations.

Minimum supported environment

This package can be installed on systems running the software described below. Systems with equivalent components are also suitable for installation.

Required software

Requirements

NetEye

Version 4.25+

NetEye modules

Core, VMD

Package requirements

Service and Host Template shipped with package nep-vmware-vmd require the following nep:

  • nep-common

  • nep-vmware-api

To perform monitoring, this package makes direct queries to the underlying MariaDB of NetEye. To avoid issues, consider increasing the maximum number of connections that MariaDB allows is adequate. To increase the maximum number of allowed connections, set the max_connections variable of my.cnf file at an adequate value. Depending on how much objects are monitored, adequate means from a minimum of 200 to a maximum of some thousands.

[mysqld]
max_connections=200

Setup instructions

To setup Package nep-vmware-vmd, just use the Setup Utility:

nep-setup install nep-vmware-vmd

Available Objects

This section contains a description of all the Objects from this package that can be used to build your own monitoring environment.

Director Objects

This package contains the following Director Objects:

Host Templates

The following Host Templates can be used to freely create Host Objects. Remember to not edit these Host Templates because they will be restored/updated at the next NEP package update.

Host Template name

Description

nx-ht-status-vmd

Determine the status of a Host Object using the Power Status from VMD. It applyes only to VMs.

nx-ht-vmd-host-system

Describe a Host System that should be monitored using VMD

nx-ht-vmd-vcsa

Describe a VCSA that VMD uses as a gateway to get monitoring data. Only reachability is monitored.

nx-ht-vmd-virtual-machine

Describe a Virtual Machine that should be monitored using VMD

Service Templates

The following Service Templates can be used to freely create Service Objects, Service Apply Rules or Service Sets. Remember to not edit these Service Templates because they will be restored/updated at the next NEP Package update.

Template name

Run on Agent

Description

nx-st-agentless-vmd

No

Checks all aspects of a VMD-monitored Object

nx-st-agentless-vmd-datastore

No

Specific version of nx-st-agentless-vmd for Datastores

Service Sets

The following Service Sets can be used to freely monitor Host Objects. Remember to not edit these Service Sets because they will be restored/updated at the next NEP Package update.

Service Set name

Description

nx-ss-vmware-vmd-host-system-status

Monitor all basic aspects of a Host System

nx-ss-vmware-vmd-virtual-machine-status

Monitor all basic aspects of a Virtual Machine

Automations

The following Automations can be used to populate and maintain the monitored Host Objects.

Type

Automation name

Description

Import Source

nx-is-vmd-datastore

Gets all available Datastores from VMD

Import Source

x-is-vmd-host-system

Gets all available Host Systems from VMD

Import Source

nx-is-vmd-vcsa

Gets all available VCSA from VMD

Import Source

nx-is-vmd-virtual-machines

Gets all available Virtual Machines from VMD

Sync Rule

nx-sr-vmd-datastore

Creates SO to monitor all avilable Datastores

Sync Rule

nx-sr-vmd-host-system

Creates HO to monitor all available Host Systems

Sync Rule

nx-sr-vmd-vcsa

Creates HO to monitor availability of all available VCSA

Sync Rule

nx-sr-vmd-virtual-machines

Creates HO to monitor all available Virtual Machines

ITOA Dashboards

The Package does not provide any ITOA Dashboards right now.

Package’s objects list

Object Type

Object Name

Do not edit

Containing File

Director Command

nx-c-check-vmd-object

No

baskets/import/nep-vmware-vmd-02-command.json

Director Data List

[NX] VMD State calculation method

No

baskets/import/nep-vmware-vmd-01-datalist.json

Director Host Template

nx-ht-status-vmd

No

baskets/import/nep-vmware-vmd-03-host.json

Director Host Template

nx-ht-vmd-host-system

No

baskets/import/nep-vmware-vmd-03-host.json

Director Host Template

nx-ht-vmd-vcsa

No

baskets/import/nep-vmware-vmd-03-host.json

Director Host Template

nx-ht-vmd-virtual-machine

No

baskets/import/nep-vmware-vmd-03-host.json

Director Import Source

nx-is-vmd-datastore

No

baskets/import/nep-vmware-vmd-06-automation.json

Director Import Source

nx-is-vmd-host-system

No

baskets/import/nep-vmware-vmd-06-automation.json

Director Import Source

nx-is-vmd-vcsa

No

baskets/import/nep-vmware-vmd-06-automation.json

Director Import Source

nx-is-vmd-virtual-machines

No

baskets/import/nep-vmware-vmd-06-automation.json

Director Service Set

nx-ss-vmware-vmd-host-system-status

No

baskets/import/nep-vmware-vmd-05-serviceset.json

Director Service Set

nx-ss-vmware-vmd-virtual-machine-status

No

baskets/import/nep-vmware-vmd-05-serviceset.json

Director Service Template

nx-st-agentless-vmd-datastore

No

baskets/import/nep-vmware-vmd-04-service.json

Director Service Template

nx-st-agentless-vmd

No

baskets/import/nep-vmware-vmd-04-service.json

Director Sync Rule

nx-sr-vmd-datastore

No

baskets/import/nep-vmware-vmd-06-automation.json

Director Sync Rule

nx-sr-vmd-host-system

No

baskets/import/nep-vmware-vmd-06-automation.json

Director Sync Rule

nx-sr-vmd-vcsa

No

baskets/import/nep-vmware-vmd-06-automation.json

Director Sync Rule

nx-sr-vmd-virtual-machines

No

baskets/import/nep-vmware-vmd-06-automation.json