Troubleshooting

Troubleshooting

If you have problems running Kadeck Teams, log output is very important for quick support.
If possible, the problem should be recreated with the log level "DEBUG" and then the log output should be sent to Kadeck Support.

Most of our customers use a central log management system, so accessing log files is no longer necessary. If access to the actual log files is still necessary, you will also find the location of the log files in this article.

Logs

In general, the log file can be found in the current user's home directory.
Before sending or looking at the file, it might be useful to change the log level to DEBUG (default is WARN) to capture the maximum amount of information possible to aide the debugging process.

Log levels

  1. ERROR
    1. Designates error events that might still allow the application to continue running.
  2. WARN
    1. Designates potentially harmful situations.
  3. INFO
    1. Designates informational messages that highlight the progress of the application at coarse-grained level.
  4. DEBUG
    1. Designates fine-grained informational events that are most useful to debug an application.

Configure log level

Configure the log level by setting the xeotek_kadeck_loglevel environment variable to the respective log level, e.g. on Docker:
  1. docker run -p 80:80 -e xeotek_kadeck_loglevel="DEBUG"  \
  2. -e NODATA=true xeotek/kadeck-allinone:latest
The log file can be found inside the container at this location:
  1. /root/.kadeck_log

Database
The location of the database (if an external database is not provided) is inside the container in the root folder.
Docker
  1. /root/.kadeck/kadeckweb.mv.db

    • Related Articles

    • Log File & Troubleshooting Help

      Logs In general, the log file can be found in the current user's home directory. Log file location Windows C:\Users\{user.name}\.kadeck_log MacOS /Users/{user.name}/.kadeck_log Linux /home/{user.name}/.kadeck_log Could not start Kadeck backend ...

    • Mounting a keytab file

      If you need to specify a keytab file when running Kadeck on your local machine to connect to your Apache Kafka cluster, you need to create a volume containing the keytab of your certificate and mount it to your Docker container. Mounting the keytab ...

    • Release 4.2.9

      This article describes the changes of the version 4.2.x update. Note: We have released a 4.2.9 hotfix that solves a performance problem in connection with the schema registry, which led to an extremely long connection process or missing schemas for ...

    • Configure LDAP Basic module

      Active Directory (AD) and OpenLDAP are supported to authenticate users. LDAP is only available to specific licenses. LDAP is configured via Startup Parameters with the prefix xeotek_kadeck_authentication_ldap. To enable LDAP, the ...

    • Release 5.X

      This article describes the changes of the version 5.x update. Latest image tag: xeotek/kadeck:5.3.0 Release 5.3 We're excited to announce the release of Kadeck 5.3.0, bringing essential updates to our platform: Auth/OpenID Authentication Integration: ...