Monitor API (Beta)ΒΆ

Since v1.9, Sentilo offers an internal Monitor API that enables direct access to select real-time information of the API server and other components. With this internal API you can also remotely restart API server, for example in case the main API is too busy.

The Monitor API runs on a different port then public API. The default port number is 7081 and is configured in /sentilo/sentilo-platform/sentilo-platform-service/src/main/resources/properties/sentilo-platform.conf by property sentilo.server.monitor.socket.port:

sentilo.server.monitor.socket.port=7081

This API currently works with the Catalog Application token. You can find the catalog token in the Application section of the Catalog.

Note

The catalog application token is very sensitive information, since it is used for admin operations. Make sure you do store it in a private repository. Also make sure calls to the monitoring API are encrypted. See more in the Security section

List of API resources in the monitoring API:

Resource Method Description
/monitor/ping GET Simple service that responds with http code 200 if the server is up and running.
/monitor/rl_input_status GET Returns values of global rate limiting (incoming requests), for the last hour.
/monitor/metrics GET Returns a list of components with their metrics
/monitor/restart POST Gracefully restarts the API server. No body needed.
/monitor/force-restart POST Forces a restart of the API server. No body needed.