IML Appmonitor Dashboard

Demo of a custom Dashboard for IML Appmonitor using the API to fetch data. It works offline without a webserver using the Javascript fetch() function.

The Dashboards reads the tags from the IML appmonitor. You can enable/ disable each existing tag. The application section shows the application status of matching apps. The view will be refreshed in the given interval.

Author: Axel Hahn; Institute for Medical Education; University of Bern

📄 Source: https://git-repo.iml.unibe.ch/iml-open-source/appmonitor-dashboard/
📜 License: GNU GPL 3.0

Requirements

• an already running IML Appmonitor instance - https://github.com/iml-it/appmonitor
• Appmonitor API must allow access from your ip address in its config (api -> sourceips)
• Your application checks use tags

Installation

Extract the archive (or use git pull).

We need to setup the url for the api of the IML Appmonitor instance. In public_html/javascript copy the dist file inc_config.js.dist to inc_config.js

Replace values in AM_SERVER_URL and AM_TAGS with your real data:

const AM_SERVER_URL='https://appmonitor.example.com/api';
const AM_TAGS='live,myapp';
const REFRESHTIME=30; // in sec

Open the file public_html/index.html in your webbrowser.

Troubleshooting

• "no response" error
  --> Open the requested api url in the browser. Reasons why does it fail are:

  • the base url in AM_SERVER_URL does not point to the api url
  • your ip address is not whitelisted in the appmonitor api config. The api request with the browser identifies a non configured ip as a JSON message.

• Error 404

  • no application matches the given tag or tag combination. Delete the tags with button [X] and try to start with a single tag.

Screenshot