Skip to content

Users guide

Jump to bottom Edit New page
Pall Sigurdsson edited this page Mar 11, 2014 · 11 revisions

Welcome to the Adagios user guide. It's wiki document so anyone can contribute to this document.

This guide assumes that you already have Adagios installed and running. If not consult the Install Guide on how to get Adagios up and running.

Remember this Document is about Adagios which is an addon to Nagios/Icinga. This guide will not go in detail about Nagios/Icinga features like what configuration objects do, and how to monitor specific systems. Instead consider the following documents:

Adding custom headers and footers

If you are doing custom installs of Adagios you may want to have a custom header and footer displayed in the output of web pages that adagios renders. You can include any information that browsers understand (html, javascript, etc).

This can be used to create your own custom menus and such.

How it works

You can include your custom content by dropping appropriately named files in your "serverside_includes" directory as it is specified in adagios.conf (by default /etc/adagios/ssi).

Custom headers are included at the top of the markup and custom footers right before /body.

There are two types of headers/footers.

  • /etc/adagios/ssi/common-header.ssi and common-footer.ssi respectively. These are included on every page load.
  • /etc/adagios/ssi/CUSTOMPAGE-header.ssi and CUSTOMPAGE-footer.ssi where CUSTOMPAGE is a name of one specific page to include data on. For example if you want to include html on the services page, you would create a file called /etc/adagios/ssi/adagios.status.views.services-footer.ssi

Business Intelligence Module

We are currently working on a business intelligence module in Adagios. It's still under heavy development, but we better drop down a few notes to explain what its all about.

Things to know before you start using the BI module

Few definitions:

  • A "Business Process" (BP) is a way to group together services in Adagios
  • I repeat: Business Process is a grouping tool!
  • Business Process can contain one or more "Sub processes" which can be any of:
  • Nagios Service checks
  • Hosts
  • Hostgroup
  • Servicegroup
  • Another Business Process (so nesting is supported)
  • You can configure the status of a business process depending on its sub processes by setting the "Status Calculation Method". Examples of status calculation method for a business process is:
  • Use worst service state
  • Use worst host state
  • Use custom Business intelligence rules
  • Business Process states in Adagios are configurable, but generally the nagios-style states of 0,1,2,3 = ok,warn,crit,unknown are the default
  • You can create your own custom views to display the status of a business process
  • Graphs can be added to a business process
Add a custom footer
Add a custom sidebar
Clone this wiki locally