Skip to content
Kopai Dashboard

Troubleshooting

Troubleshooting

Section titled “Troubleshooting”

Solutions for common issues when using Kopai.

Connection Issues

Section titled “Connection Issues”

”Connection refused” or timeout errors

Section titled “”Connection refused” or timeout errors”
  1. Verify your endpoint URL is correct
  2. Check your network allows outbound HTTPS connections
  3. Ensure your token is valid and not expired

”Unauthorized” (401) errors

Section titled “”Unauthorized” (401) errors”
  1. Verify your API token is correct
  2. Check the token hasn’t been revoked
  3. Ensure the Authorization header format is correct: Bearer YOUR_TOKEN

Data Not Appearing

Section titled “Data Not Appearing”

Traces not showing in dashboard

Section titled “Traces not showing in dashboard”
  1. Verify your SDK is configured correctly
  2. Check the service name is set via OTEL_SERVICE_NAME
  3. Allow a few seconds for data to appear
  4. Check your SDK logs for export errors

Logs missing

Section titled “Logs missing”
  1. Ensure log export is enabled in your SDK
  2. Verify log level meets minimum threshold
  3. Check for SDK-side batching delays

Performance Issues

Section titled “Performance Issues”

High latency when exporting

Section titled “High latency when exporting”
  1. Enable batching in your SDK configuration
  2. Consider using gRPC instead of HTTP
  3. Check your network connection quality

Getting Help

Section titled “Getting Help”

If you’re still experiencing issues: