Observability

Teabar provides comprehensive observability features to help you monitor environment health, track costs, analyze usage patterns, and debug issues across your ephemeral infrastructure.

Overview

Observability in Teabar covers four key areas:

  1. Metrics - Real-time and historical performance data
  2. Cost Tracking - Resource consumption and billing analysis
  3. Activity Tracking - Audit logs and user activity
  4. Health Monitoring - Environment status and alerts

Key Features

Real-Time Dashboard

The Teabar dashboard provides at-a-glance visibility into:

  • Active environments across all projects
  • Resource utilization (CPU, memory, storage)
  • Cost trends and projections
  • Recent activity and deployments

Metrics Collection

Teabar automatically collects metrics from all environments:

# View current metrics for an environment
teabar metrics show my-env

# Export metrics to JSON
teabar metrics export --format json --output metrics.json

# Stream real-time metrics
teabar metrics stream my-env

Alerting

Configure alerts to notify your team of important events:

# teabar.yaml
alerts:
  - name: high-cost-warning
    condition: daily_cost > 100
    channels:
      - slack:#platform-alerts
      - email:[email protected]
  
  - name: environment-unhealthy
    condition: health_check_failed
    channels:
      - pagerduty:platform-oncall

Quick Links

Integration with External Tools

Teabar integrates with popular observability platforms:

PlatformIntegration TypeFeatures
DatadogNativeMetrics, logs, APM
PrometheusExportMetrics scraping
GrafanaDashboardVisualization
PagerDutyAlertsIncident management
SlackNotificationsReal-time alerts

Example: Datadog Integration

# Configure Datadog integration
teabar config set integrations.datadog.api_key $DD_API_KEY
teabar config set integrations.datadog.site datadoghq.com

# Enable metrics forwarding
teabar config set integrations.datadog.metrics.enabled true

Best Practices

  1. Set up alerts early - Configure cost and health alerts before environments scale
  2. Review metrics weekly - Identify optimization opportunities in resource usage
  3. Use checkpoints - Create snapshots before major changes for easy rollback
  4. Tag environments - Use consistent labels for easier filtering and analysis
  5. Export data regularly - Back up observability data to your own storage

CLI Commands

CommandDescription
teabar metricsView and export environment metrics
teabar logsAccess environment logs
teabar activityView recent activity
teabar checkpointManage environment snapshots
ende