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 |
|
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.