enterprise


Fully qualified class name: org.signserver.module.timemonitormanager.TimeMonitorManager.

Overview

Similar to the StatusPropertiesWorker, the TimeMonitorManager also supports setting status properties in the status repository. Additionally, the TimeMonitorManager supports dynamic configuration of the TimeMonitor and also gives a complete view of the state of the TimeMonitor.

Worker Properties

All worker properties starting with either TIMEMONITOR. or TIMESERVER. are sent to the TimeMonitor if it asks for it. For information on available properties, see TimeMonitor Configuration.

Request Properties

Property

Description

x.EXPIRATION

Sets the expiration time for x, where x is a status property. x.VALUE must also be specified

If no property is specified, all valid status properties are returned.

x.VALUE

Sets the value of the property, where x is a status property.

Response Properties

Property

Description

x.UPDATE

Specifies the time when the property was written.

Status output

Detailed information about the state of the TimeMonitor is available in the getstatus output of the TimeMonitorManager:

Output Item

Description

Time monitor

Indicates if the application is detected to be Running, Disabled, Not running?, or Unavailabe. The state is determined by if the manager has seen an update from the TimeMonitor before the status properties are starting to expire.

Last update

Prints the last time the TimeMonitor contacted the manager.

Current time

Prints the current time of the server.

Time state

Prints the last time state from the TimeMonitor.

Report state

Prints the last report state from the TimeMonitor.

Leap state

Prints the last leap state from the TimeMonitor.

Configuration

Specifies either out of sync or up to date, depending on if the current configuration has been read by the TimeMonitor or not. After changing a property in the TimeMonitorManager, it is normal that the configuration is marked as out of sync until the TimeMonitor fetches it.

Status properties values

Prints the current value and possibly the expiration time for the TIMESOURCE0_INSYNC and LEAPSECOND status properties.

Timings

Prints the current time values from the TimeMonitor.

Configuration

Prints the configuration values in the manager (not necessarily read by the TimeMonitor yet).

Last TimeMonitor log entries

Prints the last log entries obtained from the last update from the TimeMonitor.

Sample Output

The following displays an example status output:

Status of Worker with ID 300 (TimeMonitorManager) is:
Worker status : Active
Time monitor : Running
Last update : 2017-08-26 11:43:39,176
Current time : 2017-08-26 11:43:39,580
Time state : INSYNC
Report state : REPORTED
Leap state : NONE
Configuration : Up to date
Status Repository values:
TIMESOURCE0_INSYNC: true
LEAPSECOND: NONE
Timings:
NTP server time offset: 0 ms
NTP server query time: 507 ms
NTP leap status query time: 8 ms
Report time: 7 ms
Total required run time: 522 ms
Configuration:
NTP server hosts: 192.168.30.25
NTP query samples: 2
NTP query timeout: 200 ms
Max accepted offset: 997 ms
Warn offset: 500 ms
Status expire time: 900 ms
Leap status expire time: 60000 ms
Warn run time: 800 ms
Minimum run time: 550 ms
Last TimeMonitor log entries:
2014-08-26 11:36:29,253 INFO Started
2014-08-26 11:36:29,287 INFO State changed to: UNKNOWN,REPORTED,UNKNOWN
2014-08-26 11:36:44,255 INFO Config changed to: 1ccdf46b
2014-08-26 11:36:44,782 INFO Time back in calibration: offset abs(0) max accepted offset 997
2014-08-26 11:36:44,793 INFO State changed to: INSYNC,REPORTED,NONE