Skip to main content

Debug Tools

TGO includes built-in debug tools to help you troubleshoot issues and monitor system status.

Built-in Debug Tools​

TGO provides the following debug tool containers:

ToolPurposeAccess URL
Kafka UIKafka message queue management interfacehttp://localhost:8080
AdminerDatabase management interfacehttp://localhost:8081

Start Debug Tools​

./tgo.sh tools start

Stop Debug Tools​

./tgo.sh tools stop

Kafka UI​

Kafka UI is a web interface for managing and monitoring Kafka clusters.

Features​

  • View topic list
  • Browse message content
  • Monitor consumer groups
  • View cluster status

Use Cases​

  • Debug message send/receive issues
  • Verify message content
  • Monitor consumer lag

Access​

After starting tools, visit: http://<server-ip>:8080

Adminer​

Adminer is a lightweight database management tool.

Features​

  • Browse database table structure
  • Execute SQL queries
  • Import/export data
  • Edit table data

Connection Info​

ParameterValue
SystemPostgreSQL
Serverpostgres
Usernametgo (or check POSTGRES_USER in .env)
Passwordtgo (or check POSTGRES_PASSWORD in .env)
Databasetgo (or check POSTGRES_DB in .env)

Access​

After starting tools, visit: http://<server-ip>:8081

View Logs​

View All Service Logs​

docker compose logs -f

View Specific Service Logs​

docker compose logs -f tgo-api
docker compose logs -f tgo-ai
docker compose logs -f tgo-rag

View Last N Lines​

docker compose logs --tail=100 tgo-api

Container Debugging​

Enter Container​

docker compose exec tgo-api bash
docker compose exec tgo-ai bash

Check Container Status​

docker compose ps

Check Resource Usage​

docker stats

Health Check​

Use the doctor command for comprehensive health check:

./tgo.sh doctor

This command checks:

  • All service running status
  • Database connection
  • Nginx configuration
  • Data directories
  • API endpoint response

Security Notes​

Note

Debug tools are only for development and debugging environments. In production:

  1. Don't expose debug tool ports to the public internet
  2. Stop tools when done: ./tgo.sh tools stop
  3. Change default database passwords