diff options
author | Daniel Baumann <daniel.baumann@progress-linux.org> | 2024-05-05 12:08:03 +0000 |
---|---|---|
committer | Daniel Baumann <daniel.baumann@progress-linux.org> | 2024-05-05 12:08:18 +0000 |
commit | 5da14042f70711ea5cf66e034699730335462f66 (patch) | |
tree | 0f6354ccac934ed87a2d555f45be4c831cf92f4a /health/guides/vernemq/vernemq_mqtt_subscribe_error.md | |
parent | Releasing debian version 1.44.3-2. (diff) | |
download | netdata-5da14042f70711ea5cf66e034699730335462f66.tar.xz netdata-5da14042f70711ea5cf66e034699730335462f66.zip |
Merging upstream version 1.45.3+dfsg.
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to 'health/guides/vernemq/vernemq_mqtt_subscribe_error.md')
-rw-r--r-- | health/guides/vernemq/vernemq_mqtt_subscribe_error.md | 58 |
1 files changed, 0 insertions, 58 deletions
diff --git a/health/guides/vernemq/vernemq_mqtt_subscribe_error.md b/health/guides/vernemq/vernemq_mqtt_subscribe_error.md deleted file mode 100644 index f14d18d55..000000000 --- a/health/guides/vernemq/vernemq_mqtt_subscribe_error.md +++ /dev/null @@ -1,58 +0,0 @@ -### Understand the alert - -This alert is related to `VerneMQ`, the open-source, distributed MQTT message broker. If you receive this alert, it means that the number of failed v3/v5 `SUBSCRIBE` operations has increased in the last minute. - -### What do v3 and v5 SUBSCRIBE operations mean? - -MQTT v3 and v5 are different versions of the MQTT protocol, used for the Internet of Things (IoT) devices and their communication. The `SUBSCRIBE` operation allows a client (device) to subscribe to a specific topic and receive messages published under that topic. - -### Troubleshoot the alert - -- Check the VerneMQ logs - -1. Identify the location of the VerneMQ logs. The default location is `/var/log/vernemq`. If you have changed the default location, you can find it in the `vernemq.conf` file by looking for `log.console.file` and `log.error.file`. - - ``` - grep log.console.file /etc/vernemq/vernemq.conf - grep log.error.file /etc/vernemq/vernemq.conf - ``` - -2. Analyze the logs for any errors or issues related to the `SUBSCRIBE` operation: - - ``` - tail -f /path/to/vernemq/logs - ``` - -- Check the system resources - -1. Check the available resources (RAM and CPU) on your system: - - ``` - top - ``` - -2. If you find that the system resources are low, consider adding more resources or stopping unnecessary processes/applications. - -- Check the client-side logs - -1. Most MQTT clients (e.g., Mosquitto, Paho, MQTT.js) provide their logs to help you identify any issues related to the `SUBSCRIBE` operation. - -2. Analyze the client logs for errors in connecting, subscribing, or receiving messages from the MQTT broker. - -- Analyze the topics and subscriptions - -1. Verify if there are any invalid, restricted, or forbidden topics in your MQTT broker. - -2. Check the ACLs (Access Control Lists) and client authentication settings in your VerneMQ `vernemq.conf` file. - - ``` - grep -E '^(allow_anonymous|vmq_acl.acl_file|vmq_passwd.password_file)' /etc/vernemq/vernemq.conf - ``` - -3. Ensure the `ACLs` and authentication configuration are correct and allow the clients to subscribe to the required topics. - -### Useful resources - -1. [VerneMQ Administration](https://vernemq.com/docs/administration/) -2. [VerneMQ Configuration](https://vernemq.com/docs/configuration/) -3. [VerneMQ Logging](https://vernemq.com/docs/guide/internals.html#logging)
\ No newline at end of file |