Downtimes

Overview

Object name: DOWNTIME

Show

In order to list available recurring downtimes, use the SHOW action:

[root@centreon ~]# ./centreon -u admin -p centreon -o DOWNTIME -a show
id;name;description;activate
1;mail-backup;sunday backup;1
2;my downtime;a description;1

Columns are the following:

Column

Description

ID

Unique ID of the recurring downtime

Name

Name

Description

Short description of the recurring downtime

Activate

Whether or not the downtime is activated

In order to show resources of a downtime, use the Show action with parameters:

[root@centreon ~]# ./centreon -u admin -p centreon -o DOWNTIME -a show -v "mail-backup;host"

The parameters are the following:

Order

Description

1

Name of the downtime

2

(optional) Object type (host, hg, service, sg)

Add

In order to add a new downtime, use the ADD action:

[root@centreon ~]# ./centreon -u admin -p centreon -o DOWNTIME -a ADD -v "my new downtime;any description"

The required parameters are the following:

Order

Description

1

Name of the downtime

2

Description of the downtime

Del

In order to delete a downtime, use the DEL action. The downtime name is used for identifying the recurring downtime you would like to delete:

[root@centreon ~]# ./centreon -u admin -p centreon -o DOWNTIME -a DEL -v "my downtime"

Setparam

In order to set a specific parameter for a downtime, use the SETPARAM action:

[root@centreon ~]# ./centreon -u admin -p centreon -o DOWNTIME -a setparam -v "my downtime;name;my new downtime name"

You may change the following parameters:

Parameter

Description

name

Name

description

Description

Listperiods

If you want to retrieve the periods set on a recurring downtime, use the LISTPERIODS action:

[root@centreon ~]# ./centreon -u admin -p centreon -o DOWNTIME -a LISTPERIODS -v "my downtime"
position;start time;end time;fixed;duration;day of week;day of month;month cycle
1;1;23:00:00;24:00:00;1;;7;;all
2;1;00:00:00;02:00:00;1;;;1,2;none
3;1;13:45:00;14:40:00;1;;5;;first

Columns are the following:

Column

Description

Position

Position of the period; used for deleting a period from a recurring downtime

Start time

Start time of the recurring downtime

End time

End time of the recurring downtime

Fixed

Type of downtime (1 = fixed, 0 = flexible)

Duration

Duration of downtime when in flexible mode (seconds)

Day of week

1 - 7 (1 = monday … 7 = sunday)

Day of month

1 - 31

Month cycle

“all”, “none”, “first” or “last”. Determines when the downtime

will be effective on specific weekdays (i.e: all Sundays, last Sunday of the month, first Sunday of the month…)

Addweeklyperiod

In order to add a weekly period, use the ADDWEEKLYPERIOD action:

[root@centreon ~]# ./centreon -u admin -p centreon -o DOWNTIME -a ADDWEEKLYPERIOD \
-v "my downtime;00:00;04:00;0;7200;saturday,sunday"

The above example will set a downtime every saturday and sunday between 00:00 and 04:00.

Parameter

Description

Name

Name of the recurring downtime

Start time

Start time of the recurring downtime

End time

End time of the recurring downtime

Fixed

0 for flexible downtime, 1 for fixed

Duration

Duration of downtime when in flexible mode (seconds)

Day of week

Can be written with letters or numbers (1 to 7 or monday to sunday)

Addmonthlyperiod

In order to add a monthly period, use the ADDMONTHLYPERIOD action:

[root@centreon ~]# ./centreon -u admin -p centreon -o DOWNTIME -a ADDMONTHLYPERIOD \
-v "my downtime;19:00;22:00;1;;14,21"

The above example will set a downtime on every 14th and 21st day for all months.

Parameter

Description

Name

Name of the recurring downtime

Start time

Start time of the recurring downtime

End time

End time of the recurring downtime

Fixed

0 for flexible downtime, 1 for fixed

Duration

Duration of downtime when in flexible mode (seconds)

Day of month

1 to 31

Addspecificperiod

In order to add a specific period, use the ADDSPECIFICPERIOD action:

[root@centreon ~]# ./centreon -u admin -p centreon -o DOWNTIME -a ADDSPECIFICPERIOD \
-v "my downtime;19:00;22:00;1;;wednesday;first"

The above example will set a downtime on every first wednesday for all months.

Parameter

Description

Name

Name of the recurring downtime

Start time

Start time of the recurring downtime

End time

End time of the recurring downtime

Fixed

0 for flexible downtime, 1 for fixed

Duration

Duration of downtime when in flexible mode (seconds)

Day of week

Can be written with letters or numbers (1 to 7 or monday to sunday)

Month cycle

first or last

Addhost, addhostgroup, addservice, addservicegroup

If you want to associate a host, host group, service or service group to a recurring downtime, use the ADDHOST, ADDHOSTGROUP, ADDSERVICE or ADDSERVICEGROUP action:

[root@centreon ~]# ./centreon -u admin -p centreon -o DOWNTIME -a ADDHOST -v "my downtime;host_1"
[root@centreon ~]# ./centreon -u admin -p centreon -o DOWNTIME -a ADDSERVICE -v "my downtime;host_1,service_1"

Use the “|” delimiter in order to define multiple relationships.

Delhost, delhostgroup, delservice, delservicegroup

If you want to remove a host, host group, service or service group from a recurring downtime, use the DELHOST, DELHOSTGROUP, DELSERVICE or DELSERVICEGROUP action:

[root@centreon ~]# ./centreon -u admin -p centreon -o DOWNTIME -a DELHOST -v "my downtime;host_1"
[root@centreon ~]# ./centreon -u admin -p centreon -o DOWNTIME -a DELSERVICE -v "my downtime;host_1,service_1"

Sethost, sethostgroup, setservice, setservicegroup

The SETHOST, SETHOSTGROUP, SETSERVICE AND SETSERVICEGROUP actions are similar to their ADD counterparts, but they will overwrite the relationship definitions instead of appending them:

[root@centreon ~]# ./centreon -u admin -p centreon -o DOWNTIME -a ADDHOST -v "my downtime;host_1|host_2"
[root@centreon ~]# ./centreon -u admin -p centreon -o DOWNTIME -a ADDSERVICE -v "my downtime;host_1,service_1|host_2,service_2"

Use the “|” delimiter in order to define multiple relationships.