Documentation

Monitoring & Logs

Monitor your bot's health, track usage, and debug with real-time logs.


BotPhi provides built-in monitoring for every deployed bot. Track message volume, latency, errors, and token usage — all from the dashboard or the API.

Dashboard Metrics

  • Messages per hour/day/week — total message volume over time
  • Average latency — time from message received to response sent
  • Error rate — percentage of messages that resulted in errors
  • Token usage — total tokens consumed, broken down by input/output
  • Active sessions — unique users currently chatting with the bot

Real-Time Logs

Stream live logs from any deployed bot:

# Stream logs in real-time
botphi logs support-bot --follow

# Filter by severity
botphi logs support-bot --level error

# Search logs
botphi logs support-bot --search "timeout"

Alerts

Configure alerts to get notified when your bot hits specific thresholds:

alert-config.json
{
  "alerts": [
    {
      "metric": "error_rate",
      "threshold": 5,
      "unit": "percent",
      "window": "5m",
      "notify": ["slack:#bot-alerts", "email:team@acme.com"]
    },
    {
      "metric": "latency_p99",
      "threshold": 3000,
      "unit": "ms",
      "window": "10m",
      "notify": ["slack:#bot-alerts"]
    }
  ]
}

Alert notifications are available via Slack, email, and webhooks. PagerDuty integration coming soon.