CLI Tool

telemetry-kit init

$ telemetry-kit init
 
🔭 Telemetry Kit - Interactive Setup
 
Service name: my-app
 
Configure sync to telemetry-kit.dev? yes
 
Sync Configuration
 
Organization ID: acme-corp
Application ID: my-app
Auth Token: tk_abc123...
HMAC Secret: ********
 
Testing credentials...
✓ Credentials validated successfully!

telemetry-kit test

telemetry-kit stats

📊 Event Statistics

Service: my-app
Database: /Users/you/.telemetry-kit/my-app.db

Events:
  Total:      42
  Synced:     30
  Unsynced:   12

Sync rate: 71%

💡 You have 12 unsynced events
   Run telemetry-kit sync to sync now

telemetry-kit sync

telemetry-kit validate

✓ Validating Configuration

Service: my-app
✓ Database found: /Users/you/.telemetry-kit/my-app.db
✓ Telemetry initialization successful

✓ Configuration valid

telemetry-kit clean

$ telemetry-kit clean
 
🧹 Clean Local Events
 
Service: my-app
Current: 42 events (12 unsynced)
 
⚠️  You have 12 unsynced events that will be lost!
 
Are you sure you want to delete all local events? no
 
Cancelled

# View stats for different services
telemetry-kit stats --service frontend
telemetry-kit stats --service backend
telemetry-kit stats --service worker
 
# Validate all services
for service in frontend backend worker; do
  echo "Validating $service..."
  telemetry-kit validate --service "$service"
done
 
# Clean specific service
telemetry-kit clean --service old-service --yes

✓ Initialization complete!

Next steps:
  • telemetry-kit stats - View statistics
  • telemetry-kit test - Test sync
  • telemetry-kit validate - Validate config

~/.telemetry-kit/<service-name>.db

# Make sure you've initialized telemetry in your app
telemetry-kit init
 
# Check the database path
ls ~/.telemetry-kit/

# Validate your configuration
telemetry-kit validate
 
# Check for database corruption
rm ~/.telemetry-kit/my-app.db
# Re-run your app

# Double-check your credentials
telemetry-kit test
 
# Verify network connectivity
ping telemetry-kit.dev

#!/bin/bash
set -e
 
# Initialize telemetry with defaults
telemetry-kit init --yes --service-name my-app
 
# Validate setup
telemetry-kit validate
 
echo "✓ Telemetry setup complete!"

# .github/workflows/telemetry.yml
name: Telemetry Stats
 
on:
  push:
    branches: [main]
 
jobs:
  stats:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: dtolnay/rust-toolchain@stable
 
      - name: Install CLI
        run: cargo install telemetry-kit --features cli
 
      - name: View stats
        run: telemetry-kit stats --service my-app

#!/bin/bash
# monitor-telemetry.sh
 
while true; do
  clear
  telemetry-kit stats --detailed
  sleep 10
done