opEvents Configuration Settings

opEvents Configuration Settings

opEvents Configuration

The configuration options for opEvents are stored in a json formatted text file: /usr/local/omk/conf/opCommon.json.

Configuration items that are not application specific are detailed on the opCommon Configuration page.

Common Settings to Consider Adjusting

The items below are commonly changed by customers.

Section

Name

Original Value

Description

Section

Name

Original Value

Description

opevents

opevents_event_status_values

[{'status' : 'Detected'},{'status' : 'Investigating'},{'status' : 'Resolved'}]

Values which the operator can select. If enabled or the event has the status property, a select box will be rendered in the event context panel.

To configure to work for your team, decide on what fields you want to include in your status.

opevents

opevents_url_base

http://yourserver.yourdomain

For creating links in emails

opevents

opevents_max_period_value

90d

If N[dhm], any requests for longer periods are truncated

opevents

opeventsd_restart_on_config_change

false

Should the daemon restart if a config change is detected, such as EventActions.json. Recommended to only be turned on in test environments

opevents

opevents_hostname

localhost

For the hostname in the syslog events

Specific Configuration

The opEvents section of opCommon.nmis is for opEvents specific configuration items only.

Section

Name

Original Value

 

Possible Values

Description

Section

Name

Original Value

 

Possible Values

Description

opevents

black_list_enabled

true

 

true, false

 

opevents

log_archive_enabled

true

 

true, false

 

opevents

nmis_non_stateful_events

Node Configuration Change|Node Reset

 

 

 

opevents

opevents_action_max_runtime

30

 

<integer>

how long an asynchronous policy action process may run (Seconds value)

opevents

opevents_action_policy

<omk_conf>/EventActions.nmis

 

<relative filepath>

 

opevents

opevents_application_heading

 

 

 

 

opevents

opevents_archivelogs_purge_older_than

365d

 

 

archive logs (format NN[dhm]..., plain N means N minutes. 0 or undef means no purging).

opevents

opevents_auto_acknowledge

true

 

true, false

auto-acknowledge the down event on state down->up or not?

opevents

opevents_auto_acknowledge_up

true

 

true, false

if opevents_auto_acknowledge is on, also acknowledge the up event?

opevents

opevents_auto_create_nodes

false

 

true, false

If true an event from a node that does not exists then opEvents will automatically create a node entry.

opevents

opevents_contacts

<omk_conf>/Contacts.nmis

 

 

 

opevents

opevents_correlation_node

global

 

 

Node Name that will appear in correlated events

opevents

opevents_daily_report_recipients

 

 

 

Who to send Daily Event Reports to, email setup is required

opevents

opevents_daily_report_title

Daily Summary Report

 

 

 

opevents

opevents_debug

0

 

<integer>

for troubleshooting purposes, use to increase log verbosity. Make sure to change back to default as log will ballon

opevents

opevents_emails

<omk_conf>/EventEmails.nmis

 

<relative filepath>

Where to find opEvent Email templates

opevents

opevents_event_rules

<omk_conf>/EventRules.nmis

 

<relative filepath>

 

opevents

opevents_event_status_default_value

 

 

 

For use with "opevents_event_status_values"

opevents

opevents_event_status_enabled

false

 

true, false

If true opevents_event_status_values will be added to events

opevents

opevents_event_status_values

[{'status' : 'Detected'},{'status' : 'Investigating'},{'status' : 'Resolved'}]

 

 

An array

opevents

opevents_events_purge_older_than

180d

 

 

events and actions (format NN[dhm]..., plain N means N minutes. 0 or undef means no purging).

opevents

opevents_flap_name

event.stateful Flap

 

 

node.X, event.Y and macro.Z are substituted

opevents

opevents_gui_console_default_period

2h

 

 

Events in the last X timeframe will be loaded

opevents

opevents_gui_console_pagination

[10,10]

 

 

How many rows to load. Separate for top and bottom panels

opevents

opevents_gui_current_events_priorities

[3,10]

 

3, 4, 5, 6, 7, 8, 9, 10

Only priorities 3..10 are included in current events view

opevents

opevents_gui_dashboard_default_period

2h

 

 

Events in the last X timeframe will be loaded

opevents

opevents_gui_dashboard_pagination

10

 

<integer>

Default records per page for dashboard, event list and event console pages

opevents

opevents_gui_default_period

2h

 

 

Default period for the gui screens: general and node/event context pages

opevents

opevents_gui_event_context_period

2h

 

 

How much time before/after an event to consider for context

opevents

opevents_gui_event_context_summary_list

 

 

 

 

opevents

opevents_gui_event_node_summary_list

["name","group","location","customer","businessService","host"]

 

 

Default list for opevents' mail template use, also gui for event-related node context

opevents

opevents_gui_events_coloring

true

 

true, false

Color events by severity

opevents

opevents_gui_events_pagination

25

 

<integer>

 

opevents

opevents_gui_node_summary_list

["name","group","location","customer","businessService","host"]

 

 

Default property list for opevents' gui, for node context

opevents

opevents_gui_period_values

['15m','30m','1h','90m','2h','4h','8h','12h','1d', '2d', '15d', '30d', '60d', '90d' ]

 

 

 

opevents

opevents_hostname

localhost

 

<hostname>

For the hostname in the syslog events

opevents

opevents_import_node_interfaces

true

 

true, false

 

opevents

opevents_import_nodes_activated

true

 

true, false

 

opevents

opevents_kb_link_title

KB Lookup

 

 

 

opevents

opevents_kb_link_url

https://community.opmantek.com/x/%s

 

<url>

 

opevents

opevents_list_rules

<omk_conf>/EventListRules.nmis

 

<relative filepath>

 

opevents

opevents_logs

 

 

 

See Documentation

opevents

opevents_max_action_queue_age

3600

 

<integer>

Abort action processing if action queued longer than N seconds (set to zero to disable).

opevents

opevents_max_event_age

7200

 

<integer>

Ignore input events older than N seconds (set to zero to disable).

opevents

opevents_max_period_value

90d

 

 

If N[dhm], any requests for longer periods are truncated

opevents

opevents_max_time_delta

0

 

<integer>

 

opevents

opevents_monthly_report_recipients

 

 

 

Who to email Monthly report too, email setup is required

opevents

opevents_monthly_report_title

Monthly Summary Report

 

 

 

opevents

opevents_move_json_logs

<nmis_logs>/json/historic

 

 

If set, move consumed json log files into this directory, if unset, remove consumed json log files

opevents

opevents_nmis_rules

<omk_conf>/EventNmisRules.nmis

 

<relative filepath>

 

opevents

opevents_no_action_on_flap

true

 

true, false

skip actions on flap detected?

opevents

opevents_parser_rules

<omk_conf>/EventParserRules.nmis