Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Overview

...

When accessing the Hosts Configuration Page, Administrators see an Host Table, listing all Hosts objects.

This table contains the following informations :

  • Differences
  • Name
  • Description
  • Address
  • Realm
  • PollerTag
  • Host Template
  • Sources
  • Status

...

 Image Added
 

This page

...

provides, on the left, an action Menu, used to :

  • Add a new Host
  • For changes automaticaly detected
    • Show Hosts

...

    • detected 
    • Accept differencies on selected elements

...

 

On the top of the table, A tool bar let Administrators the ability to :

  • Enable, Disable, Delete or Duplicate selected Hosts
  • Filter List by Name
  • Filter List by Template applied on Hosts
  

Create a new Host

...

See chapter Create a

...

Image Removed

 

...

Host creation form will be displayed.

This form is composed of tabs, corresponding to categories of properties :

  • Generic

  • Data

  • Monitoring

  • Checks

  • Notifications

  • Advanced

 

...

The left menu give to Administrators the ability to :

  • Validate the new host
  • Cancel the action
  • Delete the host

...

For each category, a corresponding form is displayed.

Generic

Generic properties contains the minimum properties requiered to create an Host :

...

  • the name of the Host

  • this field is requiered

...

  • extended description, displayed in Host Widget
  • Name is used if nothing is filled

...

  • address used to join the host on the network
  • can be an IP Address, or a resolvable hostname (Short or FQDN)

...

  • list of templates the new host should herit to
  • templates name are suggested when starting to fill the field

...

  • a list of available Hostgroups the new host should be in
  • more than one hostgroup can be selected

...

  • realm from which the host should be monitored
  • only one choice can be made

...

  • the priority is a feature used to show the criticality level of hosts
  • there is no impact on check method or notifications
  • by default, level of Host Template is used

...

  • this field is used to determine hosts located between poller and the new Host
  • filling this property helps in problem resolution, and in impact calculation

...

Data

 

Data is used to show and create variables used by Shinken to perform checks.

Those values are also called Macros.

As shown on the picture, when creating a new host, no data are available, even if the new host inherit from Template.

 

Image Removed
To see data that will be applied to host, it is necessary to first validate the new host, and come-back to its configuration.Image Removed

Data are displayed in two sections :

  • Local : data for this host only (custom data)
  • From Templates : data inherited from one or more templates

Data from templates are seperated by template names.

This allow Administrators to see what and where data have been get.

Data are represented by a Key and a Value.

When data are local, both of them can be modified.

When data are inherited, only values can be modified.

Image Removed

Monitoring

This form is used to configure properties that define monitoring for the host itself.

Monitoring is defined by the following properties :

  • Check Period
    • defines the period on which host will be checked
    • field is a list of values, corresponding to timeperiods defined in Time Periods
    • value is taken from templates if any, or default value is filled
  • Check Command
    • defines the short name of the command used to check if the host is available
    • field is a list of choices, defined by the Commands configuration
    • value is taken from templates if any, or default value is filled
  • Args
    • used to pass arguments to the Check Command
    • by default this value is empty
  • Max Check Attemps
    • defines the number of failed check attempt before declaring the host as down
    • value is taken from templates if any, or default value is filled
  • Check Interval
    • defines the number of minutes between two check of the host
    • value is taken from templates if any, or default value is filled
  • Retry Interval
    • defines the number of minutes before scheduling a re-check if the last one returned a non-UP state.
    • value is taken from templates if any, or default value is filled
  • Active Checks Enabled
    • defines if scheduled check will be enabled or not for this host
    • value is taken from templates if any, or default value is filled
  • Passive Checks Enabled
    • defines if passive check will be enabled or not for this host
    • value is taken from templates if any, or default value is filled
  • Maintenance Period
    • defines a reccuring downtime for the host. During the selected period, no notifications are sent
    • value is taken from the list of Time Periods
    • value is none per default, which means no downtime for the host
Image Removed

...

Checks

...

