MyTimetable can be monitored, for example by using monitoring tools such as Nagios. A A status URL is available at /status, and returns an output that looks a Health API is available at /health/. Both will be discussed in more detail below.
/status
The status controller returns a text representation of the MyTimetable status, and is available at the URL https://mytimetable_instance/status. The output looks something like:
| Code Block | ||||
|---|---|---|---|---|
| ||||
MyTimetable WARNING > DS_2013sm1: OK - Last update: 2013-12-19 04:14:56.55 DS_2013sm2: WARNING - Last update: 2013-12-17 03:27:45.462015A: DataSource 'DS_2015A' (WARNING) --------------------- --------------------------------------------------------- ------------------------------ ------- id description value status --------------------- --------------------------------------------------------- ------------------------------ ------- alive Aliveness of the DataSource OK OK last_update Timestamp of the last update of the DataSource Sat, 7 Nov 2015 14:43:15 +0100 WARNING last_update_since_sec Number of seconds since the last update of the DataSource 5949789 WARNING > ec_consumer: External Calendaring Consumer (OK) ---------------------------- ------------------------------------------------------------------------------ ------ ------ id description value status ---------------------------- ------------------------------------------------------------------------------ ------ ------ alive Aliveness of the application OK OK ews_FAILED_PERMANENTLY Number of synchronizations of type 'ews' with status 'FAILED_PERMANENTLY' 0 OK ews_FAILED_PERMANENTLY_perc Percentage of synchronizations of type 'ews' with status 'FAILED_PERMANENTLY' 0,00 OK ews_FAILED_TEMPORARILY Number of synchronizations of type 'ews' with status 'FAILED_TEMPORARILY' 0 OK ews_FAILED_TEMPORARILY_perc Percentage of synchronizations of type 'ews' with status 'FAILED_TEMPORARILY' 0,00 OK ews_OK Number of synchronizations of type 'ews' with status 'OK' 274 OK ews_OK_perc Percentage of synchronizations of type 'ews' with status 'OK' 100,00 OK > ec_producer: External Calendaring Producer (OK) ----- ---------------------------- ----- ------ id description value status ----- ---------------------------- ----- ------ alive Aliveness of the application OK OK |
There are four possible return states:
- 'MyTimetable OK' followed by last update times for all data sources, if all data sources have been updated in the last 36 hours and all components work as expected.
- 'MyTimetable WARNING' followed by last update times for all data sources, if one or more data sources have not been updated within the last 36 hours. (In Scientia Syllabus Plus Enterprise Reporting Database 3.2.0, the last update time is not present. MyTimetable will always return WARNING in older MyTimetable versions, and always return OK in MyTimetable 2.4+)
- 'MyTimetable ERROR' + exception message, if MyTimetable can not connect to one or more data sources, or if something else went wrong. This will also set the HTTP status to '503 Service Unavailable'.
- HTTP '404 Not Found status', if the application did not load correctly.
Please note that the exact text format will be different and less extensive for pre-3.0 MyTimetable instances.