User Guide

Windows Icinga PowerShell Base

The nep-windows-icinga-powershell-base provides the basic command and template to monitoring checks on Windows Server by Icinga PowerShell.

The list of available checks are:

Note. The commands and datalists objects are provided directly by Icinga. The complete list of imported items are on Icinga PowerShell Plugins repo.

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-windows-icinga-powershell-base require the following nep:

  • nep-common

IcingaForWindows is provided by Icinga and have the following requirements:

  • Windows 2012 R2 or later

  • PowerShell Version 4.0 or later

  • Execution Policies allowing module/script execution

  • Access to packages.icinga.com at least from one location

All the info are available on Getting Starter Page

Setup instructions

To setup Package nep-windows-icinga-powershell-base, just use the Setup Utility:

nep-setup install nep-windows-icinga-powershell-base

The powershell script to install IcingaForWindows is NE4_Icinga4Windows.ps1 and should be run on each hosts where you need to run the checks.

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

The Package contains the following Director Objects.

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-icinga-powershell-check-directory

Yes

Checks files on Windows Directory

nx-st-icinga-powershell-check-scheduled-task

Yes

Checks Scheduled Task

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

Invoke-IcingaCheckDirectory

No

baskets/import/01-Invoke-IcingaCheckDirectory.json

Director Command

Invoke-IcingaCheckScheduledTask

No

baskets/import/02-Invoke-IcingaCheckScheduledTask.json

Director Data List

IcingaCheckDirectory Verbosity

No

baskets/import/01-Invoke-IcingaCheckDirectory.json

Director Data List

PowerShell ExecutionPolicies

No

baskets/import/01-Invoke-IcingaCheckDirectory.json

Director Data List

IcingaCheckScheduledTask State

No

baskets/import/02-Invoke-IcingaCheckScheduledTask.json

Director Data List

IcingaCheckScheduledTask Verbosity

No

baskets/import/02-Invoke-IcingaCheckScheduledTask.json

Director Service Template

nx-st-icinga-powershell-check-scheduled-task

No

baskets/import/nep-windows-icinga-powershell-base-04-service.json

Director Service Template

nx-st-icinga-powershell-check-directory

No

baskets/import/nep-windows-icinga-powershell-base-04-service.json