© 2009 GroundWork Open Source, Inc. PROPRIETARY INFORMATION: Information contained herein is not for use or disclosure outside of GroundWork Open Source,

© 2009 GroundWork Open Source, Inc.PROPRIETARY INFORMATION: Information contained herein is not for use or disclosure outside of GroundWork Open Source, Inc. © 2007 GroundWork Open Source, Inc.

Getting Started with GroundWork Monitor

GroundWork Monitor Enterprise Edition 6.2

Page 1

© 2009 GroundWork Open Source, Inc. Page 2

Configuration• Nagios Configuration Schema• Configuration Tool Overview• Setting Up Hosts

Course Objectives for this Module

Getting Started with GroundWork Monitor


GroundWork Monitor Enterprise Edition 6.2Module 3 : Configuration


Configuration

Nagios Configuration Objects• Nagios is configured from a set of configuration files

• The main configuration file (nagios.cfg) contains the global settings for the Nagios application

• Ancillary files called the object files contain the configuration objects which describe the monitoring configuration

• These object files are comprised of data structures called configuration objects:define host { host_name localhost alias Linux Server #1 address 127.0.0.1 use generic-host check_command check-host-alive max_check_attempts 10 notification_interval 480}

define host { name generic-host process_perf_data 1 retain_status_information 1 flap_detection_enabled 1 retain_nonstatus_information 1 active_checks_enabled 1 passive_checks_enabled 1 check_period 24x7 obsess_over_host 0 check_freshness 0 check_command check-host-alive max_check_attempts 3 check_interval 0 event_handler_enabled 1 notifications_enabled 1 notification_interval 60 notification_period 24x7 notification_options d,u,r contact_groups nagiosadmin register 0}


Configuration

• Nagios is an extremely flexible framework that is controlled through its configuration objects

• Nagios configuration objects can be in one file or spread across multiple files

• They are comprised of directives (label=value pairs)

• They are structured objects and can inherit directives from other Nagios objects (i.e. templates)

• They are relational (i.e. hosts incorporate services and services incorporate commands)

• They can describe devices (hosts)

• They can define relationships (dependencies or groups)

• They can control procedures (escalations or event handlers)

• They can be used to control UI behavior (extended info)

• They define how devices will be checked (services, commands)

Nagios Configuration Objects


Configuration

Nagios Configuration Object Relationships

Hosts

Services

Commands

Contacts Contact Groups

HostDependencies

HostExtended Info

ServiceExtended Info

ServiceDependencies

Host Groups

Service Groups

HostEscalations

ServiceEscalations

Timeperiods

HostsServicesContactsHost EscalationsService Escalations

Templates Any Nagios Object


Rationale Behind the Monarch Design

Host Deletion Example

• When a host is retired from the network it will cause Host Alarms in Nagios, so it must be removed from Nagios

• One could start by deleting the host object for that host in the hosts.cfg file

• Then the preflight check would fail because services.cfg contains service objects referencing the missing host

• If the service objects are then located and deleted, there will still broken service dependency objects

• So one would need to delete all service dependencies referencing services deleted because the host went away

• Then there would still be references to the host in hostgroups which would cause preflight failures

• There could also be residual extended_host_info objects referencing the host

• And extended_service_info objects referencing each of the deleted services

• What is needed is a tool that understands not only the configuration data and object syntax but the relationships

Configuring Hosts and Services


Architectural View of Monarch

Configuration Tool Overview

Database Tables | Relationships

services

Nagios configuration objects

Monarch DB

hosts

contacts

hosts

contacts

escalationsescalations

services

Configuration UI

Hosts, Services, Contacts, EscalationsEtc.

Nagios Configurationfiles


Monarch Operation• Edit the data using the GUI

• Test configuration using Preflight Test

• Backup the data

• Create new config files using Commit

Architectural View of Monarch

MMonarch DB

Hosts, Services,Contacts…

Nagiosconfiguration

filesnagios/etc

Configuration UI

Services, Profiles, Hosts, Contacts, Escalations, Commands, Time Periods, Groups, Control, Tools

Backupdirectory

Workspacedirectory

Pre Flight Test

Commit

Load



Host Definition

Host Definition

Host Template Host Definition Service Template

Service Definition

Service Definition

Service Definition

Nagios Host and Service Objects

Host and Service Templates



Service Templategeneric-service

Host Templategeneric-host

Host Definitiondomain_controller

Service Templategeneric-service

Service DefinitionHost Alive

Service DefinitionDNS_Server

Implemented Host

ServiceHost

Nagios Host and Service Objects

Fully Implemented Host



ServiceCPU

Servicememory

Servicedisk

Servicehttpd

ServiceURL get

Service Profileweb monitoring

Monarch Services and Service Profiles

Service Profiles

Inside the Monarch database we can takeliberties with how we store the configuration data.

Inside the database preconfigured services are stored in the services table. The entriesIn this table, unlike the services objects in theNagios configuration files, are NOT associatedwith hosts.

That association happens in another table.

This allows us to ship a library of pre-configured,pre-tested services in the GroundWork product.

These “unassigned” services can also be grouped Into logical groups called Service Profiles.

Each Service Profile contains a collection of Services that would be appropriate for monitoringa particular device architecture



Host Templategeneric-host

Service Profileweb monitoring

Host Profile

Monarch Host Profiles

Host Profiles

In the Monarch database Service Profiles can also be associated with host templates to make Host Profiles.

A host profile contains everything you need to configure a device other than a hostname, IP Address and an alias.



Comparison of Nagios and Monarch Configuration Objects

Monarch Configuration Objects

Object Name Nagios GroundWork

Commands X X

Services X X

Pre-configured Services X

Host/Service Profiles X

Host/Service dependencies X X

Host/Service Escalations X X

Host/Service Escalation Trees X

Configuration Groups X

Contacts/Contactgroups X X

Hosts/Hostgroups X X

Services/Servicegroups X X

Host/Service Dependencies X X

Templates X X

Timeperiods X X



GroundWork Open Source, Inc.

139 Townsend Street, Suite 500

San Francisco, CA 94107

Phone: 415.992.4500

Website: www.gwos.com

Email: [email protected]

GroundWork Subscription Support: support.gwos.com

Confidential - Do not distribute

Thank you

http://www.gwos.com/

mailto:[email protected]

http://www.groundworkconnect.com/

Documents

© 2009 GroundWork Open Source, Inc. PROPRIETARY INFORMATION: Information contained herein is not for use or disclosure outside of GroundWork Open Source,