Operational Monitoring System Parameters

X-Road: Operational Monitoring System Parameters

User Guide

Version: 0.5 Doc ID: UG-OPMONSYSPAR

Date	Version	Description	Author
	0.2	Initial version
23.01.2017	0.3	Added license text, table of contents and version history	Sami Kallio
17.03.2017	0.4	Added new parameters op-monitor-buffer.connection-timeout-seconds and op-monitor-service.connection-timeout-seconds	Kristo Heero
05.03.2018	0.5	Added reference to terms and abbreviations doc	Tatu Repo

Table of Contents

• License

• 1 Introduction

  • 1.1 Terms and abbreviations

  • 1.2 References

• 2 Operational Monitoring System Parameters

License

This document is licensed under the Creative Commons Attribution-ShareAlike 3.0 Unported License. To view a copy of this license, visit http://creativecommons.org/licenses/by-sa/3.0/.

1 Introduction

This document describes the system parameters of the X-Road operational monitoring system components – the operational monitoring daemon, the operational monitoring buffer and the operational monitoring service. Changing the default values of the system parameters is explained in [UG-SYSPAR].

1.1 Terms and abbreviations

See X-Road terms and abbreviations documentation [TA-TERMS].

1.2 References

UG-SYSPAR -- Cybernetica AS. X-Road: System Parameters. Document ID: UG-SYSPAR. UG-SS -- Cybernetica AS. X-Road: Security Server User Guide. Document ID: UG-SS. CRON -- Quartz Scheduler Cron Trigger Tutorial, http://www.quartz-scheduler.org/documentation/quartz-2.2.x/tutorials/crontrigger.html TA-TERMS -- X-Road Terms and Abbreviations. Document ID: TA-TERMS.

2 Operational Monitoring System Parameters

This chapter describes the system parameters used by the X-Road operational monitoring system. Changing the parameter values in the configuration file requires restarting of the system services. Managing the system services is explained in [UG-SS].

• To change the parameter values for the server component op-monitor, the service xroad-opmonitor must be restarted after changing all parameters except op-monitor.tls-certificate.

• The service xroad-proxy must be restarted after changing the parameters:

  • op-monitor.host

  • op-monitor.port

  • op-monitor.scheme

  • op-monitor.tls-certificate.

When changing the previous parameter values of an external monitoring daemon server, only the service xroad-opmonitor must be restarted.

• To change the parameter values for the server components op-monitor-buffer and op-monitor-service, the service xroad-proxy must be restarted.

Server Component	Parameter	Default Value	Explanation
op-monitor	clean-interval	0 0 0/12 1/1 * ? *	CRON expression [CRON] defining the interval of deleting any operational data records that are older than op-monitor.keep-records-for-days from the operational monitoring database.
op-monitor	client-tls-certificate	/etc/xroad/ssl/internal.crt	Absolute filename of the TLS certificate (security server internal certificate) used by the HTTP client sending requests to the operational monitoring daemon. Configured in monitoring daemon server in case an external monitoring daemon is used.
op-monitor	health-statistics-period-seconds	600	The period for gathering health statistics about services in seconds.
op-monitor	host	localhost	The host address on which the operational monitoring daemon listens.
op-monitor	keep-records-for-days	7	Number of days to keep operational data records in the operational monitoring database. If a record is older than this value, the record is deleted from the database.
op-monitor	max-records-in-payload	10000	Maximum number of operational data records in the operational data response payload.
op-monitor	port	2080	TCP port on which the operational monitoring daemon listens.
op-monitor	records-available-timestamp-offset-seconds	60	The offset used to calculate the timestamp to which the operational data records are available in seconds. Only records with earlier timestamp than 'currentSeconds - offset' are available.
op-monitor	scheme	http	The URI scheme name of the operational monitoring daemon. Possible values are http and https.
op-monitor	tls-certificate	/etc/xroad/ssl/opmonitor.crt	Absolute filename of the operational monitoring daemon TLS certificate. Configured in security server in case an external monitoring daemon is used.
op-monitor-buffer	connection-timeout-seconds	30	HTTP client connection timeout in seconds.
op-monitor-buffer	max-records-in-message	100	Maximum number of operational data records in a message sent by the operational monitoring buffer to the operational monitoring daemon.
op-monitor-buffer	sending-interval-seconds	5	The interval in seconds at which the operational monitoring buffer (re)tries to send records to the operational monitoring daemon. Normally, the buffer triggers the sending mechanism immediately when it receives a new record. In case of heavy load or sending failures the records are accumulating in the buffer and need periodical attention.
op-monitor-buffer	socket-timeout-seconds	60	The socket timeout (SO_TIMEOUT) of sending operational monitoring records from the operational monitoring buffer to the operational monitoring daemon in seconds.
op-monitor-buffer	size	20000	Maximum size of operational monitoring buffer. In case buffer size < 1, operational monitoring data is not stored and sent to the operational monitoring daemon.
op-monitor-service	connection-timeout-seconds	30	HTTP client connection timeout in seconds.
op-monitor-service	socket-timeout-seconds	60	The socket timeout (SO_TIMEOUT) of sending the operational data request to the operational monitoring daemon in seconds.