From 3a40a44e7d0ed69a5fd1270c58efc08f959b72d2 Mon Sep 17 00:00:00 2001 From: Albin Suresh Date: Wed, 30 Mar 2022 10:14:08 +0530 Subject: Document tedge MQTT health endpoints --- docs/src/howto-guides/020_monitor_tedge_health | 31 ++++++++++++++++++++++++++ 1 file changed, 31 insertions(+) create mode 100644 docs/src/howto-guides/020_monitor_tedge_health (limited to 'docs') diff --git a/docs/src/howto-guides/020_monitor_tedge_health b/docs/src/howto-guides/020_monitor_tedge_health new file mode 100644 index 00000000..dc886aec --- /dev/null +++ b/docs/src/howto-guides/020_monitor_tedge_health @@ -0,0 +1,31 @@ +# How to monitor health of tedge daemons + +The health of tedge daemon processes like `tedge-mapper`, `tedge-agent` etc can be monitored via MQTT. +These daemons expose MQTT health endpoints which you can query to check if the process is still active or not. + +The health endpoints conform to the following topic scheme, listening for health check requests: + +`tedge/health-check/` + +expecting empty messages, triggering the health check. + +The daemon will then respond back on the topic: + +`tedge/health/` + +with the following payload: + +```json +{ "status": "up" } +``` + +## Supported MQTT topic endpoints + +The following endpoints are currently supported by various tedge daemons: + +* `tedge/health/tedge-agent` +* `tedge/health/tedge-mapper-c8y` +* `tedge/health/tedge-mapper-az` +* `tedge/health/tedge-mapper-collectd` + +All future tedge daemons will also follow the same topic naming scheme convention. -- cgit v1.2.3