Adding upstream version 1.44.3.upstream/1.44.3upstream

Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>

1 files changed, 39 insertions, 0 deletions

diff --git a/health/guides/vernemq/vernemq_mqtt_unsubscribe_error.md b/health/guides/vernemq/vernemq_mqtt_unsubscribe_error.md
new file mode 100644
index 00000000..55feb0a1
--- /dev/null
+++ b/health/guides/vernemq/vernemq_mqtt_unsubscribe_error.md
@@ -0,0 +1,39 @@
+### Understand the alert
+
+This alert monitors the number of failed v3/v5 `UNSUBSCRIBE` operations in VerneMQ in the last minute. If you receive this alert, it means that there is a significant number of failed `UNSUBSCRIBE` operations, which may impact the MQTT messaging on your system.
+
+### What is VerneMQ?
+
+VerneMQ is a high-performance, distributed MQTT message broker. It provides scalable and reliable communication for Internet of Things (IoT) systems and applications.
+
+### What is an MQTT UNSUBSCRIBE operation?
+
+An `UNSUBSCRIBE` operation in MQTT protocol is a request sent by a client to the server to remove one or more topics from the subscription list. It allows clients to stop receiving messages for particular topics.
+
+### Troubleshoot the alert
+
+1. Check VerneMQ logs for any error messages or indications of issues with the `UNSUBSCRIBE` operation:
+
+   ```
+   sudo journalctl -u vernemq
+   ```
+
+   Alternatively, you may find the logs in `/var/log/vernemq/` directory, if using the default configuration:
+
+   ```
+   cat /var/log/vernemq/console.log
+   cat /var/log/vernemq/error.log
+   ```
+
+2. Review the VerneMQ configuration to ensure it is properly set up. The default configuration file is located at `/etc/vernemq/vernemq.conf`. Make sure that the settings are correct, especially those related to the MQTT protocol version and the supported QoS levels.
+
+3. Monitor the VerneMQ metrics using the `vmq-admin metrics show` command. This will provide you with an overview of the broker's performance and help you identify any abnormal metrics that could be related to the failed `UNSUBSCRIBE` operations:
+
+   ```
+   sudo vmq-admin metrics show
+   ```
+
+   Pay attention to the `mqtt.unsubscribe_error` metric, which indicates the number of failed `UNSUBSCRIBE` operations.
+
+4. Check the MQTT clients that are sending the `UNSUBSCRIBE` requests. It is possible that the client itself is misconfigured or has some faulty logic in its communication with the MQTT broker. Review the client's logs and configuration to identify any issues.
+