Nagios

Object Configuration Overview


Up To: Contents
See Also: Configuration Overview, Object Definitions

What Are Objects?

Objects are all the elements that are involved in the monitoring and notification logic. Types of objects include:

More information on what objects are and how they relate to each other can be found below.

Where Are Objects Defined?

Objects are defined in one or more configuration files that you specify using the cfg_file and/or cfg_dir directives in the main configuration file.

How Are Objects Defined?

Objects are defined in a flexible template format, which can make it much easier to manage your Nagios configuration in the long term. Basic information on how to define objects in your configuration files can be found here.

Once you get familiar with the basics of how to define objects, you should read up on object inheritance, as it will make your configuration more robust for the future. Seasoned users can exploit some advanced features of object definitions as described in the documentation on object tricks.

Objects Explained

Some of the main object types are explained in greater detail below...

Hosts are one of the central objects in the monitoring logic. Important attributes of hosts are as follows:

  • Hosts are usually physical devices on your network (servers, workstations, routers, switches, printers, etc).
  • Hosts have an address of some kind (e.g. an IP or MAC address).
  • Hosts have one or more more services associated with them.
  • Hosts can have parent/child relationships with other hosts, often representing real-world network connections, which is used in the network reachability logic.

Hosts

Services are one of the central objects in the monitoring logic. Services are associated with hosts and can be:

  • Attributes of a host (CPU load, disk usage, uptime, etc.)
  • Services provided by the host (HTTP, POP3, FTP, SSH, etc.)
  • Other things associated with the host (DNS records, etc.)

Services

Contacts are people involved in the notification process:

  • Contacts have one or more notification methods (cellphone, pager, email, instant messaging, etc.)
  • Contacts receive notifications for hosts and service they are responsible for

Contacts

Timeperiods are are used to control:

  • When hosts and services can be monitored
  • When contacts can receive notifications

Timeperiods

Commands are used to tell Nagios what programs, scripts, etc. it should execute to perform:

  • Host and service checks
  • Notifications
  • Event handlers
  • and more...

Commands