Browse Source

Update files for cactus-comments: add the common section "Troubleshooting"

Signed-off-by: Suguru Hirahara <acioustick@noreply.codeberg.org>
pull/4000/head
Suguru Hirahara 1 year ago
parent
commit
89864c6de0
No known key found for this signature in database GPG Key ID: E4F9743DAB4B7B75
2 changed files with 16 additions and 1 deletions
  1. +15
    -0
      docs/configuring-playbook-cactus-comments.md
  2. +1
    -1
      roles/custom/matrix-cactus-comments-client/defaults/main.yml

+ 15
- 0
docs/configuring-playbook-cactus-comments.md View File

@@ -129,3 +129,18 @@ Make sure to replace `example.com` with your base domain before you include the
``` ```


**Note**: if the `matrix_cactus_comments_client_hostname` and `matrix_cactus_comments_client_path_prefix` variables are tweaked, you would need to adjust the URLs of the assets accordingly. **Note**: if the `matrix_cactus_comments_client_hostname` and `matrix_cactus_comments_client_path_prefix` variables are tweaked, you would need to adjust the URLs of the assets accordingly.

## 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-cactus-comments` for the backend appservice or `journalctl -fu matrix-cactus-comments-client` for the server serving the client assets, respectively.

### Increase logging verbosity

It is possible to increase logging verbosity for `matrix-cactus-comments-client`. The default logging level for this component is `error`. If you want to increase the verbosity, add the following configuration to your `vars.yml` file and re-run the playbook:

```yaml
# Controls the SERVER_LOG_LEVEL environment variable.
# See: https://static-web-server.net/configuration/environment-variables/
# Valid values: error, warn, info, debug, trace
matrix_cactus_comments_client_environment_variable_server_log_level: debug
```

+ 1
- 1
roles/custom/matrix-cactus-comments-client/defaults/main.yml View File

@@ -67,7 +67,7 @@ matrix_cactus_comments_client_environment_variable_server_port: 8080


# Controls the SERVER_LOG_LEVEL environment variable. # Controls the SERVER_LOG_LEVEL environment variable.
# See: https://static-web-server.net/configuration/environment-variables/ # See: https://static-web-server.net/configuration/environment-variables/
# Valid values: error, warn, info, debug or trace
# Valid values: error, warn, info, debug, trace
matrix_cactus_comments_client_environment_variable_server_log_level: error matrix_cactus_comments_client_environment_variable_server_log_level: error


# Controls the SERVER_LOG_REMOTE_ADDRESS environment variable. # Controls the SERVER_LOG_REMOTE_ADDRESS environment variable.


Loading…
Cancel
Save