From 2a7111f287b011da7d88cf2be5462956f8e33f6d Mon Sep 17 00:00:00 2001 From: Suguru Hirahara Date: Sat, 25 Jan 2025 22:24:32 +0900 Subject: [PATCH] Update docs/configuring-playbook-bot-buscarron.md: add the common section "Troubleshooting" See roles/custom/matrix-bot-buscarron/defaults/main.yml at 601406ddda79b1ea4dd50ffe38d65ddada5ee62b for the default log value (INFO). Signed-off-by: Suguru Hirahara --- docs/configuring-playbook-bot-buscarron.md | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/docs/configuring-playbook-bot-buscarron.md b/docs/configuring-playbook-bot-buscarron.md index 691aa2468..f74bf2ea8 100644 --- a/docs/configuring-playbook-bot-buscarron.md +++ b/docs/configuring-playbook-bot-buscarron.md @@ -104,3 +104,15 @@ Here is an example for the `contact` form: If you get banned, you'd need to restart the process by running the playbook with `--tags=start` or running `systemctl restart matrix-bot-buscarron` on the server. You can also refer to the upstream [documentation](https://github.com/etkecc/buscarron). + +## Troubleshooting + +As with all other services, you can find the logs in [systemd-journald](https://www.freedesktop.org/software/systemd/man/systemd-journald.service.html) by logging in to the server with SSH and running `journalctl -fu matrix-bot-buscarron`. + +### Increase logging verbosity + +The default logging level for this component is `INFO`. If you want to increase the verbosity, add the following configuration to your `vars.yml` file and re-run the playbook: + +```yaml +matrix_bot_buscarron_loglevel: DEBUG +```