# Ensure correct Python environment
which python
pip show brokle

# Reinstall
pip uninstall brokle
pip install brokle

# Check virtual environment
source venv/bin/activate  # or your venv path

from brokle import AsyncBrokle

brokle = AsyncBrokle()

async def main():
    async with brokle.start_as_current_span("operation"):
        await some_async_function()

# Reduce batch size
brokle = Brokle(
    flush_at=20,        # Smaller batch size
    flush_interval=2.0  # More frequent flushes
)

# Limit trace size
with brokle.start_as_current_span("operation") as span:
    # Truncate large outputs
    span.update(output=large_output[:10000])

# These are required for server mode
echo $JWT_SECRET              # Must be set
echo $AI_KEY_ENCRYPTION_KEY   # Must be set
echo $DATABASE_URL            # Must be valid
echo $CLICKHOUSE_URL          # Must be valid
echo $REDIS_URL               # Must be valid

# Docker
docker logs brokle-server

# Docker Compose
docker compose logs server

# Test connection
psql $DATABASE_URL -c "SELECT 1"

# Common fixes:
# - Check if PostgreSQL is running
# - Verify credentials
# - Check network/firewall
# - Ensure database exists

# Test connection
curl "http://localhost:8123/?query=SELECT%201"

# Check ClickHouse is running
docker ps | grep clickhouse

# Test connection
redis-cli -u $REDIS_URL ping

# Should return: PONG

# Check migration status
./brokle migrate status

# Force reset (CAUTION: for dev only)
./brokle migrate drop
./brokle migrate up

# The migration may have partially run
# Check the migration version
./brokle migrate status

# Force the version if needed
./brokle migrate force <version>

# Limit ClickHouse memory in docker-compose.yml
clickhouse:
  deploy:
    resources:
      limits:
        memory: 4G

# Check what's using memory
docker stats

# Reduce worker concurrency
WORKER_CONCURRENCY=5
WORKER_BATCH_SIZE=50

-- PostgreSQL
SELECT * FROM pg_stat_statements
ORDER BY total_time DESC
LIMIT 10;

-- ClickHouse
SELECT * FROM system.query_log
WHERE type = 'QueryFinish'
ORDER BY query_duration_ms DESC
LIMIT 10;

# Check API key format
# Should be: bk_<40 characters>

# Correct header format
curl -H "Authorization: Bearer bk_..." \
     https://api.brokle.dev/v1/traces

# Or use X-API-Key header
curl -H "X-API-Key: bk_..." \
     https://api.brokle.dev/v1/traces

# Implement exponential backoff
import time

def with_retry(func, max_retries=3):
    for i in range(max_retries):
        try:
            return func()
        except RateLimitError:
            time.sleep(2 ** i)
    raise Exception("Max retries exceeded")

# Or reduce request rate
brokle = Brokle(
    flush_at=50,         # Smaller batches
    flush_interval=5.0   # Less frequent
)

# Check server logs
docker logs brokle-server 2>&1 | tail -100

# Common causes:
# - Database connection issues
# - Out of memory
# - Disk space full

# Ensure correct CORS settings
CORS_ALLOWED_ORIGINS=https://your-dashboard-url.com

# Use async for better performance
brokle = Brokle(
    flush_at=100,       # Batch more traces
    flush_interval=5.0  # Less frequent flushes
)

# Test latency to Brokle API
ping api.brokle.dev

# Use self-hosted for lower latency
# if you're in a region far from Brokle Cloud

# Scale workers
docker compose up -d --scale worker=3

# Or increase concurrency
WORKER_CONCURRENCY=20
WORKER_BATCH_SIZE=200