Centreon Broker Event Mapping
Centreon Broker uses global mapping tables for events that can be exchanged. This page lists properties available for each event type.
NEBβ
Acknowledgementβ
The acknowledgement of an incident means that the problem has been taken into account by a user of the monitoring service. When the user acknowledges the problem, Centreon Engine emits an acknowledgement event. This event is different in BBDO v2 and BBDO v3.
- BBDO v2
- BBDO v3
NEB::Acknowledgementβ
Category | element | ID |
---|---|---|
1 | 1 | 65537 |
The content of this message is serialized as follows:
Property | Type | Description |
---|---|---|
acknowledgement_type | short integer | 0 for a host acknowledgement, 1 for a service acknowledgement. |
author | string | Acknowledgement author. |
comment | string | Comment associated with the acknowledgement. |
deletion_time | time | Time at which the acknowledgement was deleted. If 0, it was not deleted. |
entry_time | time | Time at which the acknowledgement was created. |
host_id | unsigned integer | Host ID. |
instance_id | unsigned integer | Instance ID. |
is_sticky | boolean | Sticky flag. |
notify_contacts | boolean | Notification flag. |
persistent_comment | boolean | True if the comment is persistent. |
service_id | unsigned integer | Service ID. 0 for a host acknowledgement. |
state | short integer | Host / service state. |
notify_only_if_not_already_acknowledged | boolean | A notification should be sent only if not already acknowledged. |
NEB::PbAcknowledgementβ
Category | element | ID |
---|---|---|
1 | 45 | 65581 |
This event is a Protobuf event, so items are not serialized as in BBDO v2 events, but using the Protobuf 3 serialization mechanism. When BBDO v3 is used, no more NEB::Acknowledgement events should be sent. Instead, you should see NEB::PbAcknowledgement events.
Here is the definition of this protobuf event:
message Acknowledgement {
uint64 host_id = 1; // Host ID.
uint64 service_id = 2; // Service ID or 0 for a host acknowledgement.
uint64 instance_id = 3; // Instance ID.
enum ResourceType {
HOST = 0;
SERVICE = 1;
}
ResourceType type = 4; // Type of the resource.
string author = 5; // Acknowledgement author.
string comment_data = 6; // Comment associated with the acknowledgement.
bool sticky = 7; // Sticky flag.
bool notify_contacts = 8; // Notification flag.
uint64 entry_time = 9; // Time at which the acknowledgement was created.
uint64 deletion_time = 10; // Time at which the acknowledgement was deleted.
bool persistent_comment = 11; // True if the comment is persistent.
int32 state = 12; // The host / service state.
}
Commentβ
In several situations, the user must enter a comment in the Centreon interface. When they validate it, Centreon Engine emits a comment event. This event is different in BBDO v2 and BBDO v3.
- BBDO v2
- BBDO v3
NEB::Commentβ
Category | element | ID |
---|---|---|
1 | 2 | 65538 |
The content of this message is serialized as follows:
Property | Type | Description |
---|---|---|
author | string | Comment author. |
comment_type | short integer | 1 for a host comment, 2 for a service comment. |
data | string | Comment data (text). |
deletion_time | time | Time at which the comment was deleted. 0 if the comment was not deleted (yet). |
entry_time | time | Time at which the comment was created. |
entry_type | short integer | 1 for a user comment (through external command), 2 for a downtime comment, 3 for a flapping comment and 4 for an acknowledgement comment. |
expire_time | time | Comment expiration time. 0 if no expiration time. |
expires | bool | True if the comment expires. |
host_id | unsigned integer | Host ID. |
internal_id | unsigned integer | Internal monitoring engine ID of the comment. |
persistent | boolean | True if the comment is persistent. |
instance_id | unsigned integer | Instance ID. |
service_id | unsigned integer | Service ID. 0 if this is a host comment. |
source | short integer | 0 when the comment originates from the monitoring engine (internal) or 1 when the comment comes from another source (external). |
NEB::PbCommentβ
Category | element | ID |
---|---|---|
1 | 35 | 65571 |
This event is a Protobuf event, so items are not serialized as in BBDO v2 events, but using the Protobuf 3 serialization mechanism. When BBDO v3 is used, no more NEB::Comment events should be sent. Instead, you should see NEB::PbComment events.
The protobuf message is the following:
message BBDOHeader {
uint32 conf_version = 1; // A internal number not currently used.
}
message Comment {
BBDOHeader header = 1; // Not currently used.
enum Src {
INTERNAL = 0; // The comment originates from the monitoring engine.
EXTERNAL = 1; // The comment comes from another source.
}
enum Type {
NO_TYPE = 0;
HOST = 1;
SERVICE = 2;
}
enum EntryType {
NO_ENTRY_TYPE = 0;
USER = 1;
DOWNTIME = 2;
FLAPPING = 3;
ACKNOWLEDGMENT = 4;
}
string author = 2; // Comment author.
Type type = 3; // The comment type following the Type enum.
string data = 4; // The content of the comment.
uint64 deletion_time = 5; // Time a which the comment was deleted or 0 if the comment was not deleted (yet).
uint64 entry_time = 6; // Time at which the comment was created.
EntryType entry_type = 7; // Entry type following the EntryType enum.
uint64 expire_time = 8; // Comment expiration time or 0 if no expiration time.
bool expires = 9; // True if the comment expired.
uint64 host_id = 10; // Host ID.
uint64 internal_id = 11; // Internal monitoring engine ID of the comment.
bool persistent = 12; // True if the comment is persistent.
uint64 instance_id = 13; // Instance ID.
uint64 service_id = 14; // Service ID or 0 for a host comment.
Src source = 15; // Source of the comment following the Src enum.
}
Custom variableβ
A custom variable is essentially a variable with a name and a value. It often comes from Centreon Engine macros. For Centreon to work correctly, these custom variables must be sent to Centreon Broker. Each one is sent thanks to a custom variable event. This event is different in BBDO v2 and BBDO v3.
- BBDO v2
- BBDO v3
NEB::CustomVariableβ
Category | element | ID |
---|---|---|
1 | 3 | 65539 |
The content of this message is serialized as follows:
Property | Type | Description |
---|---|---|
enabled | boolean | True if the custom variable is enabled. |
host_id | unsigned integer | Host ID. |
modified | boolean | True if the variable was modified. |
name | string | Variable name. |
service_id | unsigned integer | Service ID or 0 if this is a host custom variable. |
update_time | time | Last time at which the variable was updated. |
var_type | short integer | 0 for a host custom variable, 1 for a service custom variable. |
value | string | Variable value. |
default_value | string | The default value of the custom var. |
NEB::PbCustomVariableβ
Category | element | ID |
---|---|---|
1 | 37 | 65573 |
This event is a Protobuf event, so items are not serialized as in BBDO v2 events, but using the Protobuf 3 serialization mechanism. When BBDO v3 is used, no more NEB::CustomVariable events should be sent. Instead, you should see NEB::PbCustomVariable events.
The protobuf message is the following:
message BBDOHeader {
uint32 conf_version = 1; // A internal number not currently used.
}
message CustomVariable {
enum VarType {
HOST = 0;
SERVICE = 1;
}
BBDOHeader header = 1; // Not used
uint64 host_id = 2; // Host ID.
uint64 service_id = 3; // Service ID or 0 for a host custom variable.
bool modified = 4; // True if the variable was modified.
string name = 5; // Variable name.
uint64 update_time = 6; // Last time at which the variable was updated.
string value = 7; // Variable value.
string default_value = 8; // The default value of the custom variable.
bool enabled = 9; // True if the custom variable is enabled.
bool password = 10; // True if the value must be hidden.
VarType type = 11; // One of the values of the VarType enum.
}
Custom variable statusβ
Custom variable status events are generated when a custom variable needs to be updated.
- BBDO v2
- BBDO v3
NEB::CustomVariableStatusβ
Category | element | ID |
---|---|---|
1 | 4 | 65540 |
The content of this message is serialized as follows:
Property | Type | Description |
---|---|---|
host_id | unsigned integer | Host ID. |
modified | boolean | True if the variable was modified. |
name | string | Variable name. |
service_id | unsigned integer | Service ID. 0 if this is a host custom variable. |
update_time | time | Last time at which the variable was updated. |
value | string | Variable value. |
NEB::PbCustomVariableStatusβ
Category | element | ID |
---|---|---|
1 | 38 | 65574 |
The Protobuf message for a PbCustomVariableStatus is the same as for a PbCustomVariable, except that some of the fields may not be filled in.
Here is the definition of this protobuf event:
message BBDOHeader {
uint32 conf_version = 1; // A internal number not currently used.
}
message CustomVariable {
enum VarType {
HOST = 0;
SERVICE = 1;
}
BBDOHeader header = 1; // Not used
uint64 host_id = 2; // Host ID.
uint64 service_id = 3; // Service ID or 0 for a host custom variable.
bool modified = 4; // True if the variable was modified.
string name = 5; // Variable name.
uint64 update_time = 6; // Last time at which the variable was updated.
string value = 7; // Variable value.
string default_value = 8; // The default value of the custom variable.
bool enabled = 9; // True if the custom variable is enabled.
bool password = 10; // True if the value must be hidden.
VarType type = 11; // One of the values of the VarType enum.
}
Downtimeβ
This event is emitted by Centreon Engine when a downtime is set on a resource.
- BBDO v2
- BBDO v3
NEB::Downtimeβ
Category | element | ID |
---|---|---|
1 | 5 | 65541 |
The content of this message is serialized as follows:
Property | Type | Description |
---|---|---|
actual_end_time | time | Actual time at which the downtime ended. |
actual_start_time | time | Actual time at which the downtime started. |
author | string | Downtime creator. |
downtime_type | short integer | 1 for service downtime, 2 for host downtime. |
deletion_time | time | Time at which the downtime was deleted. |
duration | time | Downtime duration. |
end_time | time | Scheduled downtime end time. |
entry_time | time | Time at which the downtime was created. |
fixed | boolean | True if the downtime is fixed, false if it is flexible. |
host_id | unsigned integer | Host ID. |
instance_id | unsigned integer | Instance ID. |
internal_id | unsigned integer | Internal monitoring engine ID. |
service_id | unsigned integer | Service ID. 0 if this is host downtime. |
start_time | time | Scheduled downtime start time. |
triggered_by | unsigned integer | Internal ID of the downtime that triggered this downtime. |
was_cancelled | boolean | True if the downtime was canceled. |
was_started | boolean | True if the downtime has been started. |
comment | string | Downtime comment. |
is_recurring | boolean | True if this downtime is recurring. |
recurring_tp | string | The recurring time period of the recurring downtime. |
come_from | short | Id of the parent recurring downtime for spawned downtimes. |
NEB::PbDowntimeβ
Category | element | ID |
---|---|---|
1 | 36 | 65572 |
This event is a Protobuf event, so items are not serialized as in BBDO v2 events, but using the Protobuf 3 serialization mechanism. When BBDO v3 is used, no more NEB::Downtime events should be sent. Instead, you should see NEB::PbDowntime events.
The protobuf message is the following:
message Downtime {
enum DowntimeType {
NOT_USED = 0;
SERVICE = 1; // The downtime is set on a service.
HOST = 2; // The downtime is set on a host.
ANY = 3; // This is kept for retro compatibility (not used).
};
uint64 id = 1; // Internal monitoring engine ID.
uint64 instance_id = 2; // Instance ID.
uint64 host_id = 3; // Host ID.
uint64 service_id = 4; // Service ID or 0 if this is host downtime.
string author = 5; // Downtime author.
string comment_data = 6; // Downtime comment.
DowntimeType type = 7; // One value from the previous enum.
uint32 duration = 8; // Downtime duration.
uint64 triggered_by = 9; // Internal ID of the downtime that triggered this downtime.
int64 entry_time = 10; // Time at which the downtime was created.
uint64 actual_start_time = 11; // Actual time at which the downtime started.
uint64 actual_end_time = 12; // Actual time at which the downtime ended.
uint64 start_time = 13; // Scheduled downtime start time.
uint64 deletion_time = 14; // Time at which the downtime was deleted.
uint64 end_time = 15; // Scheduled downtime end time.
bool started = 16; // True if the downtime has been started.
bool cancelled = 17; // True if the downtime was canceled.
bool fixed = 18; // True if the downtime is fixed, false if it is flexible.
}
Event handlerβ
Event handlers are optional system commands (scripts or executables) that are run whenever a resource state change occurs. When such a command is configured, an event handler event is emitted by Centreon Engine. These BBDO events are usually sent when Centreon Engine is restarted or reloaded.
- BBDO v2
- BBDO v3
NEB::EventHandlerβ
Category | element | ID |
---|---|---|
1 | 6 | 65542 |
The content of this message is serialized as follows:
Property | Type | Description |
---|---|---|
early_timeout | boolean | True if the event handler timed out. |
end_time | time | Time at which the event handler execution ended. |
execution_time | real | Execution time in seconds. |
handler_type | short integer | 0 for host-specific event handler, 1 for service-specific event handler, 2 for global host event handler and 3 for global service event handler. |
host_id | unsigned integer | Host ID. |
return_code | short integer | Value returned by the event handler. |
service_id | unsigned integer | Service ID. 0 if this is a host event handler. |
start_time | time | Time at which the event handler started. |
state | short integer | Host / service state. |
state_type | short integer | 0 for SOFT, 1 for HARD. |
timeout | short integer | Event handler timeout in seconds. |
command_args | string | Event handler arguments. |
command_line | string | Event handler command line. |
output | string | Output returned by the event handler. |
source_id | unsigned integer | The id of the source instance of this event. |
destination_id | unsigned integer | The id of the destination instance of this event. |
The event is the same as in BBDO v2. There is no Protobuf event.
Flapping statusβ
When the status of a resource is unstable, Centreon Engine tags it as flapping. In the past, a flapping status event was emitted in such cases. This no longer occurs. The flapping status event does not exist anymore.
Tagβ
The tag is a new configuration event currently used for categories and groups.
At the moment, it is used in parallel with group events and other things, but in the near future it should be more global.
- BBDO v2
- BBDO v3
There are no tag events in BBDO v2.
NEB::PbTagβ
Category | element | ID |
---|---|---|
1 | 34 | 65570 |
This event is a Protobuf event, so items are not serialized as in BBDO v2 events, but using the Protobuf 3 serialization mechanism. When BBDO v3 is used, no more NEB::Tag events should be sent. Instead, you should see NEB::PbTag events.
The protobuf message is the following:
enum TagType {
SERVICEGROUP = 0; // Tag representing a service group
HOSTGROUP = 1; // Tag representing a host group
SERVICECATEGORY = 2; // Tag representing a service category
HOSTCATEGORY = 3; // Tag representing a host category
}
message Tag {
uint64 id = 1; // Tag ID (unicity obtained by coupling it with the type)
enum Action {
ADD = 0; // With this action, the event adds a new tag.
DELETE = 1; // With this action, the event removes a tag.
MODIFY = 2; // With this action, the event modifies a tag.
}
Action action = 2; // The current action for this event.
TagType type = 3; // The type of this tag.
string name = 4; // Name of this tag.
int64 poller_id = 5; // Poller ID.
}
Hostβ
This event is emitted every time a change is made to the configuration of a host and the configuration is deployed.
- BBDO v2
- BBDO v3
NEB::Hostβ
Category | element | ID |
---|---|---|
1 | 12 | 65548 |
The content of this message is serialized as follows:
Property | Type | Description |
---|---|---|
acknowledged | boolean | true if the problem has been acknowledged |
acknowledgement_type | short integer | 0 none, 1 normal, 2 sticky |
action_url | string | url to obtain information about host |
active_checks_enabled | boolean | active check |
address | string | IP of the host |
alias | string | alias |
check_freshness | boolean | passive freshness check activated |
check_interval | real | interval in units (usually 60s) between 2 checks |
check_period | string | time period when checks are authorized |
check_type | short integer | 0 active, 1 passive |
current_check_attempt | short integer | number of failed checks |
current_state | short integer | 0 up, 1 down, 2 unreachable |
default_active_checks_enabled | boolean | same as active_checks_enabled |
default_event_handler_enabled | boolean | same as event_handler_enabled |
default_flap_detection_enabled | boolean | same as flap_detection_enabled |
default_notifications_enabled | boolean | same as notifications_enabled |
default_passive_checks_enabled | boolean | same as passive_checks_enabled |
downtime_depth | short integer | number of active downtimes |
display_name | string | name displayed in UI |
enabled | boolean | enabled |
event_handler | string | command executed when state changes |
event_handler_enabled | boolean | event_handler enabled |
execution_time | real | duration of last check |
first_notification_delay | real | delay before notify in units (usually 60s) |
flap_detection_enabled | boolean | flap detection enabled |
flap_detection_on_down | boolean | down state is taken into account for flap detection |
flap_detection_on_unreachable | boolean | unreachable state is taken into account for flap detection |
flap_detection_on_up | boolean | up state is taken into account for flap detection |
freshness_threshold | real | delay after check result is stale |
has_been_checked | boolean | check has been executed at least once |
high_flap_threshold | real | if percent state change is higher than this, host is considered flapping |
host_id | unsigned integer | id of the host |
host_name | string | name of the host |
icon_image | string | icon displayed in the UI for the host |
icon_image_alt | string | alternate string for icon_image |
instance_id | unsigned integer | id of the poller that checks host |
is_flapping | boolean | host is flapping |
last_check | time | time of last check |
last_hard_state | short integer | last hard state |
last_hard_state_change | time | time of last hard state change |
last_notification | time | time of last notification sent |
last_state_change | time | time of last state change |
last_time_down | time | time of the last failed check |
last_time_unreachable | time | time of the last failed check with all parent hosts down |
last_time_up | time | time of the last successful check |
last_update | time | time of message create |
latency | real | delay between scheduled check time and real check time |
low_flap_threshold | real | if percent state change is lower than this, host is not considered flapping |
max_check_attempts | short integer | number of failed check after which host state become a hard fail state |
next_check | time | next scheduled check time |
next_notification | time | next renotification time |
no_more_notifications | boolean | no other notification will be sent |
notes | string | tooltip in resources status page |
notes_url | string | clickable url in resources status page |
notification_interval | real | interval between two notifications |
notification_number | short integer | number of notifications sent since the start of the problem |
notification_period | string | time period during which notifications are allowed |
notifications_enabled | boolean | notifications allowed |
notify_on_down | boolean | users are notified if the host becomes down |
notify_on_downtime | boolean | users are notified if the host enters in downtime |
notify_on_flapping | boolean | users are notified if the host is flapping |
notify_on_recovery | boolean | users are notified if the host becomes up |
notify_on_unreachable | boolean | users are notified if the host becomes down and parents are down |
obsess_over | boolean | true if ocsp command is executed after check or notification command |
passive_checks_enabled | boolean | passive check |
percent_state_change | real | used by flapping and compared with high and low flap thresholds |
retry_interval | real | interval between two checks when host isn't in up state and state type is soft |
should_be_scheduled | boolean | no next check should be scheduled |
stalk_on_down | boolean | logs check output event changes if state is down |
stalk_on_unreachable | boolean | logs check output event if state is unreachable |
stalk_on_up | boolean | logs check output event if state is up |
statusmap_image | string | image displayed in map |
state_type | short integer | state soft 0 or hard 1 |
check_command | string | command executed |
output | string | output of the command |
perf_data | string | perfdata extracted from the command's output |
retain_nonstatus_information | boolean | unused |
retain_status_information | boolean | unused |
timezone | string | time zone of the host |
NEB::PbHostβ
Category | element | ID |
---|---|---|
1 | 30 | 65566 |
This event is a Protobuf event, so items are not serialized as in BBDO v2 events, but using the Protobuf 3 serialization mechanism. When BBDO v3 is used, no more NEB::Host events should be sent. Instead, you should see NEB::PbHost events.
The protobuf message is the following:
enum AckType {
NONE = 0;
NORMAL = 1;
STICKY = 2;
}
message TagInfo {
uint64 id = 1;
TagType type = 2;
}
message Host {
uint64 host_id = 1; // Host ID.
bool acknowledged = 2; // True if the problem has been acknowledged.
AckType acknowledgement_type = 3; // Acknowledgement type.
bool active_checks = 4; // True if active checks are enabled.
bool enabled = 5; // True if this host is enabled.
int32 scheduled_downtime_depth = 6; // Number of active downtimes.
string check_command = 7; // Check command.
int32 check_interval = 8; // Interval in units (usually 60 s) between 2 checks.
string check_period = 9; // Time period when checks are authorized
enum CheckType {
ACTIVE = 0;
PASSIVE = 1;
}
CheckType check_type = 10; // Type of the last check.
int32 check_attempt = 11; // Number of failed checks.
enum State {
UP = 0;
DOWN = 1;
UNREACHABLE = 2;
}
State state = 12; // Current state.
bool event_handler_enabled = 13; // True if an event handler is configured on this host.
string event_handler = 14; // Command executed when state changes.
double execution_time = 15; // Duration of the last check.
bool flap_detection = 16; // True if flap detection is enabled.
bool checked = 17; // check has been executed at least once.
bool flapping = 18; // True if the host is flapping.
int64 last_check = 19; // Timestamp of the last check.
State last_hard_state = 20; // Last hard state.
int64 last_hard_state_change = 21; // Timestamp of the last hard state change.
int64 last_notification = 22; // Timestamp of the last notification.
int32 notification_number = 23; // Current notification number or 0 if not.
int64 last_state_change = 24; // Timestamp of the last state change.
int64 last_time_down = 25; // Timestamp of the last failed check.
int64 last_time_unreachable = 26; // Timestamp of the last failed check with all parent hosts down.
int64 last_time_up = 27; // Timestamp of the last successful check.
int64 last_update = 28; // Timestamp of the last message creation.
double latency = 29; // Delay between scheduled check time and real check time.
int32 max_check_attempts = 30; // Number of failed checks after which host state becomes a hard fail state.
int64 next_check = 31; // Next scheduled check timestamp.
int64 next_host_notification = 32; // Next renotification timestamp.
bool no_more_notifications = 33; // If true, no other notification will be sent.
bool notify = 34; // Notifications allowed
string output = 35; // Output of the check command.
bool passive_checks = 36; // Passive checks are enabled.
double percent_state_change = 37; // Used by flapping and compared with high and low flap thresholds.
string perfdata = 38; // perfdata extracted from the command's output.
double retry_interval = 39; // interval between two checks when host isn't in up state and state type is soft.
bool should_be_scheduled = 40; // True if next check should be scheduled
bool obsess_over_host = 41; // True if OCSP command is executed after check or notification command.
enum StateType {
SOFT = 0; // State still not confirmed.
HARD = 1; // State confirmed.
}
StateType state_type = 42; // The state type.
string action_url = 43; // Optional url available in the WUI linked to this host.
string address = 44; // An address
string alias = 45; // An alias for this host.
bool check_freshness = 46; // Passive freshness check activated
bool default_active_checks = 47; // Same as active_checks but the default value.
bool default_event_handler_enabled = 48;// Same as event_handler but the default value.
bool default_flap_detection = 49; // Same as flap_detection but the default value.
bool default_notify = 50; // Same as notify but the default value.
bool default_passive_checks = 51; // Same as passive checks but the default value.
string display_name = 52; // Name displayed in the WUI
double first_notification_delay = 53; // Delay before notify in units (usually 60s).
bool flap_detection_on_down = 54; // Down state is taken into account for flap detection.
bool flap_detection_on_unreachable = 55;// Unreachable state is taken into account for flap detection.
bool flap_detection_on_up = 56; // Up state is taken into account for flap detection.
double freshness_threshold = 57; // Delay after check result is stale.
double high_flap_threshold = 58; // If percent state change is higher than this, host is considered flapping.
string name = 59; // Host name.
string icon_image = 60; // Icon displayed in the WUI for the host.
string icon_image_alt = 61; // Alternative string for icon_image.
int32 instance_id = 62; // Instance ID.
double low_flap_threshold = 63; // If percent state change is lower than this, host is not considered flapping.
string notes = 64; // Tooltip in resources status page.
string notes_url = 65; // clickable url in resources status page.
double notification_interval = 66; // Interval between two notifications.
string notification_period = 67; // Time period during which notifications are allowed.
bool notify_on_down = 68; // Users are notified if the host becomes down.
bool notify_on_downtime = 69; // Users are notified if the host enters downtime.
bool notify_on_flapping = 70; // Users are notified if the host is flapping.
bool notify_on_recovery = 71; // Users are notified if the host becomes up.
bool notify_on_unreachable = 72; // Users are notified if the host becomes unreachable.
bool stalk_on_down = 73; // Logs check output changes if state is down.
bool stalk_on_unreachable = 74; // Logs check output changes if state is unreachable.
bool stalk_on_up = 75; // Logs check output changes if state is up.
string statusmap_image = 76; // Image displayed in map.
bool retain_nonstatus_information = 77; // Unused
bool retain_status_information = 78; // Unused
string timezone = 79; // Time zone of the host.
uint64 severity_id = 80; // Severity ID.
repeated TagInfo tags = 81; // Tags linked to this host.
uint64 icon_id = 82; // Icon ID.
}
Host checkβ
This type of event is emitted by Centreon Engine when a check is performed on a host.
- BBDO v2
- BBDO v3
NEB::HostCheckβ
Category | element | ID |
---|---|---|
1 | 8 | 65544 |
The content of this message is serialized as follows:
Property | Type | Description |
---|---|---|
active_checks_enabled | boolean | True if active checks are enabled on the host. |
check_type | short integer | |
host_id | unsigned integer | Host ID. |
next_check | time | Time at which the next check is scheduled. |
command_line | string | Check command line. |
source_id | unsigned integer | The id of the source instance this event. |
destination_id | unsigned integer | The id of the destination instance of this event. |
NEB::PbHostCheckβ
Category | element | ID |
---|---|---|
1 | 39 | 65575 |
This event is a Protobuf event, so items are not serialized as in BBDO v2 events, but using the Protobuf 3 serialization mechanism. When BBDO v3 is used, no more NEB::HostCheck events should be sent. Instead, you should see NEB::PbHostCheck events.
The protobuf message is the following:
message BBDOHeader {
uint32 conf_version = 1; // A internal number not currently used.
}
enum CheckType {
CheckActive = 0;
CheckPassive = 1;
}
message Check {
BBDOHeader header = 1;
bool active_checks_enabled = 2; // True if active checks are enabled on the host.
CheckType check_type = 3; // One of the values in CheckType.
string command_line = 4; // Check command line.
uint64 host_id = 5; // Host ID.
uint64 next_check = 6; // Timestamp at which the next check is scheduled.
uint64 service_id = 7; // Service ID or 0 for a host check.
}
Host dependencyβ
This event is emitted when a dependency between hosts is defined, and the configuration is deployed.
- BBDO v2
- BBDO v3
NEB::HostDependencyβ
Category | element | ID |
---|---|---|
1 | 9 | 65545 |
The content of this message is serialized as follows:
Property | Type | Description |
---|---|---|
dependency_period | string | Time period when the dependency is available. |
dependent_host_id | unsigned integer | Host ID of the resource this host is dependent on |
enabled | boolean | True if the dependency is enabled. |
execution_failure_options | string | Some values among "up", "down", "unreachable", "pending", "none", "all" |
inherits_parent | boolean | True if the dependency is inherited from a parent |
host_id | unsigned integer | Host ID. |
notification_failure_options | string | Same values as for execution_failure_options |
The event is the same as in BBDO v2. There is no Protobuf event.
Host groupβ
This event is emitted when a host group is created.
- BBDO v2
- BBDO v3
NEB::HostGroupβ
Category | element | ID |
---|---|---|
1 | 10 | 65546 |
The content of this message is serialized as follows:
Property | Type | Description |
---|---|---|
host_group_id | unsigned integer | id of the group |
name | string | Group name. |
enabled | boolean | True if the group is enabled, false if it is not (deletion). |
poller_id | unsigned integer | id of the poller |
The event is the same as in BBDO v2. There is no Protobuf event.
Host group memberβ
This is a configuration event. It is sent just after a hostgroup event to detail members of the group to configure. Even in BBDO v3, we still use the BBDO v2 version of this event.
- BBDO v2
- BBDO v3
NEB::HostGroupMemberβ
Category | element | ID |
---|---|---|
1 | 11 | 65547 |
The content of this message is serialized as follows:
Property | Type | Description |
---|---|---|
enabled | boolean | True if the membership is enabled, false if it is not (deletion). |
group | string | Group name. |
instance_id | unsigned integer | Instance ID. |
host_id | unsigned integer | Host ID. |
source_id | unsigned integer | The id of the source instance of this event. |
destination_id | unsigned integer | The id of the destination instance of this event. |
The event is the same as in BBDO v2. There is no Protobuf event.
Host parentβ
This is a configuration event sent when a host parent is defined. Even in BBDO v3, we still use the BBDO v2 version of this event.
- BBDO v2
- BBDO v3
NEB::HostParentβ
Category | element | ID |
---|---|---|
1 | 13 | 65549 |
The content of this message is serialized as follows:
Property | Type | Description |
---|---|---|
enabled | boolean | True if parenting is enabled, false if it is not (deletion). |
child_id | unsigned integer | Child host ID. |
parent_id | unsigned integer | Parent host ID. |
The event is the same as in BBDO v2. There is no Protobuf event.
Host statusβ
This is an event emitted by Centreon Engine when a host has real time modifications (status, output, metrics, etc.).
- BBDO v2
- BBDO v3
NEB::HostStatusβ
Category | element | ID |
---|---|---|
1 | 14 | 65550 |
The content of this message is serialized as follows:
Property | Type | Description |
---|---|---|
acknowledged | boolean | problem has been acknowledged |
acknowledgement_type | short integer | 0 none, 1 normal, 2 sticky |
active_checks_enabled | boolean | True if active checks are enabled on the host. |
check_interval | real | interval in units (usually 60 s) between 2 checks |
check_period | string | time period when checks are authorized |
check_type | short integer | 0 active, 1 passive |
current_check_attempt | short integer | number of failed checks |
current_state | short integer | 0 up, 1 down, 2 unreachable |
downtime_depth | short integer | number of active downtimes |
enabled | boolean | enabled |
event_handler | string | command executed when state changes |
event_handler_enabled | boolean | event_handler enabled |
execution_time | real | duration of last check |
flap_detection_enabled | boolean | flap detection enabled |
has_been_checked | boolean | check has been executed at least once |
host_id | unsigned integer | id of the host |
is_flapping | boolean | host is flapping |
last_check | time | time of last check |
last_hard_state | State | last hard state |
last_hard_state_change | time | time of last hard state change |
last_notification | time | time of last notification sent |
last_state_change | time | time of last state change |
last_time_down | time | time of the last failed check |
last_time_unreachable | time | time of the last failed check with all parent hosts down |
last_time_up | time | time of the last successful check |
last_update | time | time of message creation |
latency | real | delay between scheduled check time and real check time |
max_check_attempts | short integer | number of failed checks after which host state becomes a hard fail state |
next_check | time | Time at which the next check is scheduled. |
next_host_notification | time | next renotification time |
no_more_notifications | boolean | no other notification will be sent |
notification_number | short integer | number of notifications sent since the start of the problem |
notifications_enabled | boolean | notifications allowed |
obsess_over | boolean | true if ocsp command is executed after check or notification command |
passive_checks_enabled | boolean | passive check |
percent_state_change | real | used by flapping and compared with high and low flap thresholds |
retry_interval | real | interval between two checks when host isn't in up state and state type is soft |
should_be_scheduled | boolean | next check should be scheduled |
state_type | StateType | SOFT HARD |
check_command | string | command executed |
output | string | output of the command |
perf_data | string | perfdata extracted from the command's output |
NEB::PbHostStatusβ
Category | element | ID |
---|---|---|
1 | 32 | 65538 |
This event is a Protobuf event, so items are not serialized as in BBDO v2 events, but using the Protobuf 3 serialization mechanism. When BBDO v3 is used, no more NEB::HostStatus events should be sent. Instead, you should see NEB::PbHostStatus events.
Here is the definition of this protobuf event:
enum AckType {
NONE = 0;
NORMAL = 1;
STICKY = 2;
}
message HostStatus {
uint64 host_id = 1; // Host ID.
bool checked = 2; // True if the host is checked.
enum CheckType {
ACTIVE = 0;
PASSIVE = 1;
}
CheckType check_type = 3; // Type of the last check (ACTIVE/PASSIVE).
enum State {
UP = 0;
DOWN = 1;
UNREACHABLE = 2;
}
State state = 4; // Current state of the host.
enum StateType {
SOFT = 0;
HARD = 1;
}
StateType state_type = 5; // Confirmed or not state (HARD/SOFT).
int64 last_state_change = 6; // Timestamp of the last state change.
State last_hard_state = 7; // Last hard state.
int64 last_hard_state_change = 8; // Timestamp of the last hard state.
int64 last_time_up = 9; // Timestamp of the last up state.
int64 last_time_down = 10; // Timestamp of the last down state.
int64 last_time_unreachable = 11; // Timestamp of the last unreachable state.
string output = 12; // Check output.
string long_output = 13; // Check long output.
string perfdata = 14; // Performance data.
bool flapping = 15; // True if the host is flapping.
double percent_state_change = 16; // Used by flapping and compared with high and low flap thresholds
double latency = 17; // Delay between scheduled check time and real check time.
double execution_time = 18; // Duration of last check.
int64 last_check = 19; // Timestamp of the last check.
int64 next_check = 20; // Timestamp at which the next check is scheduled.
bool should_be_scheduled = 21; // True if the next check should be scheduled.
int32 check_attempt = 22; // Number of failed checks.
int32 notification_number = 23; // Number of notifications sent since the start of the problem.
bool no_more_notifications = 24; // No other notification will be sent.
int64 last_notification = 25; // Timestamp of last notification sent.
int64 next_host_notification = 26; // Timestamp of next renotification.
AckType acknowledgement_type = 27; // One value of the AckType enum.
int32 scheduled_downtime_depth = 28;// Number of active downtimes.
}
Instanceβ
This event is emitted by Centreon Engine when Engine starts to send its configuration or when Engine stops.
- BBDO v2
- BBDO v3
NEB::Instanceβ
Category | element | ID |
---|---|---|
1 | 15 | 65551 |
The content of this message is serialized as follows:
Property | Type | Description |
---|---|---|
engine | string | Name of the monitoring engine used on this instance. |
id | unsigned integer | Instance ID. |
name | string | Instance name. |
is_running | boolean | Whether or not this instance is running. |
pid | unsigned integer | Monitoring engine PID. |
program_end | time | Time at which the instance shut down. |
program_start | time | Time at which the instance started. |
version | string | Version of the monitoring engine used on this instance. |
NEB::PbInstanceβ
Category | element | ID |
---|---|---|
1 | 44 | 65580 |
This event is a Protobuf event, so items are not serialized as in BBDO v2 events, but using the Protobuf 3 serialization mechanism. When BBDO v3 is used, no more NEB::Instance events should be sent. Instead, you should see NEB::PbInstance events.
Here is the definition of this protobuf event:
message BBDOHeader {
uint32 conf_version = 1; // A internal number not currently used.
}
message Instance {
BBDOHeader header = 1;
string engine = 2; // Name of the monitoring engine used on this instance.
bool running = 3; // Whether or not this instance is running.
string name = 4; // Instance name.
int64 pid = 5; // Monitoring engine PID.
uint64 instance_id = 6; // Instance ID.
int64 end_time = 7; // Timestamp at which the instance shuts down.
int64 start_time = 8; // Timestamp at which the instance starts.
string version = 9; // Version of the emitter of this message.
}
Instance statusβ
This event is emitted by Centreon Engine regularly as a watchdog. This event tells Broker that the poller is still alive (with various other information).
- BBDO v2
- BBDO v3
NEB::InstanceStatusβ
Category | element | ID |
---|---|---|
1 | 16 | 65552 |
The content of this message is serialized as follows:
Property | Type | Description | Version |
---|---|---|---|
active_host_checks_enabled | boolean | Whether or not active host checks are globally enabled. | |
active_service_checks_enabled | boolean | Whether or not active service checks are globally enabled. | |
check_hosts_freshness | boolean | Whether or not host freshness checking is globally enabled. | |
check_services_freshness | boolean | Whether or not service freshness checking is globally enabled. | |
event_handler_enabled | boolean | Whether or not event handlers are globally enabled. | |
flap_detection_enabled | boolean | Whether or not flap detection is globally enabled. | |
id | unsigned integer | Instance ID. | |
last_alive | time | Last time the instance was known alive. | |
last_command_check | time | Last time a check command was executed. | |
notifications_enabled | boolean | Whether or not notifications are globally enabled. | |
obsess_over_hosts | boolean | Whether or not the monitoring engine should obsess over hosts. | |
obsess_over_services | boolean | Whether or not the monitoring engine should obsess over services. | |
passive_host_checks_enabled | boolean | Whether or not passive host checks are globally enabled. | |
passive_service_checks_enabled | boolean | Whether or not passive service checks are globally enabled. | |
global_host_event_handler | string | Global host event handler. | |
global_service_event_handler | string | Global service event handler. |
NEB::PbInstanceStatusβ
Category | element | ID |
---|---|---|
1 | 42 | 65578 |
This event is a Protobuf event, so items are not serialized as in BBDO v2 events, but using the Protobuf 3 serialization mechanism. When BBDO v3 is used, no more NEB::InstanceStatus events should be sent. Instead, you should see NEB::PbInstanceStatus events.
Here is the definition of this protobuf event:
message BBDOHeader {
uint32 conf_version = 1; // A internal number not currently used.
}
message InstanceStatus {
BBDOHeader header = 1;
bool event_handlers = 2; // Whether or not event handlers are globally enabled.
bool flap_detection = 3; // Whether or not flap detection is globally enabled.
bool notifications = 4; // Whether or not notifications are globally enabled.
bool active_host_checks = 5; // Whether or not active host checks are globally enabled.
bool active_service_checks = 6; // Whether or not active service checks are globally enabled.
bool check_hosts_freshness = 7; // Whether or not hosts freshness checking is globally enabled.
bool check_services_freshness = 8; // Whether or not services freshness checking is globally enabled.
string global_host_event_handler = 9; // Global host event handler.
string global_service_event_handler = 10; // Global service event handler.
uint64 last_alive = 11; // Last time the instance was known alive.
int64 last_command_check = 12; // Last time a check command was executed.
bool obsess_over_hosts = 13; // Whether or not the monitoring engine should obsess over hosts.
bool obsess_over_services = 14; // Whether or not the monitoring engine should obsess over services.
bool passive_host_checks = 15; // Whether or not passive host checks are globally enabled.
bool passive_service_checks = 16; // Whether or not passive service checks are globally enabled.
uint64 instance_id = 17; // Instance ID.
}
Log entryβ
Centreon Engine generates many logs. Some of them are sent to Centreon Broker to be stored in the database. These logs are sent using log entry events.
- BBDO v2
- BBDO v3
NEB::LogEntryβ
Category | element | ID |
---|---|---|
1 | 17 | 65553 |
The content of this message is serialized as follows:
Property | Type | Description |
---|---|---|
c_time | time | Log time. |
host_id | unsigned integer | Host ID. 0 if log entry does not refer to a specific host or service. |
host_name | string | Host name. Can be empty if log entry does not refer to a specific host or service. |
instance_name | string | Instance name. |
log_type | short integer | 0 for SOFT, 1 for HARD. |
msg_type | short integer | 0 for SERVICE ALERT (sent on service state change), 1 for HOST ALERT (sent on host state change(, 2 for SERVICE NOTIFICATION (notification sent out for a service), 3 for HOST NOTIFICATION (notification sent out for a host), 4 for Warning (Centreon Engine warning), 5 for EXTERNAL COMMAND (external command received), 6 for CURRENT SERVICE STATE (current state of monitored service, usually sent at configuration reload), 7 for CURRENT HOST STATE (current state of monitored host, usually sent at configuration reload), 8 for INITIAL SERVICE STATE (initial state of service, after retention processing, sent at process start), 9 for INITIAL HOST STATE (initial state of monitored host, after retention processing, sent at process start), 10 for ACKNOWLEDGE_SVC_PROBLEM external command (special case of EXTERNAL COMMAND for service acknowledgement), 11 for ACKNOWLEDGE_HOST_PROBLEM external command (special case of EXTERNAL COMMAND for host acknowledgement). |
notification_cmd | string | Notification command. |
notification_contact | string | Notification contact. |
retry | integer | Current check attempt. |
service_description | string | Service description. Empty if log entry does not refer to a specific service. |
service_id | unsigned integer | Service ID. 0 if log entry does not refer to a specific service. |
status | short integer | Host / service status. |
output | string | Output. |
NEB::PbLogEntryβ
Category | element | ID |
---|---|---|
1 | 41 | 65577 |
This event is a Protobuf event, so items are not serialized as in BBDO v2 events, but using the Protobuf 3 serialization mechanism. When BBDO v3 is used, no more NEB::LogEntry events should be sent. Instead, you should see NEB::PbLogEntry events.
Here is the definition of this protobuf event:
message LogEntry {
enum LogType {
SOFT = 0;
HARD = 1;
}
enum MsgType {
SERVICE_ALERT = 0;
HOST_ALERT = 1;
SERVICE_NOTIFICATION = 2;
HOST_NOTIFICATION = 3;
WARNING = 4;
OTHER = 5;
SERVICE_INITIAL_STATE = 8;
HOST_INITIAL_STATE = 9;
SERVICE_ACKNOWLEDGE_PROBLEM = 10;
HOST_ACKNOWLEDGE_PROBLEM = 11;
SERVICE_EVENT_HANDLER = 12;
HOST_EVENT_HANDLER = 13;
GLOBAL_SERVICE_EVENT_HANDLER = 14;
GLOBAL_HOST_EVENT_HANDLER = 15;
}
uint64 ctime = 1; // Log timestamp.
string instance_name = 2; // Instance name.
string output = 3; // Output.
uint64 host_id = 4; // Host ID.
uint64 service_id = 5; // Service ID or 0 if log entry does not refer to a specific service.
string host_name = 6; // Host name.
string service_description = 7; // Service description or empty if log entry does not refer to a specific service.
string notification_contact = 8; // Notification contact.
string notification_cmd = 9; // Notification command.
LogType type = 10; // One value of LogType.
MsgType msg_type = 11; // One value of MsgType.
int32 status = 12; // Host / service status.
int32 retry = 13; // Current check attempt.
}
Moduleβ
Module events are generated when Centreon Engine modules are loaded or unloaded. This message is not very useful, since the only modules available in Engine are external command and cbmod, which are mandatory.
That is why it will be removed in the near future.
- BBDO v2
- BBDO v3
NEB::Moduleβ
Category | element | ID |
---|---|---|
1 | 18 | 65554 |
The content of this message is serialized as follows:
Property | Type | Description | Version |
---|---|---|---|
args | string | Module arguments. | |
enabled | boolean | Whether or not this module is enabled. | |
filename | string | Path to the module file. | |
instance_id | unsigned integer | Instance ID. | |
loaded | boolean | Whether or not this module is loaded. | |
should_be_loaded | boolean | Whether or not this module should be (should have been) loaded. |
The event is the same as in BBDO v2. There is no Protobuf event.
Serviceβ
This is a configuration event. It is emitted by Centreon Engine when a change is made to the configuration of a service and the configuration is deployed.
- BBDO v2
- BBDO v3
NEB::Serviceβ
Category | element | ID |
---|---|---|
1 | 23 | 65559 |
The content of this message is serialized as follows:
Property | Type | Description |
---|---|---|
acknowledged | boolean | true if the problem has been acknowledged |
acknowledgement_type | short integer | 0 none, 1 normal, 2 sticky |
action_url | string | url to obtain information about service |
active_checks_enabled | boolean | active check |
check_freshness | boolean | passive freshness check activated |
check_interval | real | interval in units (usually 60s) between 2 checks |
check_period | string | time period when checks are authorized |
check_type | short integer | 0 active, 1 passive |
current_check_attempt | short integer | number of failed checks |
current_state | short integer | 0 up, 1 down, 2 unreachable |
default_active_checks_enabled | boolean | same as active_checks_enabled |
default_event_handler_enabled | boolean | same as event_handler_enabled |
default_flap_detection_enabled | boolean | same as flap_detection_enabled |
default_notifications_enabled | boolean | same as notifications_enabled |
default_passive_checks_enabled | boolean | same as passive_checks_enabled |
downtime_depth | short integer | number of active downtimes |
display_name | string | name displayed in UI |
enabled | boolean | enabled |
event_handler | string | command executed when state changes |
event_handler_enabled | boolean | event_handler enabled |
execution_time | real | duration of last check |
first_notification_delay | real | delay before notification in units (usually 60 s) |
flap_detection_enabled | boolean | flap detection enabled |
flap_detection_on_critical | boolean | critical state is taken into account for flap detection |
flap_detection_on_ok | boolean | ok state is taken into account for flap detection |
flap_detection_on_unknown | boolean | unknown state is taken into account for flap detection |
flap_detection_on_warning | boolean | warning state is taken into account for flap detection |
freshness_threshold | real | delay after check result is stale |
has_been_checked | boolean | check has been executed at least once |
high_flap_threshold | real | if percent state change is higher than this, service is considered flapping |
host_id | unsigned integer | id of the host |
host_name | string | name of the host |
icon_image | string | icon displayed in the UI for the service |
icon_image_alt | string | alternate string for icon_image |
service_id | unsigned integer | id of the service |
is_flapping | boolean | service is flapping |
is_volatile | boolean | service is volatile |
last_check | time | time of last check |
last_hard_state | short integer | last hard state |
last_hard_state_change | time | time of last hard state change |
last_notification | time | time of last notification sent |
last_state_change | time | time of last state change |
last_time_critical | time | time of the last check critical return code |
last_time_ok | time | time of the last check ok return code |
last_time_unknown | time | time of the last check unknown return code |
last_time_warning | time | time of the last check warning return code |
last_update | time | time of message create |
latency | real | delay between scheduled check time and real check time |
low_flap_threshold | real | if percent state change is lower than this, service is not considered flapping |
max_check_attempts | short integer | number of failed check after which service state become a hard fail state |
next_check | time | next scheduled check time |
next_notification | time | next renotification time |
no_more_notifications | boolean | no other notification will be sent |
notes | string | tooltip in resources status page |
notes_url | string | clickable url in resources status page |
notification_interval | real | interval between two notifications |
notification_number | short integer | number of notifications sent since the start of the problem |
notification_period | string | time period during which notifications are allowed |
notifications_enabled | boolean | notifications enabled |
notify_on_critical | boolean | users are notified if service state becomes critical |
notify_on_downtime | boolean | users are notified if service enters downtime |
notify_on_flapping | boolean | users are notified if service is flapping |
notify_on_recovery | boolean | users are notified if service becomes ok |
notify_on_unknown | boolean | users are notified if service state becomes unknown |
notify_on_warning | boolean | users are notified if service state becomes warning |
obsess_over | boolean | true if ocsp command if executed after check or notification command |
passive_checks_enabled | boolean | passive check |
percent_state_change | real | used by flapping and compared with high and low flap thresholds |
retry_interval | real | interval between two checks when service is not in up state and state type is soft |
scheduled_downtime_depth | short integer | number of active downtime periods |
service_description | string | name of the service |
should_be_scheduled | boolean | no next check should be scheduled |
stalk_on_critical | boolean | logs check output event change if state is critical |
stalk_on_ok | boolean | logs check output event change if state is ok |
stalk_on_unknown | boolean | logs check output event change if state is unknown |
stalk_on_warning | boolean | logs check output event change if state is warning |
state_type | short integer | state soft 0 or hard 1 |
check_command | string | command executed |
output | string | output of the command |
perf_data | string | perfdata extracted from the command's output |
retain_nonstatus_information | boolean | unused |
retain_status_information | boolean | unused |
NEB::PbServiceβ
Category | element | ID |
---|---|---|
1 | 27 | 65563 |
This event is a Protobuf event, so items are not serialized as in BBDO v2 events, but using the Protobuf 3 serialization mechanism. When BBDO v3 is used, no more NEB::Service events should be sent. Instead, you should see NEB::PbService events.
Here is the definition of this protobuf event:
enum ServiceType {
SERVICE = 0;
METASERVICE = 2;
BA = 3;
ANOMALY_DETECTION = 4;
}
enum AckType {
NONE = 0;
NORMAL = 1;
STICKY = 2;
}
message Service {
uint64 host_id = 1; // Host ID.
uint64 service_id = 2; // Service ID.
bool acknowledged = 3; // Is it currently acknowledged?
AckType acknowledgement_type = 4; // AckType value.
bool active_checks = 5; // Are active checks enabled?
bool enabled = 6; // Is this service active?
int32 scheduled_downtime_depth = 7; // Number of active downtimes.
string check_command = 8; // Command executed.
uint32 check_interval = 9; // Interval in units (usually 60s) between 2 checks.
string check_period = 10; // Time period when checks are authorized.
enum CheckType {
ACTIVE = 0;
PASSIVE = 1;
}
CheckType check_type = 11; // CheckType value.
int32 check_attempt = 12; // Number of failed checks.
enum State {
OK = 0;
WARNING = 1;
CRITICAL = 2;
UNKNOWN = 3;
PENDING = 4;
}
State state = 13; // Current state of this service.
bool event_handler_enabled = 14; // Event handler enabled?
string event_handler = 15; // Command executed when state changes.
double execution_time = 16; // Duration of last check.
bool flap_detection = 17; // Is flap detection enabled?
bool checked = 18; // Is this service checked?
bool flapping = 19; // Is this service flapping?
int64 last_check = 20; // Timestamp of the last check.
State last_hard_state = 21; // Last hard state.
int64 last_hard_state_change = 22; // Timestamp of the last hard state change.
int64 last_notification = 23; // Timestamp of the last notification.
int32 notification_number = 24; // Number of notifications sent since the start of the problem.
int64 last_state_change = 25; // Timestamp of the last state change.
int64 last_time_ok = 26; // Timestamp of the last check OK return code.
int64 last_time_warning = 27; // Timestamp of the last check WARNING return code.
int64 last_time_critical = 28; // Timestamp of the last check CRITICAL return code.
int64 last_time_unknown = 29; // Timestamp of the last check UNKNOWN return code.
int64 last_update = 30; // Timestamp of this event creation.
double latency = 31; // Delay between scheduled check time and real check time.
uint32 max_check_attempts = 32; // Number of failed checks after which service state becomes a hard fail state.
int64 next_check = 33; // Next scheduled check timestamp.
int64 next_notification = 34; // Next notification timestamp.
bool no_more_notifications = 35; // No other notification will be sent.
bool notify = 36; // Are notifications enabled on this service?
string output = 37; // Output of the check command.
string long_output = 38; // Long output of the check command.
bool passive_checks = 39; // Are passive checks enabled?
double percent_state_change = 40; // Used by flapping and compared with high and low flap thresholds.
string perfdata = 41; // Perfdata extracted from the command's output.
double retry_interval = 42; // Interval between two checks when service isn't in ok state and state type is SOFT.
string host_name = 43; // Host name of this service.
string description = 44; // Description of this service
bool should_be_scheduled = 45; // Is there a next check scheduled?
bool obsess_over_service = 46; // True if OCSP command is executed after check or notification command.
enum StateType {
SOFT = 0;
HARD = 1;
}
StateType state_type = 47; // StateType value.
string action_url = 48; // Url to obtain information about this service.
bool check_freshness = 49; // Passive freshness check activated?
bool default_active_checks = 50; // Default value of active_checks.
bool default_event_handler_enabled = 51; // Default value of event_handler_enabled.
bool default_flap_detection = 52; // Default value of flap detection.
bool default_notify = 53; // Default value of notify.
bool default_passive_checks = 54; // Default value of passive checks.
string display_name = 55; // Name displayed in WUI.
double first_notification_delay = 56; // Delay before notify in units (usually 60s).
bool flap_detection_on_critical = 57; // Critical state is taken into account for flap detection.
bool flap_detection_on_ok = 58; // Ok state is taken into account for flap detection.
bool flap_detection_on_unknown = 59; // Unknown state is taken into account for flap detection.
bool flap_detection_on_warning = 60; // Warning state is taken into account for flap detection.
double freshness_threshold = 61; // Delay after check result is stale.
double high_flap_threshold = 62; // If percent state change is higher than this, service is considered flapping.
string icon_image = 63; // Icon displayed in the WUI for the service.
string icon_image_alt = 64; // Alternate string for icon_image.
bool is_volatile = 65; // Is the service volatile?
double low_flap_threshold = 66; // If percent state change is lower than this, service is not considered flapping.
string notes = 67; // Tooltip in resources status page.
string notes_url = 68; // Clickable url in resources status page.
double notification_interval = 69; // Interval between two notifications.
string notification_period = 70; // Time period during which notifications are allowed.
bool notify_on_critical = 71; // Users are notified if service state becomes critical.
bool notify_on_downtime = 72; // Users are notified if service enters in downtime.
bool notify_on_flapping = 73; // Users are notified if service is flapping.
bool notify_on_recovery = 74; // Users are notified if service becomes OK.
bool notify_on_unknown = 75; // Users are notified if service state becomes unknown.
bool notify_on_warning = 76; // Users are notified if service state becomes warning.
bool stalk_on_critical = 77; // Users are notified if service state becomes critical.
bool stalk_on_ok = 78; // Logs check output event change if state is OK.
bool stalk_on_unknown = 79; // Logs check output event change if state is unknown.
bool stalk_on_warning = 80; // Logs check output event change if state is warning.
bool retain_nonstatus_information = 81; // unused.
bool retain_status_information = 82; // unused.
uint64 severity_id = 83; // Severity ID or 0.
repeated TagInfo tags = 84; // Tag IDs.
ServiceType type = 85; // What kind of service is it?
/* In case of metaservice and ba, they also have an internal id. We keep it
* here. */
uint64 internal_id = 86; // ID of metaservice or ba.
uint64 icon_id = 87; // Icon ID.
}
Service checkβ
This event is emitted by Centreon Engine when a check is performed on a service.
- BBDO v2
- BBDO v3
NEB::ServiceCheckβ
Category | element | ID |
---|---|---|
1 | 19 | 65555 |
The content of this message is serialized as follows:
Property | Type | Description | Version |
---|---|---|---|
active_checks_enabled | boolean | True if active checks are enabled on the service. | |
check_type | short | ||
host_id | unsigned integer | Host ID. | |
next_check | time | Time at which the next check is scheduled. | |
service_id | unsigned integer | Service ID. | |
command_line | string | Check command line. |
NEB::PbServiceCheckβ
Category | element | ID |
---|---|---|
1 | 40 | 65576 |
This event is a Protobuf event, so items are not serialized as in BBDO v2 events, but using the Protobuf 3 serialization mechanism. When BBDO v3 is used, no more NEB::ServiceCheck events should be sent. Instead, you should see NEB::PbServiceCheck events.
Here is the definition of this protobuf event:
message BBDOHeader {
uint32 conf_version = 1; // A internal number not currently used.
}
enum CheckType {
CheckActive = 0;
CheckPassive = 1;
}
message Check {
BBDOHeader header = 1;
bool active_checks_enabled = 2; // True if active checks are enabled on the host.
CheckType check_type = 3; // One of the values in CheckType.
string command_line = 4; // Check command line.
uint64 host_id = 5; // Host ID.
uint64 next_check = 6; // Timestamp at which the next check is scheduled.
uint64 service_id = 7; // Service ID or 0 for a host check.
}
Service dependencyβ
This is a configuration event sent when a dependency between services is defined.
- BBDO v2
- BBDO v3
NEB::ServiceDependencyβ
Category | element | ID |
---|---|---|
1 | 20 | 65556 |
The content of this message is serialized as follows:
Property | Type | Description | Version |
---|---|---|---|
dependency_period | string | ||
dependent_host_id | unsigned integer | ||
dependent_service_id | unsigned integer | ||
enabled | boolean | ||
execution_failure_options | string | ||
host_id | unsigned integer | ||
inherits_parent | boolean | ||
notification_failure_options | string | ||
service_id | unsigned integer |
The event is the same as in BBDO v2. There is no Protobuf event.
Service groupβ
This is a configuration event that is emitted when a service group is created.
- BBDO v2
- BBDO v3
NEB::ServiceGroupβ
Category | element | ID |
---|---|---|
1 | 21 | 65557 |
The content of this message is serialized as follows:
Property | Type | Description | Version |
---|---|---|---|
id | unsigned integer | ||
name | string | Group name. | |
enabled | enabled | True if the group is enable, false if it is not (deletion). | |
poller_id | unsigned integer |
The event is the same as in BBDO v2. There is no Protobuf event.
Service group memberβ
This is a configuration event. It is sent just after a servicegroup event to detail members of the group to configure. Even in BBDO v3, we still use the BBDO v2 version of this event.
- BBDO v2
- BBDO v3
NEB::ServiceGroupMemberβ
Category | element | ID |
---|---|---|
1 | 22 | 65558 |
The content of this message is serialized as follows:
Property | Type | Description |
---|---|---|
id | unsigned integer | |
host_id | unsigned integer | |
service_id | unsigned integer | |
enabled | enabled | True if the group is enabled, false if it is not (deletion). |
group_name | string | Group name. |
poller_id | unsigned integer |
The event is the same as in BBDO v2. There is no Protobuf event.
Service statusβ
This is an event emitted by Centreon Engine when a service has real time modifications.
- BBDO v2
- BBDO v3
NEB::ServiceStatusβ
Category | element | ID |
---|---|---|
1 | 24 | 65560 |
The content of this message is serialized as follows:
Property | Type | Description |
---|---|---|
acknowledged | boolean | true if the problem has been acknowledged |
acknowledgement_type | short integer | 0 none, 1 normal, 2 sticky |
active_checks_enabled | boolean | active check |
check_interval | real | interval in units (usually 60 s) between 2 checks |
check_period | string | time period when checks are authorized |
check_type | short integer | 0 active, 1 passive |
current_check_attempt | short integer | number of failed checks |
current_state | short integer | 0 up, 1 down, 2 unreachable |
downtime_depth | short integer | number of active downtimes |
enabled | boolean | enabled |
event_handler | string | command executed when state changes |
event_handler_enabled | boolean | event_handler enabled |
execution_time | real | duration of last check |
flap_detection_enabled | boolean | flap detection enabled |
has_been_checked | boolean | check has been executed at least once |
host_id | unsigned integer | id of the host |
host_name | string | name of the host |
is_flapping | boolean | service is flapping |
last_check | time | time of last check |
last_hard_state | short integer | last hard state |
last_hard_state_change | time | time of last hard state change |
last_notification | time | time of last notification sent |
last_state_change | time | time of last state change |
last_time_critical | time | time of the last check critical return code |
last_time_ok | time | time of the last check ok return code |
last_time_unknown | time | time of the last check unknown return code |
last_time_warning | time | time of the last check warning return code |
last_update | time | time of message create |
latency | real | delay between scheduled check time and real check time |
max_check_attempts | short integer | number of failed checks after which service state become a hard fail state |
next_check | time | next scheduled check time |
next_notification | time | next renotification time |
no_more_notifications | boolean | no other notification will be sent |
notification_number | short integer | number of notifications sent since the start of the problem |
notifications_enabled | boolean | notifications enabled |
obsess_over | boolean | true if ocsp command is executed after check or notification command |
passive_checks_enabled | boolean | passive check |
percent_state_change | real | used by flapping and compared with high and low flap thresholds |
retry_interval | real | interval between two checks when service is not in up state and state type is soft |
service_description | string | name of the service |
service_id | unsigned integer | id of the service |
should_be_scheduled | boolean | no next check should be scheduled |
state_type | short integer | state soft 0 or hard 1 |
check_command | string | command executed |
output | string | output of the command |
perf_data | string | perfdata extracted from the command's output |
NEB::PbServiceStatusβ
Category | element | ID |
---|---|---|
1 | 29 | 65565 |
This event is a Protobuf event, so items are not serialized as in BBDO v2 events, but using the Protobuf 3 serialization mechanism. When BBDO v3 is used, no more NEB::ServiceStatus events should be sent. Instead , you should see NEB::PbServiceStatus.
Here is the definition of this protobuf event:
message ServiceStatus {
uint64 host_id = 1; // Host ID.
uint64 service_id = 2; // Service ID.
bool checked = 3; // Is this service checked?
enum CheckType {
ACTIVE = 0;
PASSIVE = 1;
}
CheckType check_type = 4; // CheckType value.
enum State {
OK = 0;
WARNING = 1;
CRITICAL = 2;
UNKNOWN = 3;
PENDING = 4;
}
State state = 5; // Current state of this service.
enum StateType {
SOFT = 0;
HARD = 1;
}
StateType state_type = 6; // StateType value.
int64 last_state_change = 7; // Timestamp of the last state change.
State last_hard_state = 8; // Last hard state.
int64 last_hard_state_change = 9; // Timestamp of the last hard state change.
int64 last_time_ok = 10; // Timestamp of the last check OK return code.
int64 last_time_warning = 11; // Timestamp of the last check WARNING return code.
int64 last_time_critical = 12; // Timestamp of the last check CRITICAL return code.
int64 last_time_unknown = 13; // Timestamp of the last check UNKNOWN return code.
string output = 14; // Output of the check command.
string long_output = 15; // Long output of the check command.
string perfdata = 16; // Perfdata extracted from the command's output.
bool flapping = 17; // Is this service flapping?
double percent_state_change = 18; // Used by flapping and compared with high and low flap thresholds.
double latency = 19; // Delay between scheduled check time and real check time.
double execution_time = 20; // Duration of last check.
int64 last_check = 21; // Timestamp of the last check.
int64 next_check = 22; // Next scheduled check timestamp.
bool should_be_scheduled = 23; // Is there a next check scheduled?
int32 check_attempt = 24; // Number of failed checks after which service state becomes a hard fail state.
int32 notification_number = 25; // Number of notifications sent since the start of the problem.
bool no_more_notifications = 26; // No other notification will be sent.
int64 last_notification = 27; // Timestamp of the last notification.
int64 next_notification = 28; // Next notification timestamp.
AckType acknowledgement_type = 29; // AckType value.
int32 scheduled_downtime_depth = 30; // Number of active downtimes.
ServiceType type = 31; // What kind of service is it?
/* In case of metaservice and ba, they also have an internal id. We keep it
* here. */
uint64 internal_id = 32; // ID of metaservice or ba.
}
Instance configurationβ
Here is a configuration event announcing all the configuration events that are going to be sent by a poller.
- BBDO v2
- BBDO v3
NEB::InstanceConfigurationβ
Category | element | ID |
---|---|---|
1 | 25 | 65561 |
The content of this message is serialized as follows:
Property | Type | Description | Version |
---|---|---|---|
loaded | boolean | True if the instance loaded successfully. | |
poller_id | unsigned integer | ID of the poller that received a configuration update request (reload). |
The event is the same as in BBDO v2. There is no Protobuf event.
Responsive instanceβ
This event is emitted by cbd. It tells if a poller is responsive or not.
- BBDO v2
- BBDO v3
NEB::ResponsiveInstanceβ
Category | element | ID |
---|---|---|
1 | 26 | 65562 |
The content of this message is serialized as follows:
Property | Type | Description | Version |
---|---|---|---|
poller_id | unsigned integer | ID of the poller which received a configuration update request (reload). | |
responsive | boolean | A boolean telling if the poller with ID poller_id is responsive or not. |
NEB::PbResponsiveInstanceβ
Category | element | ID |
---|---|---|
1 | 46 | 65582 |
This event is a Protobuf event, so items are not serialized as in BBDO v2 events, but using the Protobuf 3 serialization mechanism. When BBDO v3 is used, no more NEB::ResponsiveInstance events should be sent. Instead, you should see NEB::PbResponsiveInstance events.
Here is the definition of this protobuf event:
message BBDOHeader {
uint32 conf_version = 1; // An internal number, not currently used.
}
message ResponsiveInstance {
BBDOHeader header = 1;
uint64 poller_id = 2; // Poller ID.
bool responsive = 3; // Is this poller responsive?
}
Adaptive serviceβ
This event was introduced with BBDO v3. It is emitted when a service has its configuration updated on the fly (for example with an external command)
- BBDO v2
- BBDO v3
No Adaptive service available in BBDO v2.
NEB::PbAdaptiveServiceβ
Category | element | ID |
---|---|---|
1 | 41 | 65577 |
This event is a Protobuf event, so items are not serialized as in BBDO v2 events, but using the Protobuf 3 serialization mechanism. When BBDO v3 is used, no more NEB::AdaptiveService events should be sent. Instead, you should see NEB::PbAdaptiveService events.
The protobuf message is the following:
message AdaptiveService {
uint64 host_id = 1; // Host ID.
uint64 service_id = 2; // Service ID.
optional bool notify = 3; // Are notifications enabled on this service?
optional bool active_checks = 4; // Are active checks enabled?
optional bool should_be_scheduled = 5; // Is there a next check scheduled?
optional bool passive_checks = 6; // Are passive checks enabled?
optional bool event_handler_enabled = 7; // Event handler enabled?
optional bool flap_detection_enabled = 8; // Is flap detection enabled?
optional bool obsess_over_service = 9; // True if OCSP command is executed after check or notification command.
optional string event_handler = 10; // Command executed when state changes.
optional string check_command = 11; // Command executed.
optional uint32 check_interval = 12; // Interval in units (usually 60s) between 2 checks.
optional uint32 retry_interval = 13; // Interval between two checks when service isn't in ok state and state type is SOFT.
optional uint32 max_check_attempts = 14; // Number of failed checks after which service state becomes a hard fail state.
optional bool check_freshness = 15; // Passive freshness check activated?
optional string check_period = 16; // Time period when checks are authorized.
optional string notification_period = 17; // Time period when notifications are authorized.
}
Adaptive hostβ
This event was introduced with BBDO v3. It is emitted when a host has its configuration updated on the fly (for example with an external command).
- BBDO v2
- BBDO v3
No Adaptive host available in BBDO v2.
NEB::PbAdaptiveHostβ
Category | element | ID |
---|---|---|
1 | 31 | 65567 |
This event is a Protobuf event, so items are not serialized as in BBDO v2 events, but using the Protobuf 3 serialization mechanism. When BBDO v3 is used, no more NEB::AdaptiveHost events should be sent. Instead, you should see NEB::PbAdaptiveHost events.
The protobuf message is the following:
message AdaptiveHost {
uint64 host_id = 1; // Host ID.
optional bool notify = 2; // Are notifications enabled on this service?
optional bool active_checks = 3; // Are active checks enabled?
optional bool should_be_scheduled = 4; // Is there a next check scheduled?
optional bool passive_checks = 5; // Are passive checks enabled?
optional bool event_handler_enabled = 6; // Event handler enabled?
optional bool flap_detection = 7; // Is flap detection enabled?
optional bool obsess_over_host = 8; // True if OCSP command is executed after check or notification command.
optional string event_handler = 9; // Command executed when state changes.
optional string check_command = 10; // Command executed.
optional uint32 check_interval = 11; // Interval in units (usually 60s) between 2 checks.
optional uint32 retry_interval = 12; // Interval between two checks when service isn't in ok state and state type is SOFT.
optional uint32 max_check_attempts = 13; // Number of failed checks after which service state becomes a hard fail state.
optional bool check_freshness = 14; // Passive freshness check activated?
optional string check_period = 15; // Time period when checks are authorized.
optional string notification_period = 16; // Time period when notifications are authorized.
}
Severityβ
This is a configuration event. It defines a severity. This event was introduced with BBDO v3.
- BBDO v2
- BBDO v3
No BBDO v2 version of this event exists.
NEB::PbSeverityβ
Category | element | ID |
---|---|---|
1 | 33 | 65569 |
This event comes with BBDO 3. It contains the severity of a resource.
Here is the definition of this protobuf event:
message Severity {
uint64 id = 1;
enum Action {
ADD = 0;
DELETE = 1;
MODIFY = 2;
}
Action action = 2;
uint32 level = 3;
uint64 icon_id = 4;
string name = 5;
enum Type {
SERVICE = 0;
HOST = 1;
}
Type type = 6;
uint64 poller_id = 7;
}
Storageβ
Metricβ
This event is generated by a Storage endpoint to notify that an RRD metric graph should be updated.
- BBDO v2
- BBDO v3
Storage::Metricβ
Category | element | ID |
---|---|---|
3 | 1 | 196609 |
The content of this message is serialized as follows:
Property | Type | Description | Version |
---|---|---|---|
ctime | time | Time at which the metric value was generated. | |
interval | unsigned integer | Normal service check interval in seconds. | |
metric_id | unsigned integer | Metric ID (from the metrics table). | |
name | string | Metric name. | |
rrd_len | integer | RRD retention length in seconds. | |
value | real | Metric value. | |
value_type | short integer | Metric type (1 =3D counter, 2 =3D derive, 3 =3D absolute, other =3D gauge). | |
is_for_rebuild | boolean | Set to true when a graph is being rebuilt (see the rebuild event). | |
host_id | unsigned integer | The id of the host this metric is attached to. | |
service_id | unsigned integer | The id of the service this metric is attached to. |
Storage::PbMetricβ
Category | element | ID |
---|---|---|
3 | 9 | 196617 |
This event is a Protobuf event so items are not serialized as in BBDO v2 events, but using the Protobuf 3 serialization mechanism. When BBDO v3 is used, no more Storage::Metric events should be sent. Instead, you should see Storage::PbMetric events.
Here is the definition of this protobuf event:
message Metric {
enum ValueType {
GAUGE = 0;
COUNTER = 1;
DERIVE = 2;
ABSOLUTE = 3;
AUTOMATIC = 4;
}
uint64 metric_id = 4; // Metric ID.
int32 rrd_len = 5; // RRD retention length in seconds.
int32 interval = 6; // Normal service check interval in seconds.
ValueType value_type = 7; // A value from ValueType.
uint64 time = 8; // Timestamp at which the metric value was generated.
double value = 9; // Metric value.
string name = 10; // Metric name.
uint64 host_id = 11; // Host ID.
uint64 service_id = 12; // Service ID.
}
Rebuildβ
Rebuild events are generated when a Storage endpoint detects that some
graphs should be rebuilt. It first sends a rebuild start event (end false
),
then metric values (metric event with is_for_rebuild set to
true) and finally a rebuild end event (end true
).
This message and its principle are only available in BBDO v2. With BBDO v3, we take advantage of the power of Protobuf. To rebuild graphs, we use the event Storage::PbRebuildMessage.
- BBDO v2
- BBDO v3
Storage::Rebuildβ
Category | element | ID |
---|---|---|
3 | 2 | 196610 |
The content of this message is serialized as follows:
Property | Type | Description | Version |
---|---|---|---|
end | boolean | End flag. Set to true if rebuild is starting, false if it is ending. | |
id | unsigned integer | ID of metric to rebuild if is_index is false, or ID of index to rebuild (status graph) if is_index is true. | |
is_index | boolean | Index flag. Rebuild index (status) if true, rebuild metric if false. |
Not available with Protobuf 3.
Take a look at Storage::PbRebuildMessage for a replacement.
Remove graphβ
A Storage endpoint generates a remove graph event when some graphs must be deleted.
This message and its principle are only available in BBDO v2. With BBDO v3, we take advantage of the power of Protobuf. To remove graphs, we use the event Storage::PbRemoveGraphMessage.
- BBDO v2
- BBDO v3
Storage::RemoveGraphβ
Category | element | ID |
---|---|---|
3 | 3 | 196611 |
The content of this message is serialized as follows:
Property | Type | Description |
---|---|---|
id | unsigned integer | Index ID (is_index =true ) or metric ID (is_index =false ) to remove. |
is_index | boolean | Index flag. If true, a index (status) graph will be deleted. If false, a metric graph will be deleted. |
Not available with Protobuf 3.
Take a look at Storage::PbRemoveGraphMessage for a replacement.
Statusβ
This event is emitted by cbd when a Service Status or a Host Status event is received. It essentially contains a resource with its status.
- BBDO v2
- BBDO v3
Storage::Statusβ
Category | element | ID |
---|---|---|
3 | 4 | 196612 |
The content of this message is serialized as follows:
Property | Type | Description |
---|---|---|
ctime | time | Time at which the status was generated. |
index_id | unsigned integer | Index ID. |
interval | unsigned integer | Normal service check interval in seconds. |
rrd_len | time | RRD retention in seconds. |
state | short integer | Service state. |
is_for_rebuild | boolean | Set to true when a graph is being rebuilt (see the rebuild event). |
Storage::PbStatusβ
Category | element | ID |
---|---|---|
3 | 10 | 196618 |
This event is a Protobuf event, so items are not serialized as in BBDO v2 events, but using the Protobuf 3 serialization mechanism. When BBDO v3 is used, no more Storage::Status events should be sent. Instead, you should see Storage::PbStatus events.
Here is the definition of this protobuf event:
message Status {
uint64 index_id = 1; // Index ID.
uint32 interval = 2; // Normal service check interval in seconds.
uint32 rrd_len = 3; // RRD retention in seconds.
uint64 time = 4; // Timestamp at which the status was generated.
uint32 state = 5; // Service state.
}
Metric mappingβ
This event is emitted by Centreon Broker when a new service configuration is received. It associates an index ID (the one created for a service - see Index mapping) to a metric ID.
- BBDO v2
- BBDO v3
Storage::MetricMappingβ
Category | element | ID |
---|---|---|
3 | 6 | 196614 |
The content of this message is serialized as follows:
Property | Type | Description |
---|---|---|
index_id | unsigned integer | Index ID. |
metric_id | unsigned integer | Index ID. |
Storage::PbMetricMappingβ
Category | element | ID |
---|---|---|
3 | 12 | 196620 |
This event is a Protobuf event so items are not serialized as in BBDO v2 events, but using the Protobuf 3 serialization mechanism. When BBDO v3 is used, no more Storage::MetricMapping events should be sent. Instead, you should see Storage::PbIndexMapping events.
Here is the definition of this protobuf event:
message MetricMapping {
uint64 index_id = 1; // Index ID of the service.
uint64 metric_id = 2; // Metric ID linked to the service.
}
Index mappingβ
This event is emitted by Centreon Broker when a new service configuration is received. It associates an ID to the pair (host ID/service ID). This new ID is useful for the service metrics declaration.
- BBDO v2
- BBDO v3
Storage::IndexMappingβ
Category | element | ID |
---|---|---|
3 | 5 | 196613 |
The content of this message is serialized as follows:
Property | Type | Description |
---|---|---|
index_id | unsigned integer | Index ID. |
host_id | unsigned integer | Host ID. |
service_id | unsigned integer | Service ID. |
Storage::PbIndexMappingβ
Category | element | ID |
---|---|---|
3 | 11 | 196619 |
This event is a Protobuf event so items are not serialized as in BBDO v2 events, but using the Protobuf 3 serialization mechanism. When BBDO v3 is used, no more Storage::IndexMapping events should be sent. Instead, you should see Storage::PbIndexMapping events.
Here is the definition of this protobuf event:
message IndexMapping {
uint64 index_id = 1; // Index ID for a service.
uint64 host_id = 2; // Host ID of the service.
uint64 service_id = 3; // Service ID of the service.
}
Rebuild Messageβ
This event comes with BBDO 3, when some graphs have to be rebuilt. Messages handling these rebuilds are of that type. They replace the old BBDO v2 rebuild message.
- BBDO v2
- BBDO v3
Not available with BBDO v2.
See Storage::Rebuild
Storage::PbRebuildMessageβ
Category | element | ID |
---|---|---|
3 | 7 | 196615 |
There are three states for this message:
- START: here is the first state. This message initializes which metrics have to be rebuilt.
- DATA: once the START state has been sent, one or more messages with DATA state may be sent to the RRD broker.
- END: When all the rebuild events have been sent, this one is sent to close the rebuilds. And the RRD broker falls back into a nominal state.
The protobuf message is the following:
message Point {
int64 ctime = 1;
double value = 2;
}
message Timeserie {
repeated Point pts = 1;
int32 data_source_type = 2;
uint32 check_interval = 3;
uint32 rrd_retention = 4;
}
message RebuildMessage {
enum State {
START = 0;
DATA = 1;
END = 2;
}
State state = 1;
/* Only used on DATA state */
map<uint64, Timeserie> timeserie = 2;
/* Only used on START/END state */
repeated uint64 metric_id = 3;
}
Remove Graph Messageβ
This event comes with BBDO 3. When we want to remove graph files, we can use the centengine gRPC API and this call makes cbd generate a Storage::PbRemoveGraphMessage event. There are two possibilities concerning this event. We can remove graphs matching some index data or graphs matching some metric data. It is also possible to mix the two kinds.
- BBDO v2
- BBDO v3
Not available with BBDO v2.
BBDOβ
Version responseβ
This is the negotiation message used until BBDO v3.0.0. Each time a BBDO connection is established, this message is sent by the connector and by the acceptor to negotiate options.
- BBDO v2
- BBDO v3
BBDO::VersionResponseβ
Category | element | ID |
---|---|---|
2 | 1 | 131073 |
The content of this message is serialized as follows:
Property | Type | Description |
---|---|---|
bbdo_major | short integer | BBDO protocol major used by the peer sending this version_response packet. The sole current protocol version is 1.0.0. |
bbdo_minor | short integer | BBDO protocol minor used by the peer sending this version_response packet. |
bbdo_patch | short integer | BBDO protocol patch used by the peer sending this version_response packet. |
extensions | string | Space-separated string of extensions supported by the peer sending this version_response packet. |
The event is the same as in BBDO v2. There is no Protobuf event.
Ackβ
Usually, a BBDO sender sends events and a BBDO receiver consumes events. But the sender keeps events until the receiver tells it they have been handled. To do that, the receiver emits an Ack message with the number of events already handled.
- BBDO v2
- BBDO v3
BBDO::Ackβ
Category | element | ID |
---|---|---|
2 | 2 | 131074 |
The content of this message is serialized as follows:
Property | Type | Description | Version |
---|---|---|---|
acknowledged events | unsigned integer | Number of acknowledged events. Only used by "smart" clients (i.e able to acknowledge events). Not to be used by dumb clients. |
NEB::PbAckβ
Category | element | ID |
---|---|---|
2 | 8 | 131080 |
This event is a Protobuf event, so items are not serialized as in BBDO v2 events, but using the Protobuf 3 serialization mechanism. When BBDO v3 is used, no more NEB::Ack events should be sent. Instead, you should see NEB::PbAck events.
The protobuf message is the following:
message Ack {
uint32 acknowledged_events = 1; // The number of events to acknowledge.
}
Stopβ
When one side of a BBDO connection is going to exit, it emits a Stop event so that if the other side has events already handled it can send an Ack event.
- BBDO v2
- BBDO v3
BBDO::PbStopβ
Category | element | ID |
---|---|---|
2 | 9 | 131081 |
This event is a Protobuf event, so items are not serialized as in BBDO v2 events, but using the Protobuf 3 serialization mechanism. When BBDO v3 is used, no more BBDO::Stop events should be sent. Instead, you should see BBDO::PbStop events.
The protobuf message is the following:
message Stop {}
BAMβ
BA status eventβ
This event is sent when a BA's status changes.
- BBDO v2
- BBDO v3
BAM::BaStatusβ
Category | element | ID |
---|---|---|
6 | 1 | 393217 |
The content of this message is serialized as follows:
Property | Type | Description |
---|---|---|
ba_id | unsigned integer | The id of the BA. |
in_downtime | boolean | True if the BA is in downtime. |
last_state_change | time | The time of the last state change of the BA. |
level_acknowledgement | real | The acknowledgment level of the BA. |
level_downtime | real | The downtime level of the BA. |
level_nominal | real | The nominal level of the BA. |
state | short integer | The state of the BA. |
state_changed | boolean | True if the state of the BA just changed. |
BAM::PbBaStatusβ
Category | element | ID |
---|---|---|
6 | 19 | 393235 |
This event is a Protobuf event, so items are not serialized as in BBDO v2 events, but using the Protobuf 3 serialization mechanism. When BBDO v3 is used, no more BAM::BaStatus events should be sent. Instead, you should see BAM::PbBaStatus events.
The protobuf message is the following:
enum State {
OK = 0;
WARNING = 1;
CRITICAL = 2;
UNKNOWN = 3;
}
message BaStatus {
uint32 ba_id = 2; // The ID of the BA.
bool in_downtime = 3; // True if the BA is in downtime.
uint64 last_state_change = 4; // Timestamp of the last state change of the BA.
double level_acknowledgement = 5; // The acknowledgement level of the BA.
double level_downtime = 6; // The downtime level of the BA.
double level_nominal = 7; // The nominal level of the BA.
State state = 8; // The state of the BA.
bool state_changed = 9; // True if the state of the BA just changed.
}
KPI status eventβ
This event is sent when a KPI's status changes.
- BBDO v2
- BBDO v3
BAM::KpiStatusβ
Category | element | ID |
---|---|---|
6 | 2 | 393218 |
The content of this message is serialized as follows:
Property | Type | Description |
---|---|---|
kpi_id | unsigned integer | The id of the KPI. |
in_downtime | bool | True if the KPI is in downtime. |
level_acknowledgement_hard | real | The hard acknowledgement level of the KPI. |
level_acknowledgement_soft | real | The soft acknowledgement level of the KPI. |
level_downtime_hard | real | The hard downtime level of the KPI. |
level_downtime_soft | real | The soft downtime level of the KPI. |
level_nominal_hard | real | The hard nominal level of the KPI. |
level_nominal_soft | real | The soft nominal level of the KPI. |
state_hard | short integer | The hard state of the KPI. |
state_soft | short integer | The soft state of the KPI. |
last_state_change | time | The time of the last state change of the KPI. |
last_impact | real | The last impact of the KPI. |
valid | bool | True if the KPI is valid. |
BAM::PbKpiStatusβ
Category | element | ID |
---|---|---|
6 | 27 | 393243 |
This event is a Protobuf event, so items are not serialized as in BBDO v2 events, but using the Protobuf 3 serialization mechanism. When BBDO v3 is used, no more BAM::KpiStatus events should be sent. Instead, you should see BAM::PbKpiStatus events.
The protobuf message is the following:
enum State {
OK = 0;
WARNING = 1;
CRITICAL = 2;
UNKNOWN = 3;
}
message KpiStatus {
uint32 kpi_id = 1; // ID of the KPI.
bool in_downtime = 2; // True if the KPI is in downtime.
double level_acknowledgement_hard = 3; // The hard acknowledgement level of the KPI.
double level_acknowledgement_soft = 4; // The soft acknowledgement level of the KPI.
double level_downtime_hard = 5; // The hard downtime level of the KPI.
double level_downtime_soft = 6; // The soft downtime level of the KPI.
double level_nominal_hard = 7; // The hard nominal level of the KPI.
double level_nominal_soft = 8; // The soft nominal level of the KPI.
State state_hard = 9; // Hard state of the KPI.
State state_soft = 10; // Soft state of the KPI.
int64 last_state_change = 11; // Timestamp of the last state change of the KPI.
double last_impact = 12; // Last impact of the KPI.
bool valid = 13; // True if the KPI is valid.
}
Meta service status eventβ
This event was designed to send meta service's status changes.
At the moment meta services are not managed by Centreon Broker, so this event is not used.
- BBDO v2
- BBDO v3
BAM::MetaServiceStatusβ
Category | element | ID |
---|---|---|
6 | 3 | 393219 |
The content of this message is serialized as follows:
Property | Type | Description |
---|---|---|
meta_service_id | unsigned integer | The id of the meta service. |
value | real | The value of the meta service. |
state_changed | boolean | True if the state just changed. |
There is no Protobuf event.
BA-event eventβ
This event is sent when a new BA event is opened, or an old one is closed.
- BBDO v2
- BBDO v3
BAM::BaEventβ
Category | element | ID |
---|---|---|
6 | 4 | 393220 |
The content of this message is serialized as follows:
Property | Type | Description |
---|---|---|
ba_id | unsigned integer | The id of the BA. |
first_level | real | The first level of the BA event. |
end_time | time | The end_time of the event. 0 or (time)-1 for an opened event. |
in_downtime | boolean | True if BA was in downtime during the BA event. |
start_time | time | The start_time of the event. |
status | short integer | The status of the BA during the event. |
BAM::PbBaEventβ
Category | element | ID |
---|---|---|
6 | 20 | 393236 |
This event is a Protobuf event, so items are not serialized as in BBDO v2 events, but using the Protobuf 3 serialization mechanism. When BBDO v3 is used, no more BAM::BaEvent events should be sent. Instead, you should see BAM::PbBaEvent events.
The protobuf message is the following:
enum State {
OK = 0;
WARNING = 1;
CRITICAL = 2;
UNKNOWN = 3;
}
message BaEvent {
uint32 ba_id = 1; // The ID of the BA.
double first_level = 2; // The first level of the BA event.
int64 end_time = 3; // The end\_time of the event. 0 or (time)-1 for an opened event.
bool in_downtime = 4; // True if BA was in downtime during the BA event.
uint64 start_time = 5; // The start\_time of the event.
State status = 6; // The status of the BA during the event.
}
KPI Eventβ
This event is sent when a new KPI event is opened, or an old one is closed.
- BBDO v2
- BBDO v3
BAM::KpiEventβ
Category | element | ID |
---|---|---|
6 | 5 | 393221 |
The content of this message is serialized as follows:
Property | Type | Description |
---|---|---|
kpi_id | unsigned integer | The id of the KPI. |
end_time | time | The end_time of the event. 0 or (time)-1 for an opened event. |
impact_level | integer | The level of the impact. |
in_downtime | boolean | True if BA was in downtime during the BA event. |
first_output | string | The first output of the KPI during the event. |
perfdata | string | The first perfdata of the KPI during the event. |
start_time | time | The start_time of the event. |
status | short integer | The status of the BA during the event. |
BAM::PbKpiEventβ
Category | element | ID |
---|---|---|
6 | 21 | 393237 |
This event is a Protobuf event, so items are not serialized as in BBDO v2 events, but using the Protobuf 3 serialization mechanism. When BBDO v3 is used, no more BAM::KpiEvent events should be sent. Instead, you should see BAM::PbKpiEvent events.
The protobuf message is the following:
enum State {
OK = 0;
WARNING = 1;
CRITICAL = 2;
UNKNOWN = 3;
}
message KpiEvent {
uint32 ba_id = 1; // The id of the BA.
uint64 start_time = 2; // The start\_time of the event.
int64 end_time = 3; // The end\_time of the event. 0 or (time)-1 for an opened event.
uint32 kpi_id = 4; // The id of the KPI.
int32 impact_level = 5; // The level of the impact.
bool in_downtime = 6; // True if BA was in downtime during the BA event.
string output = 7; // The first output of the KPI during the event.
string perfdata = 8; // The first perfdata of the KPI during the event.
State status = 9; // The status of the BA during the event.
}
BA duration event eventβ
This event is sent when a new BA duration event is computed by the BAM broker.
- BBDO v2
- BBDO v3
BAM::BaDurationEventβ
Category | element | ID |
---|---|---|
6 | 6 | 393222 |
The content of this message is serialized as follows:
Property | Type | Description |
---|---|---|
ba_id | unsigned integer | The id of the BA. |
real_start_time | time | The first level of the BA event. |
end_time | time | The end_time of the event, in the given time period. |
start_time | time | The start_time of the event, in the given time period. |
duration | unsigned integer | end_time - start_time. |
sla_duration | unsigned integer | The duration of the event in the given time period. |
timeperiod_is_default | boolean | True if the time period is the default for this BA. |
BAM::PbBaDurationEventβ
Category | element | ID |
---|---|---|
6 | 28 | 393244 |
This event is a Protobuf event, so items are not serialized as in BBDO v2 events, but using the Protobuf 3 serialization mechanism. When BBDO v3 is used, no more BAM::BaDurationEvent events should be sent. Instead, you should see BAM::PbBaDurationEvent events.
The protobuf message is the following:
message BaDurationEvent {
uint32 ba_id = 1; // The ID of the BA.
int64 real_start_time = 2; // Effective start timestamp of the event.
int64 end_time = 3; // The end_time of the event, 0 or -1 if the event is opened.
int64 start_time = 4; // Start timestamp of the event.
uint32 duration = 5; // Duration in seconds.
uint32 sla_duration = 6; // The duration of the event in the given timeperiod.
uint32 timeperiod_id = 7; // ID of the timeperiod.
bool timeperiod_is_default = 8; // True if the timeperiod is the default one for this BA.
}
Dimension BAβ
This event is part of the dimension (i.e configuration) dump occurring at startup and after each BAM configuration reload.
- BBDO v2
- BBDO v3
BAM::DimensionBaEventβ
Category | element | ID |
---|---|---|
6 | 7 | 393223 |
The content of this message is serialized as follows:
Property | Type | Description |
---|---|---|
ba_id | unsigned integer | The id of the BA. |
ba_name | string | The name of the BA. |
ba_description | string | The description of the BA. |
sla_month_percent_crit | real | |
sla_month_percent_warn | real | |
sla_month_duration_crit | unsigned integer | |
sla_month_duration_warn | unsigned integer |
BAM::PbDimensionBaEventβ
Category | element | ID |
---|---|---|
6 | 25 | 393241 |
This event is a Protobuf event, so items are not serialized as in BBDO v2 events, but using the Protobuf 3 serialization mechanism. When BBDO v3 is used, no more BAM::DimensionBaEvent events should be sent. Instead, you should see BAM::PbDimensionBaEvent events.
The protobuf message is the following:
message DimensionBaEvent {
uint32 ba_id = 1; // ID of the BA.
string ba_name = 2; // Name of the BA.
string ba_description = 3; // Description of the BA.
double sla_month_percent_crit = 4;
double sla_month_percent_warn = 5;
uint32 sla_duration_crit = 6;
uint32 sla_duration_warn = 7;
}
Dimension KPIβ
This event is part of the dimension (i.e configuration) dump occurring at startup and after each BAM configuration reload.
- BBDO v2
- BBDO v3
BAM::DimensionKpiEventβ
Category | element | ID |
---|---|---|
6 | 8 | 393224 |
The content of this message is serialized as follows:
Property | Type | Description |
---|---|---|
kpi_id | unsigned integer | The id of the KPI. |
ba_id | unsigned integer | The id of the parent BA of this KPI. |
ba_name | string | The name of the parent BA of this KPI. |
host_id | unsigned integer | The id of the host associated with this KPI for service KPI. |
host_name | string | The name of the host associated with this KPI for service KPI. |
service_id | unsigned integer | The id of the service associated with this KPI for service KPI. |
service_description | string | The description of the service associated with this KPI for service KPI. |
kpi_ba_id | unsigned integer | The id of the BA associated with this KPI for BA KPI. |
kpi_ba_name | string | The name of the BA associated with this KPI for BA KPI. |
meta_service_id | unsigned int | The id of the meta-service associated with this KPI for meta-service KPI. |
meta_service_name | string | The name of the meta-service associated with this KPI for meta-service KPI. |
boolean_id | unsigned int | The id of the boolean expression associated with this KPI for boolean KPI. |
boolean_name | string | The name of the boolean expression associated with this KPI for boolean KPI. |
impact_warning | real | The impact of a warning state for this KPI. |
impact_critical | real | The impact of a critical state for this KPI. |
impact_unknown | real | The impact of an unknown state for this KPI. |
BAM::PbDimensionKpiEventβ
Category | element | ID |
---|---|---|
6 | 26 | 393242 |
This event is a Protobuf event, so items are not serialized as in BBDO v2 events, but using the Protobuf 3 serialization mechanism. When BBDO v3 is used, no more BAM::DimensionKpiEvent events should be sent. Instead, you should see BAM::PbDimensionKpiEvent events.
The protobuf message is the following:
message DimensionKpiEvent {
uint32 kpi_id = 1; // Id of the KPI.
uint32 ba_id = 2; // Id of the parent BA of this KPI.
string ba_name = 3; // Name of the parent BA of this KPI.
uint32 host_id = 4; // Id of the host associated with this KPI for service KPI.
string host_name = 5; // Name of the host associated with this KPI for service KPI.
uint32 service_id = 6; // Id of the service associated with this KPI for service KPI.
string service_description = 7; // Description of the service associated with this KPI for service KPI.
uint32 kpi_ba_id = 8; // Id of the BA associated with this KPI for BA KPI.
string kpi_ba_name = 9; // Name of the BA associated with this KPI for BA KPI.
uint32 meta_service_id = 10; // Id of the meta-service associated with this KPI for meta-service KPI.
string meta_service_name = 11; // Name of the meta-service associated with this KPI for meta-service KPI.
uint32 boolean_id = 12; // Id of the boolean expression associated with this KPI for boolean KPI.
string boolean_name = 13; // Name of the boolean expression associated with this KPI for boolean KPI.
double impact_warning = 14; // Impact of a warning state for this KPI.
double impact_critical = 15; // Impact of a critical state for this KPI.
double impact_unknown = 16; // Impact of a unknown state for this KPI.
}
Dimension BA BV relationβ
This event is part of the dimension (i.e configuration) dump occurring at startup and after each BAM configuration reload.
- BBDO v2
- BBDO v3
BAM::DimensionBaBvRelationEventβ
Category | element | ID |
---|---|---|
6 | 9 | 393225 |
The content of this message is serialized as follows:
Property | Type | Description |
---|---|---|
ba_id | unsigned integer | The id of the BA. |
bv_id | unsigned integer | The id of the BV. |
BAM::PbDimensionBaBvRelationEventβ
Category | element | ID |
---|---|---|
6 | 23 | 393239 |
This event is a Protobuf event, so items are not serialized as in BBDO v2 events, but using the Protobuf 3 serialization mechanism. When BBDO v3 is used, no more BAM::DimensionBaBvRelationEvent events should be sent. Instead, you should see BAM::PbDimensionBaBvRelationEvent events.
The protobuf message is the following:
message DimensionBaBvRelationEvent {
uint32 ba_id = 1; // ID of the BA.
uint32 bv_id = 2; // ID of the BV.
}
Dimension BVβ
This event is part of the dimension (i.e configuration) dump occurring at startup and after each BAM configuration reload.
- BBDO v2
- BBDO v3
BAM::DimensionBvEventβ
Category | element | ID |
---|---|---|
6 | 10 | 393226 |
The content of this message is serialized as follows:
Property | Type | Description |
---|---|---|
bv_id | unsigned integer | The id of the BV. |
bv_name | string | The name of the BV. |
bv_description | string | The description of the BV. |
BAM::PbDimensionBvEventβ
Category | element | ID |
---|---|---|
6 | 22 | 393238 |
This event is a Protobuf event, so items are not serialized as in BBDO v2 events, but using the Protobuf 3 serialization mechanism. When BBDO v3 is used, no more BAM::DimensionBvEvent events should be sent. Instead, you should see BAM::PbDimensionBvEvent events.
The protobuf message is the following:
message DimensionBvEvent {
uint32 bv_id = 1; // BV ID.
string bv_name = 2; // BV name.
string bv_description = 3; // BV description.
}
Dimension Truncate Table Signalβ
This event is part of the dimension (i.e configuration) dump occurring at startup and after each BAM configuration reload.
This signal is sent before the dump of all the dimensions, and again at the end of the dump.
- BBDO v2
- BBDO v3
BAM::DimensionTruncateTableSignalβ
Category | element | ID |
---|---|---|
6 | 11 | 393228 |
The content of this message is serialized as follows:
Property | Type | Description |
---|---|---|
update_started | boolean | True if this is the start of the dump, false if it's the end. |
BAM::PbDimensionTruncateTableSignalβ
Category | element | ID |
---|---|---|
6 | 30 | 393246 |
This event is a Protobuf event, so items are not serialized as in BBDO v2 events, but using the Protobuf 3 serialization mechanism. When BBDO v3 is used, no more BAM::DimensionTruncateTableSignal events should be sent. Instead, you should see BAM::PbDimensionTruncateTableSignal events.
The protobuf message is the following:
message DimensionTruncateTableSignal {
bool update_started = 1; // True if this is the start of the dump, false if it's the end.
}
Rebuild signalβ
This event is sent when a rebuild of event durations and availabilities is received by the BAM broker endpoint.
- BBDO v2
- BBDO v3
BAM::Rebuildβ
Category | element | ID |
---|---|---|
6 | 12 | 393228 |
The content of this message is serialized as follows:
Property | Type | Description |
---|---|---|
bas_to_rebuild | string | A string containing the id of all the BAs to rebuild, separated by a comma and a space (i.e "1, 5, 8, 12"). |
The event is the same as in BBDO v2. There is no Protobuf event.
Dimension timeperiodβ
This event is part of the dimension (i.e configuration) dump occurring at startup and after each BAM configuration reload.
- BBDO v2
- BBDO v3
BAM::DimensionTimeperiodβ
Category | element | ID |
---|---|---|
6 | 13 | 393230 |
The content of this message is serialized as follows:
Property | Type | Description |
---|---|---|
tp_id | unsigned integer | The ID of the time period. |
name | string | The name of the time period. |
monday | string | The time period rule for this day. |
tuesday | string | The time period rule for this day. |
wednesday | string | The time period rule for this day. |
thursday | string | The time period rule for this day. |
friday | string | The time period rule for this day. |
saturday | string | The time period rule for this day. |
sunday | string | The time period rule for this day. |
BAM::PbDimensionTimeperiodβ
Category | element | ID |
---|---|---|
6 | 24 | 393240 |
This event is a Protobuf event, so items are not serialized as in BBDO v2 events, but using the Protobuf 3 serialization mechanism. When BBDO v3 is used, no more BAM::DimensionTimeperiod events should be sent. Instead, you should see BAM::PbDimensionTimeperiod events.
The protobuf message is the following:
message DimensionTimeperiod {
uint32 id = 1; // The ID of the timeperiod.
string name = 2; // The name of the timeperiod.
string monday = 3; // The timeperiod rule for this day.
string tuesday = 4; // The timeperiod rule for this day.
string wednesday = 5; // The timeperiod rule for this day.
string thursday = 6; // The timeperiod rule for this day.
string friday = 7; // The timeperiod rule for this day.
string saturday = 8; // The timeperiod rule for this day.
string sunday = 9; // The timeperiod rule for this day.
}
Dimension BA timeperiod relationβ
This event is part of the dimension (i.e configuration) dump occurring at startup and after each BAM configuration reload.
- BBDO v2
- BBDO v3
BAM::DimensionBaTimeperiodRelationβ
Category | element | ID |
---|---|---|
6 | 14 | 393231 |
The content of this message is serialized as follows:
Property | Type | Description |
---|---|---|
ba_id | unsigned integer | The ID of the BA. |
timeperiod_id | unsigned integer | The ID of the time period. |
is_default | boolean | True if the time period is the default one for this BA. |
BAM::PbDimensionBaTimeperiodRelationβ
Category | element | ID |
---|---|---|
6 | 29 | 393245 |
This event is a Protobuf event, so items are not serialized as in BBDO v2 events, but using the Protobuf 3 serialization mechanism. When BBDO v3 is used, no more BAM::DimensionBaTimeperiodRelation events should be sent. Instead, you should see BAM::PbDimensionBaTimeperiodRelation events.
The protobuf message is the following:
message DimensionBaTimeperiodRelation {
uint32 ba_id = 1; // ID of the BA.
uint32 timeperiod_id = 2; // ID of the timeperiod.
bool is_default = 3; // True if the timeperiod is the default one for this BA.
}
Inherited downtimeβ
- BBDO v2
- BBDO v3
BAM::InheritedDowntimeβ
Category | element | ID |
---|---|---|
6 | 17 | 393233 |
The content of this message is serialized as follows:
Property | Type | Description |
---|---|---|
bad_id | unsigned integer | The id of the BA in downtime. |
in_downtime | boolean | True if the BA is in downtime. |
BAM::PbInheritedDowntimeβ
Category | element | ID |
---|---|---|
6 | 18 | 393234 |
This event is a Protobuf event, so items are not serialized as in BBDO v2 events, but using the Protobuf 3 serialization mechanism. When BBDO v3 is used, no more BAM::InheritedDowntime events should be sent. Instead, you should see BAM::PbInheritedDowntime events.
The protobuf message is the following:
message BBDOHeader {
uint32 conf_version = 1;
}
message InheritedDowntime {
BBDOHeader header = 1;
uint32 ba_id = 2; // ID of the BA concerned by the downtime.
bool in_downtime = 3; // True if the BA is in downtime.
}