How To Debug Teleport

In order to troubleshoot most issues in Teleport you will more than likely have to put the Teleport service into debug mode and make sure that you have access to the logs. 

To put Teleport into debug mode you will want to do one of the following:

Start Teleport in debug more by passing the debug flag at start time

• Pass the --debug (or simply -d) flag at start time after the teleport start command.
  • If the service/container is already running, you will have to restart it in order to get the flag to take effect.

Start Teleport in debug mode by explicitly setting it in the teleport.yaml config file

• Open the teleport.yaml config file and make sure that the following is in place:

teleport:
    log:
       severity: DEBUG

• Once you've confirmed that the proper severity is set, you will have to restart the Teleport service or bounce the application container.

Once you're in debug mode, you can now dump the logs either directly to console or tail the specified log file for further troubleshooting.