Welcome to docs.opsview.com

Differences

This shows you the differences between two versions of the page.

opsview4.6:systempreference [2014/09/09 12:19] (current)
Line 1: Line 1:
 +====== System Preferences ======
 +===== Web =====
 +{{:opsview4.6:editing-system-preferences4.png|}}
 +==== Opsview Web Server ====
 +This is the web server for accessing the web interface of Opsview.
 +
 +If this field has not been saved before, the field will be automatically populated based on the URL.
 +
 +At reload time, if this system preference has not been saved, Opsview will use the master server's hostname (or IP).
 +
 +==== Show Timeline ====
 +This controls the default value for whether to show the time line when the page first loads in the Events view.
 +
 +==== Network Map Layout ====
 +
 +This refers to the default layout of the ''Network Map''.
 +
 +  * Depth Layers
 +  * Collapsed Tree
 +  * Balanced Tree (default) - display the master server in the middle of the page with all parent/child relationships beneath
 +  * Circular - the master server is in the middle of the page with all parent child relationships linked radially, with distance related to the number of relationships between a host and the master server
 +  * Circular (Marked Up) - see ''Circular'', but also includes clearer markings for distance from master server
 +
 +==== Refresh rate ====
 +
 +The refresh rate / refresh interval field specifies how frequently (in seconds) pages within the Opsview GUI will automatically refresh. A page refresh can be performed manually by clicking the refresh button within the Opsview GUI.
 +==== Audit log retention ====
 +Specifies how long in days that the audit logs are kept for. If you set this to 0, logs will never be removed.
 +
 +The tables pruned based on this variable in runtime are:
 +  * nagios_contactnotificationmethods
 +  * nagios_contactnotifications
 +  * nagios_notifications
 +  * nagios_statehistory
 +  * nagios_commenthistory
 +  * nagios_acknowledgements
 +  * nagios_flappinghistory
 +  * nagios_downtimehistory
 +  * nagios_eventhandlers
 +
 +These tables are pruned of data older than 7 days. See [[odw|ODW]] if you wish to retain the data over a longer period.
 +  * nagios_servicechecks
 +  * nagios_hostchecks
 +
 +These tables are pruned of data older than 7 days. It is only used for debugging purposes:
 +  * nagios_conninfo
 +
 +The [[opsview4.6:housekeeping]] job runs overnight.
 +
 +
 +==== Host Auto Select Monitoring Server ====
 +If selected, then when an [[host#hostname_or_ip|host name or IP]] is changed for a host, then the monitoring server will be automatically chosen.
 +
 +The default is on.
 +
 +
 +==== Smart Host Template Removal ====
 +If a host template is removed from a host, via the host edit page or the host template edit page, then if this flag is set, then any appropriate host specific monitors will be removed **unless** the host monitor is also referenced in another host template that this host has.
 +
 +For example, assume hostA has two host templates, //Unix Base// and //Unix Backup//. The Unix Base host template has two service checks, //Loadavg// and //Memory//. The Unix Backup host template has //Loadavg// only. The host also has two host exceptions for both //Loadavg// and //Memory//.
 +
 +If hostA has the //Unix Base// host template removed, then if this flag is set, the host exception for //Memory// is removed. If it was **not** removed, then on an reload, Memory would be created as a service because it is still referenced as a host specific monitor. Note that Loadavg would not be removed because it is still referenced in the Unix Backup host template.
 +
 +The default value for this is on as this is a useful behaviour.
 +
 +==== Set Downtime on Host Delete ====
 +When a host is deleted, Opsview will automatically add +7d downtime to the host thus suppressing notifications before a reload occurs. This is especially useful in larger environments were reloads may take some time or are scheduled for a later time.
 +
 +The default value is //on// as this is a useful behaviour.
 +
 +**Note**: If you restore a previous database configuration so that the live monitoring has never seen the host being removed, then the host will remain in a downtime state. You will need to manually cancel the downtime.
 +
 +==== Hostgroup information URL ====
 +
 +URL constructed using macros to use instead of the default [[opsview4.6:objectwiki|wiki information]] pages, specifically for hostgroup information.
 +
 +Available macros are:
 +
 +  * ''$HOSTGROUPNAME$''       - name of hostgroup
 +
 +==== Host information URL ====
 +
 +URL constructed using macros to use instead of the default [[opsview4.6:objectwiki|wiki information]] pages, specifically for host information.
 +
 +Available macros are:
 +
 +  * ''$HOSTADDRESS$''         - primary hostname/IP of the host
 +  * ''$HOSTNAME$''            - title of the host
 +
 +==== Service information URL ====
 +
 +URL constructed using macros to use instead of the default [[opsview4.6:objectwiki|wiki information]] pages, specifically for service information. This is available from version 3.13.1.
 +
 +Available macros are:
 +
 +  * ''$HOSTADDRESS$''         - primary hostname/IP of host
 +  * ''$HOSTNAME$''            - title of the host
 +  * ''$SERVICENAME$''         - name of service
 +  * ''$SERVICECHECKNAME$''    - name of service check
 +
 +==== Netdisco URL ====
 +Enter a URL to your [[http://netdisco.org|Netdisco]] instance. It should be of the form:
 +<code>
 +http://server.example.com/netdisco
 +</code>
 +A link will be added to Netdisco on the Host Interface page.
 +
 +You can also search a device on your Netdisco instance if you type in the Search Host box: ''nd hostname''.
 +
 +===== Updates =====
 +
 +{{:opsview4.6:editing-system-preferences4-updates.png|}}
 +
 +==== Include Major Updates ====
 +
 +This option controls whether you will get alerts about new major Opsview releases.
 +
 +You will always get an alert about any minor versions that have been released (eg, you are currently on 3.2.2 and 3.2.3 is released).
 +
 +However, if this flag is set, you will also get an alert when 3.4.0 is released. If the flag is not set, you will only get alerts about minor releases for your existing version.
 +
 +More information is available at the [[opsview4.6:checkupdates|check updates]] page.
 +
 +**Note**: This flag is only available on Enterprise editions of Opsview. Because older Community editions are deprecated as soon as a newer Community edition is available, you will always get alerted about major releases. This option was still available in Opsview 3.3.0, but is removed from 3.3.1 onwards.
 +
 +==== Include Survey Data ====
 +This flag determines whether Opsview sends anonymous information about your system to our central server.
 +
 +You can click on the //Show Survey Information for Your System// button to show what data would be sent back.
 +
 +More information can be found at the [[opsview4.6:systemsurvey|Opsview System Survey]] page.
 +
 +
 +===== ODW =====
 +
 +{{:opsview4.6:editing-system-preferences4-odw.png|}}
 +
 +==== Enable ODW Import ====
 +This option controls whether [[ODW]] will be populated with events and statistical data.
 +
 +If selected, a summary of the previous hour's data will be imported at 4 minutes past every hour.
 +
 +The import will populate the following tables in [[ODW]]:
 +  * downtime_host_history
 +  * downtime_service_history
 +  * acknowledgement_host
 +  * acknowledgement_service
 +  * state_history
 +  * notification_host_history
 +  * notification_service_history
 +  * service_availability_hourly_summary
 +  * performance_hourly_summary
 +==== Retention ====
 +This value is used by the nightly housekeeping to determine how many months of data are to be retained for the standard data.
 +
 +If you set to 0, then the table will not be trimmed. However, you will need to put some procedures in place to archive the data away regularly - for instance, if you have mysql partitioning enabled, you may want to drop a whole partition at a time instead of running a DELETE.
 +
 +==== Enable Extended Import ====
 +This option controls whether extended data is stored in the [[odw|ODW]] database. This means every service check result and every performance data plot will be stored.
 +
 +This will populate the following tables in [[ODW]]:
 +  * servicecheck_results
 +  * performance_data
 +
 +**Note**: This is likely to use a lot of space in ODW.
 +==== Retention (Extended) ====
 +This value is used by the nightly housekeeping to determine how many months of data are to be retained for the extended data.
 +
 +If you set to 0, then the table will not be trimmed. However, you will need to put some procedures in place to archive the data away regularly.
 +
 +**Note**: This retention period does not affect the RRD data storage or other disk files.
 +
 +==== Import All Hosts ====
 +
 +This value is used to import data relating to all hosts into the ODW database. If it is not checked, then only [[#hosts|selected hosts]] will be included in the import.
 +
 +==== Hosts =====
 +This is the list of hosts that will be included in ODW imports, but only if there are matching service checks.
 +
 +==== Import All Service Checks ====
 +
 +This value is used to import data relating to all service checks into the ODW database. If it is not checked, then only [[#service_checks|selected servicechecks]] will be included in the import.
 +
 +==== Service Checks ====
 +This is the specific list of service checks to import, but only if there are matching hosts.
 +
 +===== Nagios =====
 +
 +{{:opsview4.6:editing-system-preferences4-nagioscore.png|}}
 +
 +==== Date Format ====
 +
 +Change the general date format.  This option only applies to Nagios Core pages.
 +
 +^Option^Format^Example Date^
 +|US|MM/DD/YYYY HH:MM:SS|02/29/2012 16:45:00|
 +|Euro (Default)|DD/MM/YYYY HH:MM:SS|29/02/2012 16:45:00|
 +|ISO-8601|YYYY-MM-DD HH:MM:SS|2012-02-29 16:45:00|
 +|Strict ISO-8601|YYYY-MM-DDTHH:MM:SS|2012-02-29T16:45:00|
 +
 +==== Soft State Dependencies ====
 +
 +This option determines whether or not NagiosĀ® Core will use soft service state information when checking service dependencies. Normally Nagios Core will only use the latest hard service state when checking dependencies. If you want it to use the latest state (regardless of whether its a soft or hard state type), enable this option.
 +
 +You can define dependencies in the [[opsview4.6:servicecheck#dependencies|service check configuration]].
 +
 +==== Log Notifications ====
 +Logs when a notification is sent out. Useful.
 +==== Log Event Handlers ====
 +Logs when an event handler script is invoked. Useful.
 +
 +==== Log Service Retries ====
 +Logs when a service is in a soft failure state. Useful, especially when debugging event handlers.
 +
 +==== Log Host Retries ====
 +Logs when a host is in a soft failure state. Useful, especially when debugging event handlers.
 +
 +==== Log Passive Checks ====
 +This logs every passive check into the Nagios Core log file. This value will affect the master and slave servers.
 +
 +**Note**: In a distributed environment, this will produce a large number of log entries on the master. Only switch on for short periods of time.
 +
 +==== Enable Core Dumps ====
 +Used for debugging if you find that Nagios Core unexpectedly crashes.
 +
 +Core dumps will be written to the nagios user's home directory. Check that the nagios user can write to their home directory and that ''ulimit -c'' is not zero.
 +
 +If you see the following in the nagios.log file:
 +<code>
 +[1274862094] Caught SIGSEGV, shutting down...
 +</code>
 +
 +Then a core dump will **not** be produced, because the nagios daemon would have handled a SIGSEGV signal, instead of allowing the OS to produce a core dump.
Navigation
Print/export
Toolbox