User Guide

VMWare Api

The nep-vmware-api provides the minimum requirements to implement VMWare Environment monitoring through VCSA and Directly

Using the provided objects, is possible to: - Cluster monitoring - ESXi monitoring - ESXi monitoring (used also with VMD Module) - ESXi monitoring Directly - vCenter Basic Service monitored - vCenter Basic Service monitored directly - vCenter Snapshots monitoring (age and count)

Using the provided objects, is possible to:

  • CPU Usage

  • Memory Usage

  • Host Connected

  • CPU Usage

  • Runtime Status

  • Runtime Issues

  • Uptime

  • NET Usage

  • Disk IO Stats Read

  • Disk IO Stats Write

  • Swap Usage

  • VMFS

  • Snapshot age

  • Snapshot count

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.20+

NetEye modules

Core

Package requirements

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

  • nep-common

To use the command you need to add the auth file under the Icinga2 dir, with NetEye this will be done by Setup like code below:

mkdir -p /neteye/shared/icinga2/conf/vmware-auth-files/
touch /neteye/shared/icinga2/conf/vmware-auth-files/generic-vcsa
chown -R root:icinga /neteye/shared/icinga2/conf/vmware-auth-files

cat /neteye/shared/icinga2/conf/vmware-auth-files/generic-vcsa
username=XXXX@
password=
chmod 640 /neteye/shared/icinga2/conf/vmware-auth-files/generic-vcsa

NB. The user should have permission read-only to all the VCSA Objects

Setup instructions

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

nep-setup install nep-vmware-api

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-vmware-object

Describe a generic VmWare object.

nx-ht-vmware-host

Describe a generic VmWare Host.

nx-ht-vmware-vm

Describe a generic VmWare VM.

nx-ht-vmware-vcenter

Describe a generic VmWare vCenter.

nx-ht-virtual-vmware-cluster

Describe a generic VmWare Cluster.

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-vmware

No

Checks all aspects of monitoring a VMWare environment directly

nx-st-agentless-vmware-datacenter

No

Checks all aspects of monitoring a VMWare ESXi montioring

nx-st-agentless-vmware-snapshot

No

Checks all aspects of monitoring VMWare Snapshots

nx-st-agentless-vmware-direct

No

Checks all aspects of monitoring VMWare directly

nx-st-agentless-vmware-cluster

No

Checks all aspects of monitoring VMWare cluster

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-cluster-datacenter

Cluster monitoring through VCSA: CPU Usage, Memory Usage,Host Connected

nx-ss-vmware-esx-datacenter

ESXi monitoring through VCSA: CPU Usage, Memory Usage,Runtime Status,Runtime Issues,Uptime

nx-ss-vmware-esx-datacenter-extended

ESXi monitoring through VCSA (used also with VMD Module):NET Usage,Disk IO Stats Read,Disk IO Stats Write,Swap Usage

nx-ss-vmware-esx-direct

ESXi monitoring Directly: CPU Usage, Memory Usage,Runtime Status,Runtime Issues,NET Usage,Disk IO Stats Read,Disk IO Stats Write,VMFS,Swap Usage,Uptime

nx-ss-vmware-vcenter-datacenter

vCenter Basic Service monitored through VCSA: VMFS,Host Connected,CPU Load,Memory Usage

nx-ss-vmware-vcenter-direct

vCenter Basic Service monitored directly: VMFS,Host Connected,CPU Load,Memory Usage

nx-ss-vmware-vcenter-snapshosts

vCenter Snapshots monitoring (age and count): Snapshot count,Snapshot age

ITOA Dashboards

The Package does not provide any ITOA Dashboards right now.

Package’s objects list

Object Type

Object Name

Editable

Containing File

Director Command

nx-c-check_vmware_api_datacenter

No

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

Director Command

nx-c-check_vmware_api

No

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

Director Command

nx-c-check_vmware_snapshot

No

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

Director Command

nx-c-vclusteralive

No

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

Director Data List

[NX] VmWare ESX command

No

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

Director Host Template

nx-ht-virtual-vmware-cluster

No

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

Director Host Template

nx-ht-vmware-host

No

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

Director Host Template

nx-ht-vmware-object

No

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

Director Host Template

nx-ht-vmware-vcenter

No

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

Director Host Template

nx-ht-vmware-vm

No

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

Director Service Set

nx-ss-vmware-cluster-datacenter

No

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

Director Service Set

nx-ss-vmware-esx-datacenter-extended

No

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

Director Service Set

nx-ss-vmware-esx-datacenter

No

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

Director Service Set

nx-ss-vmware-esx-direct

No

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

Director Service Set

nx-ss-vmware-vcenter-datacenter

No

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

Director Service Set

nx-ss-vmware-vcenter-direct

No

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

Director Service Set

nx-ss-vmware-vcenter-snapshosts

No

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

Director Service Template

nx-st-agentless-vmware-cluster

No

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

Director Service Template

nx-st-agentless-vmware-datacenter

No

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

Director Service Template

nx-st-agentless-vmware-direct

No

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

Director Service Template

nx-st-agentless-vmware

No

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

Director Service Template

nx-st-agentless-vmware-snapshot

No

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