Centreon Broker Event Mapping Centreon Broker uses global mapping tables for events that can be
exchanged. How exactly these mapping tables work is left to discover to
the reader. This page list properties available for each event type.
NEB Acknowledgement Property Type Description acknowledgement_type short integer Host acknowledgement when 0, service acknowledgement when 1. author string Acknowledgement author. comment string Comment associated to 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 ack.
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).
Custom variable 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. 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.
Custom variable status Custom variable status events are generated when a custom variable needs
to be updated.
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.
Downtime 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 a service downtime, 2 for a 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 a 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 cancelled. 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 timepriod of the recurring downtime. come_from short Id of the parent recurring downtime for spawned downtimes.
Event handler 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.
Flapping status Property Type Description event_time time event_type integer flapping_type short integer high_threshold real High flapping threshold. host_id unsigned integer Host ID. low_threshold real Low flapping threshold. percent_state_change real reason_type short integer service_id unsigned integer Service ID. 0 if this is a host flapping entry.
Host Property Type Description Version acknowledged boolean acknowledgement_type short integer action_url string active_checks_enabled boolean address string alias string check_freshness boolean check_interval real check_period string check_type short integer current_check_attempt short integer current_state short integer default_active_checks_enabled boolean default_event_handler_enabled boolean default_flap_detection_enabled boolean default_notifications_enabled boolean default_passive_checks_enabled boolean downtime_depth short integer display_name string enabled boolean event_handler string event_handler_enabled boolean execution_time real first_notification_delay real flap_detection_enabled boolean flap_detection_on_down boolean flap_detection_on_unreachable boolean flap_detection_on_up boolean freshness_threshold real has_been_checked boolean high_flap_threshold real host_name string host_id unsigned integer icon_image string icon_image_alt string instance_id unsigned integer is_flapping boolean last_check time last_hard_state short integer last_hard_state_change time last_notification time last_state_change time last_time_down time last_time_unreachable time last_time_up time last_update time latency real low_flap_threshold real max_check_attempts short integer next_check time next_notification time no_more_notifications boolean notes string notes_url string notification_interval real notification_number short integer notification_period string notifications_enabled boolean notify_on_down boolean notify_on_downtime boolean notify_on_flapping boolean notify_on_recovery boolean notify_on_unreachable boolean obsess_over boolean passive_checks_enabled boolean percent_state_change real retry_interval real should_be_scheduled boolean stalk_on_down boolean stalk_on_unreachable boolean stalk_on_up boolean statusmap_image string state_type short integer check_command string output string perf_data string retain_nonstatus_information boolean retain_status_information boolean timezone string
Host check Property Type Description Version 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.
Host dependency Property Type Description Version dependency_period string dependent_host_id unsigned integer enabled boolean execution_failure_options string inherits_parent boolean host_id unsigned integer notification_failure_options string
Host group Property Type Description Version host_group_id unsigned integer name string Group name. enabled boolean True if the group is enabled, false if it is not (deletion). poller_id unsigned integer
Host group member Property Type Description Version 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 this event. destination_id unsigned integer The id of the destination instance of this event.
Host parent Property Type Description Version 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.
Host status Property Type Description Version acknowledged boolean acknowledgement_type short integer active_checks_enabled boolean check_interval real check_period string check_type short integer current_check_attempt short integer current_state short integer downtime_depth short integer enabled boolean event_handler string event_handler_enabled boolean execution_time real flap_detection_enabled boolean has_been_checked boolean host_id unsigned integer is_flapping boolean last_check time last_hard_state short integer last_hard_state_change time last_notification time last_state_change time last_time_down time last_time_unreachable time last_time_up time last_update time latency real max_check_attempts short integer next_check time next_host_notification time no_more_notifications boolean notification_number short integer notifications_enabled boolean obsess_over boolean passive_checks_enabled boolean percent_state_change real retry_interval real should_be_scheduled boolean state_type short integer check_command string output string perf_data string
Instance Property Type Description Version 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.
Instance status 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 hosts freshness checking is globally enabled. check_services_freshness boolean Whether or not services 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.
Log entry Property Type Description Version 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.
Module Module events are generated when Centreon Broker modules get loaded
or unloaded.
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.
Service Property Type Description Version acknowledged boolean acknowledged_type short integer action_url string active_checks_enabled boolean check_freshness boolean check_interval real check_period string check_type short integer current_check_attempt short integer current_state short integer default_active_checks_enabled boolean default_event_handler_enabled boolean default_flap_detection_enabled boolean default_notifications_enabled boolean default_passive_checks_enabled boolean dowtine_depth short integer display_name string enabled boolean event_handler string event_handler_enabled boolean execution_time real first_notification_delay real flap_detection_enabled boolean flap_detection_on_critical boolean flap_detection_on_ok boolean flap_detection_on_unknown boolean flap_detection_on_warning boolean freshness_threshold real has_been_checked boolean high_flap_threshold real host_id unsigned integer host_name string icon_image string icon_image_alt string service_id unsigned integer is_flapping boolean is_volatile boolean last_check time last_hard_state short integer last_hard_state_change time last_notification time last_state_change time last_time_critical time last_time_ok time last_time_unknown time last_time_warning time last_update time latency real low_flap_threshold real max_check_attempts short integer next_check time next_notification time no_more_notifications boolean notes string notes_url string notification_interval real notification_number short integer notification_period string notifications_enabled boolean notify_on_critical boolean notify_on_downtime boolean notify_on_flapping boolean notify_on_recovery boolean notify_on_unknown boolean notify_on_warning boolean obsess_over boolean passive_checks_enabled boolean percent_state_change real retry_interval real scheduled_downtime_depth short integer service_description string should_be_scheduled boolean stalk_on_critical boolean stalk_on_ok boolean stalk_on_unknown boolean stalk_on_warning boolean state_type short integer check_command string output string perf_data string retain_nonstatus_information boolean retain_status_information boolean
Service check 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.
Service dependency 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
Service group 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
Service group member Property Type Description Version id unsigned integer host_id unsigned integer service_id unsigned integer enabled enabled True if the group is enable, false if it is not (deletion). group_name string Group name. poller_id unsigned integer
Service status Property Type Description Version acknowledged boolean acknowledgement_type short integer active_checks_enabled boolean check_interval real check_period string check_type short integer current_check_attempt short integer current_state short integer downtime_depth short integer enabled boolean event_handler string event_handler_enabled boolean execution_time real flap_detection_enabled boolean has_been_checked boolean host_id unsigned integer host_name string is_flapping boolean last_check time last_hard_state short integer last_hard_state_change time last_notification time last_state_change time last_time_critical time last_time_ok time last_time_unknown time last_time_warning time last_update time latency real max_check_attempts short integer modified_attributes unsigned integer next_check time next_notification time no_more_notifications boolean notification_number short integer notifications_enabled boolean obsess_over boolean passive_checks_enabled boolean percent_state_change real retry_interval real service_description string service_id unsigned integer should_be_scheduled boolean state_type short integer check_command string output string perf_data string
Instance configuration Property Type Description Version loaded boolean True if the instance loaded successfully. poller_id unsigned integer ID of the poller which received a configuration update request (reload).
Responsive instance 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.
Pb Service This event is a Protobuf event so items are not serialized as in the previous
events but using the Protobuf 3 serialization mechanism. When BBDO 3 version is
used, no more Service messages should be sent, instead you should see these
ones.
Such a message is sent to declare a new service or to declare a service change.
The protobuf message
is the following:
enum ServiceType { SERVICE = 0; METASERVICE = 2; BA = 3; } message Service { uint64 host_id = 1; uint64 service_id = 2; enum AckType { NONE = 0; NORMAL = 1; STICKY = 2; } bool acknowledged = 3; AckType acknowledgement_type = 4; bool active_checks = 5; bool enabled = 6; int32 scheduled_downtime_depth = 7; string check_command = 8; uint32 check_interval = 9; string check_period = 10; enum CheckType { ACTIVE = 0; PASSIVE = 1; } CheckType check_type = 11; int32 check_attempt = 12; enum State { OK = 0; WARNING = 1; CRITICAL = 2; UNKNOWN = 3; PENDING = 4; } State state = 13; bool event_handler_enabled = 14; string event_handler = 15; double execution_time = 16; bool flap_detection = 17; bool checked = 18; bool flapping = 19; int64 last_check = 20; State last_hard_state = 21; int64 last_hard_state_change = 22; int64 last_notification = 23; int32 notification_number = 24; int64 last_state_change = 25; int64 last_time_ok = 26; int64 last_time_warning = 27; int64 last_time_critical = 28; int64 last_time_unknown = 29; int64 last_update = 30; double latency = 31; uint32 max_check_attempts = 32; int64 next_check = 33; int64 next_notification = 34; bool no_more_notifications = 35; bool notify = 36; string output = 37; string long_output = 38; bool passive_checks = 39; double percent_state_change = 40; string perfdata = 41; double retry_interval = 42; string host_name = 43; string description = 44; bool should_be_scheduled = 45; bool obsess_over_service = 46; enum StateType { SOFT = 0; HARD = 1; } StateType state_type = 47; string action_url = 48; bool check_freshness = 49; bool default_active_checks = 50; bool default_event_handler_enabled = 51; bool default_flap_detection = 52; bool default_notify = 53; bool default_passive_checks = 54; string display_name = 55; double first_notification_delay = 56; bool flap_detection_on_critical = 57; bool flap_detection_on_ok = 58; bool flap_detection_on_unknown = 59; bool flap_detection_on_warning = 60; double freshness_threshold = 61; double high_flap_threshold = 62; string icon_image = 63; string icon_image_alt = 64; bool is_volatile = 65; double low_flap_threshold = 66; string notes = 67; string notes_url = 68; double notification_interval = 69; string notification_period = 70; bool notify_on_critical = 71; bool notify_on_downtime = 72; bool notify_on_flapping = 73; bool notify_on_recovery = 74; bool notify_on_unknown = 75; bool notify_on_warning = 76; bool stalk_on_critical = 77; bool stalk_on_ok = 78; bool stalk_on_unknown = 79; bool stalk_on_warning = 80; bool retain_nonstatus_information = 81; bool retain_status_information = 82; uint64 severity_id = 83; repeated TagInfo tags = 84; ServiceType type = 85; /* In case of metaservice and ba, they also have an internal id. We keep it * here. */ uint64 internal_id = 86; uint64 icon_id = 87; }
Copier Pb Adaptive service When BBDO 3 version is used, you can see this event sent when a service has
changes in its configuration.
The protobuf message
is the following:
message AdaptiveService { uint64 host_id = 1; uint64 service_id = 2; optional bool notify = 3; optional bool active_checks = 4; optional bool should_be_scheduled = 5; optional bool passive_checks = 6; optional bool event_handler_enabled = 7; optional bool flap_detection_enabled = 8; optional bool obsess_over_service = 9; optional string event_handler = 10; optional string check_command = 11; optional uint32 check_interval = 12; optional uint32 retry_interval = 13; optional uint32 max_check_attempts = 14; optional bool check_freshness = 15; optional string check_period = 16; optional string notification_period = 17; }
Copier Pb Service Status When BBDO 3 version is used, this type of event is sent instead of
Service Status . Its content is almost the same but the old one contains some
configuration items you don't have here, A Pb Service Status is smaller than
a Service Status . Missing items can be found in Pb Service .
The protobuf message
is the following:
message ServiceStatus { uint64 host_id = 1; uint64 service_id = 2; bool checked = 3; enum CheckType { ACTIVE = 0; PASSIVE = 1; } CheckType check_type = 4; enum State { OK = 0; WARNING = 1; CRITICAL = 2; UNKNOWN = 3; PENDING = 4; } State state = 5; enum StateType { SOFT = 0; HARD = 1; } StateType state_type = 6; int64 last_state_change = 7; State last_hard_state = 8; int64 last_hard_state_change = 9; int64 last_time_ok = 10; int64 last_time_warning = 11; int64 last_time_critical = 12; int64 last_time_unknown = 13; string output = 14; string long_output = 15; string perfdata = 16; bool flapping = 17; double percent_state_change = 18; double latency = 19; double execution_time = 20; int64 last_check = 21; int64 next_check = 22; bool should_be_scheduled = 23; int32 check_attempt = 24; int32 notification_number = 25; bool no_more_notifications = 26; int64 last_notification = 27; int64 next_notification = 28; enum AckType { NONE = 0; NORMAL = 1; STICKY = 2; } AckType acknowledgement_type = 29; int32 scheduled_downtime_depth = 30; ServiceType type = 31; /* In case of metaservice and ba, they also have an internal id. We keep it * here. */ uint64 internal_id = 32; }
Copier Pb Host When BBDO 3 version is used, this type of event is sent instead of
Host . Its content is almost the same.
The protobuf message
is the following:
message Host { uint64 host_id = 1; enum AckType { NONE = 0; NORMAL = 1; STICKY = 2; } bool acknowledged = 2; int32 acknowledgement_type = 3; bool active_checks = 4; bool enabled = 5; int32 scheduled_downtime_depth = 6; string check_command = 7; int32 check_interval = 8; string check_period = 9; enum CheckType { ACTIVE = 0; PASSIVE = 1; } CheckType check_type = 10; int32 check_attempt = 11; enum State { UP = 0; DOWN = 1; UNREACHABLE = 2; } State state = 12; bool event_handler_enabled = 13; string event_handler = 14; double execution_time = 15; bool flap_detection = 16; bool checked = 17; bool flapping = 18; int64 last_check = 19; State last_hard_state = 20; int64 last_hard_state_change = 21; int64 last_notification = 22; int32 notification_number = 23; int64 last_state_change = 24; int64 last_time_down = 25; int64 last_time_unreachable = 26; int64 last_time_up = 27; int64 last_update = 28; double latency = 29; int32 max_check_attempts = 30; int64 next_check = 31; int64 next_host_notification = 32; bool no_more_notifications = 33; bool notify = 34; string output = 35; bool passive_checks = 36; double percent_state_change = 37; string perfdata = 38; double retry_interval = 39; bool should_be_scheduled = 40; bool obsess_over_host = 41; enum StateType { SOFT = 0; HARD = 1; } StateType state_type = 42; string action_url = 43; string address = 44; string alias = 45; bool check_freshness = 46; bool default_active_checks = 47; bool default_event_handler_enabled = 48; bool default_flap_detection = 49; bool default_notify = 50; bool default_passive_checks = 51; string display_name = 52; double first_notification_delay = 53; bool flap_detection_on_down = 54; bool flap_detection_on_unreachable = 55; bool flap_detection_on_up = 56; double freshness_threshold = 57; double high_flap_threshold = 58; string name = 59; string icon_image = 60; string icon_image_alt = 61; int32 instance_id = 62; double low_flap_threshold = 63; string notes = 64; string notes_url = 65; double notification_interval = 66; string notification_period = 67; bool notify_on_down = 68; bool notify_on_downtime = 69; bool notify_on_flapping = 70; bool notify_on_recovery = 71; bool notify_on_unreachable = 72; bool stalk_on_down = 73; bool stalk_on_unreachable = 74; bool stalk_on_up = 75; string statusmap_image = 76; bool retain_nonstatus_information = 77; bool retain_status_information = 78; string timezone = 79; uint64 severity_id = 80; repeated TagInfo tags = 81; uint64 icon_id = 82; }
Copier Pb Adaptive host When BBDO 3 version is used, you can see this event sent when a host has
changes in its configuration.
The protobuf message
is the following:
message AdaptiveHost { uint64 host_id = 1; optional bool notify = 2; optional bool active_checks = 3; optional bool should_be_scheduled = 4; optional bool passive_checks = 5; optional bool event_handler_enabled = 6; optional bool flap_detection = 7; optional bool obsess_over_host = 8; optional string event_handler = 9; optional string check_command = 10; optional uint32 check_interval = 11; optional uint32 retry_interval = 12; optional uint32 max_check_attempts = 13; optional bool check_freshness = 14; optional string check_period = 15; optional string notification_period = 16; }
Copier Pb Host Status When BBDO 3 version is used, this type of event is sent instead of
Host Status . Its content is almost the same but the old one contains some
configuration items you don't have here, A Pb Host Status is smaller than
a Host Status . Missing items can be found in Pb Host .
The protobuf message
is the following:
message HostStatus { uint64 host_id = 1; bool checked = 2; enum CheckType { ACTIVE = 0; PASSIVE = 1; } CheckType check_type = 3; enum State { UP = 0; DOWN = 1; UNREACHABLE = 2; } State state = 4; enum StateType { SOFT = 0; HARD = 1; } StateType state_type = 5; int64 last_state_change = 6; State last_hard_state = 7; int64 last_hard_state_change = 8; int64 last_time_up = 9; int64 last_time_down = 10; int64 last_time_unreachable = 11; string output = 12; string long_output = 13; string perfdata = 14; bool flapping = 15; double percent_state_change = 16; double latency = 17; double execution_time = 18; int64 last_check = 19; int64 next_check = 20; bool should_be_scheduled = 21; int32 check_attempt = 22; int32 notification_number = 23; bool no_more_notifications = 24; int64 last_notification = 25; int64 next_host_notification = 26; enum AckType { NONE = 0; NORMAL = 1; STICKY = 2; } AckType acknowledgement_type = 27; int32 scheduled_downtime_depth = 28; }
Copier Pb Severity This event comes with BBDO 3. It contains the severity of a resource.
The protobuf message
is the following:
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; }
Copier Pb Tag This event comes with BBDO 3. It is used to associate a tag to a resource.
There are four types of tag, SERVICEGROUP , HOSTGROUP , SERVICECATEGORY ,
HOSTCATEGORY . A tag is not associated with a poller, but we must know for
internal handling which poller sent the tag, that is why there is a poller_id
item in the message.
The protobuf message
is the following:
enum TagType { SERVICEGROUP = 0; HOSTGROUP = 1; SERVICECATEGORY = 2; HOSTCATEGORY = 3; } message Tag { uint64 id = 1; enum Action { ADD = 0; DELETE = 1; MODIFY = 2; } Action action = 2; TagType type = 3; string name = 4; int64 poller_id = 5; }
Copier Storage Metric This event is generated by a Storage endpoint to notify that a RRD metric
graph should be updated.
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 rebuild (see the rebuild event). host_id unsigned integer The id of the host this metric is attached to. Since 3.0.0 service_id unsigned integer The id of the service this metric is attached to. Since 3.0.0
Rebuild Rebuild events are generated when a Storage endpoint detects that some
graph should be rebuild. It first sends a rebuild start event (end =3D
false), then metric values (metric event with is_for_rebuild set to
true) and finally a rebuild end event (end =3D true).
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.
Remove graph A Storage endpoint generates a remove graph event when some graph
must be deleted.
Property Type Description Version id unsigned integer Index ID (is_index =3D true) or metric ID (is_index =3D 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.
Status Property Type Description Version 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 rebuild (see the rebuild event).
Metric mapping Property Type Description Version index_id unsigned integer Index ID. metric_d unsigned integer Index ID.
Index mapping Property Type Description Version index_id unsigned integer Index ID. host_id unsigned integer Index ID. service_id unsigned integer Index ID.
Pb 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 rebuild
message.
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 in 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; }
Copier Pb 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 to generate a Pb Remove Graph
Message . Two possibilities are mixed in this event. We can remove graphes
matching some index data or graphs matching some metric data. It is also
possible to mix the two kinds.
The protobuf message
is the following:
message RemoveGraphMessage { repeated uint64 index_ids = 1; repeated uint64 metric_ids = 2; }
Copier BBDO Version response Property Type Description Version 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.
Ack 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.
BAM BA status event This event is sent when a BA's status changed.
Property Type Description Version ba_id unsigned integer The id of the BA. Since 2.8.0 (BBDO 1.2.0). in_downtime boolean True of the BA is in downtime. Since 2.8.0 (BBDO 1.2.0). last_state_change time The time of the last state change of the BA. Since 2.8.0 (BBDO 1.2.0). level_acknowledgement real The acknowledgment level of the BA. Since 2.8.0 (BBDO 1.2.0). level_downtime real The downtime level of the BA. Since 2.8.0 (BBDO 1.2.0). level_nominal real The nominal level of the BA. Since 2.8.0 (BBDO 1.2.0). state short integer The state of the BA. Since 2.8.0 (BBDO 1.2.0). state_changed boolean True if the state of the BA just changed. Since 2.8.0 (BBDO 1.2.0).
KPI status event This event is sent when a KPI's status changed.
Property Type Description Version kpi_id unsigned integer The id of the KPI. Since 2.8.0 (BBDO 1.2.0). in_downtime bool True if the KPI is in downtime. level_acknowledgement_hard real The hard acknowledgement level of the KPI. Since 2.8.0 (BBDO 1.2.0). level_acknowledgement_soft real The soft acknowledgement level of the KPI. Since 2.8.0 (BBDO 1.2.0). level_downtime_hard real The hard downtime level of the KPI. Since 2.8.0 (BBDO 1.2.0). level_downtime_soft real The soft downtime level of the KPI. Since 2.8.0 (BBDO 1.2.0). level_nominal_hard real The hard nominal level of the KPI. Since 2.8.0 (BBDO 1.2.0). level_nominal_soft real The soft nominal level of the KPI. Since 2.8.0 (BBDO 1.2.0). state_hard short integer The hard state of the KPI. Since 2.8.0 (BBDO 1.2.0). state_soft short integer The soft state of the KPI. Since 2.8.0 (BBDO 1.2.0). last_state_change time The time of the last state change of the KPI. Since 2.8.0 (BBDO 1.2.0). last_impact real The last impact of the KPI. Since 2.8.0 (BBDO 1.2.0). valid bool True if the KPi is valid.
This event is sent when a meta service's status changed.
Property Type Description Version meta_service_id unsigned integer The id of the meta service. Since 2.8.0 (BBDO 1.2.0). value real The value of the meta service. Since 2.8.0 (BBDO 1.2.0). state_changed boolean True if the state just changed. Since 2.8.0 (BBDO 1.2.0).
BA-event event This event is sent when a new BA event is opened, or an old one is closed.
Property Type Description Version ba_id unsigned integer The id of the BA. Since 2.8.0 (BBDO 1.2.0). first_level real The first level of the BA event. Since 2.8.0 (BBDO 1.2.0). end_time time The end_time of the event. 0 or (time)-1 for an opened event. Since 2.8.0 (BBDO 1.2.0). in_downtime boolean True if BA was in downtime during the BA event. Since 2.8.0 (BBDO 1.2.0). start_time time The start_time of the event. Since 2.8.0 (BBDO 1.2.0). status short integer The status of the BA during the event. Since 2.8.0 (BBDO 1.2.0).
KPI-event event This event is sent when a new KPI event is opened, or an old one is closed.
Property Type Description Version kpi_id unsigned integer The id of the KPI. Since 2.8.0 (BBDO 1.2.0). end_time time The end_time of the event. 0 or (time)-1 for an opened event. Since 2.8.0 (BBDO 1.2.0). impact_level integer The level of the impact. Since 2.8.0 (BBDO 1.2.0). in_downtime boolean True if BA was in downtime during the BA event. Since 2.8.0 (BBDO 1.2.0). first_output string The first output of the KPI during the event. Since 2.8.0 (BBDO 1.2.0). perfdata string The first perfdata of the KPI during the event. Since 2.8.0 (BBDO 1.2.0). start_time time The start_time of the event. Since 2.8.0 (BBDO 1.2.0). status short integer The status of the BA during the event. Since 2.8.0 (BBDO 1.2.0).
BA duration event event This event is sent when a new BA duration event is computed by BAM broker.
Property Type Description Version ba_id unsigned integer The id of the BA. Since 2.8.0 (BBDO 1.2.0). real_start_time time The first level of the BA event. Since 2.8.0 (BBDO 1.2.0). end_time time The end_time of the event, in the given timeperiod. Since 2.8.0 (BBDO 1.2.0). start_time time The start_time of the event, in the given timeperiod. Since 2.8.0 (BBDO 1.2.0). duration unsigned integer end_time - start_time. Since 2.8.0 (BBDO 1.2.0). sla_duration unsigned integer The duration of the event in the given timperiod. Since 2.8.0 (BBDO 1.2.0). timeperiod_is_default boolean True if the timeperiod if the default for this BA. Since 2.8.0 (BBDO 1.2.0).
Dimension BA This event is part of the dimension (i.e configuration) dump occuring at
startup and after each BAM configuration reload.
Property Type Description Version ba_id unsigned integer The id of the BA. Since 2.8.0 (BBDO 1.2.0). ba_name string The name of the BA. Since 2.8.0 (BBDO 1.2.0). ba_description string The description of the BA. Since 2.8.0 (BBDO 1.2.0). sla_month_percent_crit real Since 2.8.0 (BBDO 1.2.0). sla_month_percent_warn real Since 2.8.0 (BBDO 1.2.0). sla_month_duration_crit unsigned integer Since 2.8.0 (BBDO 1.2.0). sla_month_duration_warn unsigned integer Since 2.8.0 (BBDO 1.2.0).
Dimension KPI This event is part of the dimension (i.e configuration) dump occuring at
startup and after each BAM configuration reload.
Property Type Description Version kpi_id unsigned integer The id of the KPI. Since 2.8.0 (BBDO 1.2.0). ba_id unsigned integer The id of the parent BA of this KPI. Since 2.8.0 (BBDO 1.2.0). ba_name string The name of the parent BA of this KPI. Since 2.8.0 (BBDO 1.2.0). host_id unsigned integer The id of the host associated with this KPI for service KPI. Since 2.8.0 (BBDO 1.2.0). host_name string The name of the host associated with this KPI for service KPI. Since 2.8.0 (BBDO 1.2.0) service_id unsigned integer The id of the service associated with this KPI for service KPI. Since 2.8.0 (BBDO 1.2.0). service_description string The description of the service associated with this KPI for service KPI. Since 2.8.0 (BBDO 1.2.0). kpi_ba_id unsigned integer The id of the BA associated with this KPI for BA KPI. Since 2.8.0 (BBDO 1.2.0). kpi_ba_name string The name of the BA associated with this KPI for BA KPI. Since 2.8.0 (BBDO 1.2.0). meta_service_id unsigned int The id of the meta-service associated with this KPI for meta-service KPI. Since 2.8.0 (BBDO 1.2.0). meta_service_name string The name of the meta-service associated with this KPI for meta-service KPI. Since 2.8.0 (BBDO 1.2.0). boolean_id unsigned int The id of the boolean expression associated with this KPI for boolean KPI. Since 2.8.0 (BBDO 1.2.0). boolean_name string The name of the boolean expression associated with this KPI for boolean KPI. Since 2.8.0 (BBDO 1.2.0). impact_warning real The impact of a warning state for this KPI. Since 2.8.0 (BBDO 1.2.0). impact_critical real The impact of a critical state for this KPI. Since 2.8.0 (BBDO 1.2.0). impact_unknown real The impact of a unknown state for this KPI. Since 2.8.0 (BBDO 1.2.0).
Dimension BA BV relation This event is part of the dimension (i.e configuration) dump occuring at
startup and after each BAM configuration reload.
Property Type Description Version ba_id unsigned integer The id of the BA. Since 2.8.0 (BBDO 1.2.0). bv_id unsigned integer The id of the BV. Since 2.8.0 (BBDO 1.2.0).
Dimension BV This event is part of the dimension (i.e configuration) dump occuring at
startup and after each BAM configuration reload.
Property Type Description Version bv_id unsigned integer The id of the BV. Since 2.8.0 (BBDO 1.2.0). bv_name string The name of the BV. Since 2.8.0 (BBDO 1.2.0). bv_description string The description of the BV. Since 2.8.0 (BBDO 1.2.0).
Dimension table signal This event is part of the dimension (i.e configuration) dump occuring 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.
Property Type Description Version update_started boolean True if this is the start of the dump, false if it's the end. Since 2.8.0 (BBD0 1.2.0).
Rebuild signal This event is sent when a rebuild of the event durations and availabilities
is asked to the BAM broker endpoint.
Property Type Description Version 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"). Since 2.8.0 (BBDO 1.2.0).
Dimension timeperiod This event is part of the dimension (i.e configuration) dump occuring at
startup and after each BAM configuration reload.
Property Type Description Version tp_id unsigned integer The id of the timeperiod. Since 2.8.0 (BBDO 1.2.0). name string The name of the timeperiod. Since 2.8.0 (BBDO 1.2.0). monday string The timeperiod rule for this day. Since 2.8.0 (BBDO 1.2.0). tuesday string The timeperiod rule for this day. Since 2.8.0 (BBDO 1.2.0). wednesday string The timeperiod rule for this day. Since 2.8.0 (BBDO 1.2.0). thursday string The timeperiod rule for this day. Since 2.8.0 (BBDO 1.2.0). friday string The timeperiod rule for this day. Since 2.8.0 (BBDO 1.2.0). saturday string The timeperiod rule for this day. Since 2.8.0 (BBDO 1.2.0). sunday string The timeperiod rule for this day. Since 2.8.0 (BBDO 1.2.0).
Dimension BA timeperiod relation This event is part of the dimension (i.e configuration) dump occuring at
startup and after each BAM configuration reload.
Property Type Description Version ba_id unsigned integer The id of the BA. Since 2.8.0 (BBDO 1.2.0). timeperiod_id unsigned integer The id of the timeperiod. Since 2.8.0 (BBDO 1.2.0). is_default boolean True if the timeperiod is the default one for this BA. Since 2.8.0 (BBDO 1.2.0).
Dimension timeperiod exception This event is part of the dimension (i.e configuration) dump occuring at
startup and after each BAM configuration reload.
Property Type Description Version timeperiod_id unsigned integer The id of the timeperiod having this exception. Since 2.8.0 daterange string A string containing the date of the range. Since 2.8.0 timerange string A string containing the time of the range. Since 2.8.0 (BBDO 1.2.0).
Dimension timeperiod exclusion This event is part of the dimension (i.e configuration) dump occuring at
startup and after each BAM configuration reload.
Property Type Description Version timeperiod_id unsigned integer The id of the timeperiod having this exclusion. Since 2.8.0 (BBDO 1.2.0). excluded_timeperiod_id unsigned integer The id of the excluded timeperiod. Since 2.8.0 (BBDO 1.2.0).
Inherited downtime Property Type Description Version bad_id unsigned integer The id of the BA in downtime. in_downtime boolean True if the BA is in downtime.
Extcmd Command request Property Type Description Version command string The command request. endp string The endpoint this command is destined to. uuid string The uuid of this request. with_partial_result boolean True if the command should be answered with partial result.
Command result Property Type Description Version code integer The return code of this command. uuid string The uuid of the request this command is the result of. msg string The string message of the command result.