(Error-) logs

(Error-)Logs

---

In a fully installed EGroupware system with add-ons such as Collabora Online, Rocket.Chat or Guacamole, several error logs are written. These are located in different places and can be accessed in different ways.

The logs are usually accessible from the host! Docker knowledge is basically not necessary.

The logs accessible via Docker can also be read easily with Dockly:
https://help.egroupware.org/t/docker-tools/74121

EGroupware

The error log of the executing web server (in the egroupware-nginx container) can be accessed in various ways.

1. Use the script
   /etc/egroupware-docker/egroupware-logs.sh
   on the host.

2. Enter the container and read the log “manually”

3. install Docker tools such as Dockly and use it to open the log.

“Many” messages are initially insignificant for operation. Messages that coincide with a problem should be considered here.

Database (MariaDB)

docker logs egroupware-db

Continuous, to read current events:
docker logs -f egroupware-db

Cancel with Ctrl-C

Collabora Online

docker logs collabora-key

Ongoing, to read current events:
docker logs -f collabora-key

Cancel with Ctrl-C

Rocket.Chat

docker logs rocketchat

Ongoing, to read current events:
docker logs -f rocketchat

Cancel with Ctrl-C

Watchtower

docker logs egroupware-watchtower

Continuous, to read current events:
docker logs -f egroupware-watchtower

Cancel with Ctrl-C

Guacamole

Guacamole consists of two containers:

• guacamole
• guacamole-guacd

guacamole is the web frontend, guacd is the RDP/VNC/SSH client. Accordingly, problems with accessing the web interface must be looked at in guacamole and problems with the RDP/VNC/SSH client in guacd.

The logs are called up on the host with

docker logs guacamole

docker logs guacamole.guacd

Cancel with STRG-C

Push-Server

docker logs egroupware-push

Continuous, to read current events:
docker logs -f egroupware-push

Cancel with STRG-C

Mail (EGw client <=> mail server)

SMTP:
Logging must be switched on in the code:

EGroupware/egroupware/blob/master/api/src/Mail/Account.php#L200

Edit the line: const SMTP_DEBUG_LOG = ‘/var/lib/egroupware/smtp.log’;

docker exec -it egroupware bash
apt update && apt install -y vim
vim /usr/share/egroupware/api/src/Mail/Account.php
kill -s USR2 1
exit
tail -F /var/lib/egroupware/smtp.log

After restarting the container (docker restart egroupware), logging is switched off again.

---

For questions, suggestions etc. please create a separate topic in the forum and refer to this article.