Checks is a read-only form, used to provide informations about checks (services) that will be made for the host.

By default, if no template applies on host, no check will be made.

...

If the host inehrits from a template which has services attached to it, checks will be filled with the description of those services.

In this example, we can see 3 checks, inherited from http template, and https template. Checks are displayed in tables, showing the following :

  • Name of the Check
  • Contacts Groups for the Check
  • Host templates using the Check
  • Check Command used
  • A "Try this check" action, allowing to try the check before validating

...

Host for more details.
  

Modify a host

To modify properties of a host:

  • first go on the Hosts page, from the Main menu,
  • and then click on the host name you want to modify.
Image Added
  

The form displayed is the same as the form used to create a new Host.
All fields are filled with Host properties.

  • Once changes have been made, configuration of the Host must be saved
    by clicking the Validate button available on the left menu.
  • Cancel button revert all changes to precedent configuration.

 

 

 

 

 

Image Added
  

Delete a host

To delete a host, you can use the form of the host, or delete it directly from the list page.

From the Form page

First go to the Hosts page, from the Main menu,then click on the host name you want to delete.

Once in the page displaying the form, click on the Delete button available on the left menu.

A confirmation popup will be displayed.

Image Added

From the main page

First go to the Hosts page, from the Main menu,

then click on the check box placed on the first column of the table.

Use the Action menu on the top to select Delete, and click to the Launch Button.

A confirmation popup will be displayed.

 

 

 

Info

Note: Using the Main page gives Administrators ability to Delete many Hosts at once.


Image Added

 

Image Added

Duplicate a host

Duplication operation is very useful when similar Hosts must be added.

To duplicate a host, first go on the Main page listing all hosts,

then select a host by clicking on the check box placed on the first column.

Image Added

 

 

Once selected, the host can be duplicated by selecting Duplicate in the select Action
of the tool bar.

 

Duplication is executed by clicking the Launch button.

Image Added
  

The name of host duplicated is suffixed by "(copy)".

 

Image Added

Using the Main page gives Administrators ability to Dublicate many Hosts at once.

Note: Duplicated Hosts are totaly detached and independant of the cloned Host.

No relation is made in the configuration.

 
  

Enable / Disable a Host

Disable operations help Administrators to temporarly exclude an element from the monitoring. It can be very helpfull to prepare a future configuration.

Enabling or Disabling Host can be made from the Host Configuration, or from the Main Hosts page.

 From the Host configuration

  • First go to the Hosts page, from the Main menu,
  • then click on the host name you want to enable/disable

Once in the page displaying the form, modify the Enabled property

  • Enable by clicking on the true button.
  • Disable by clicking on the false button
  • But you can also Inherit from template .

 

 

 

Image Added

From the Main page

First go to the Hosts page, from the Main

menu, then click on the check box placed on the first column of the table.

Image Added

Use the Action menu on the top to select Disable, and click to the Launch Button.

 

 

 



Image Added

In both cases, the result will be displayed in the table listing all Hosts.

Image Added

  

To Enable one or more Hosts, use the same procedure, by Choosing Enable.

Using the Main page gives Administrators ability to Disable or Enable many Hosts at once.

 

See and apply differences proposed by the Automatic detection modules

Differences are generated from the configuration daemon when an host is already validate in the configuration and

that the Automatic configuration modules (Sources and Taggers) did detect new properties (like custom data or new templates)

When an host have such a differences, a green square will be shown

on the "Differences" collumn.


Image Added
  

Moving your mouse over the square lets you see all proposed differences.

Here the VMWare discovery module did find the JIRA host in the 172.18.206.51 ESX server,

and it proposes to add the vmware-vm template to this host.

Image Added
  
If you agree with the difference, select the host:Image Added
  

And click on the button "Accept selected differences [ 1 ]".

The value in brackets depends on number of selected hosts containing differences.


By clicking on the button, you will accept the differences for all the selected hosts.




Image Added

 

 

Notifications

Advanced

 

 

...