Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Sending Your First Error Report

You have a project. Now connect your app so Telebugs can start catching errors automatically.

Telebugs uses compatible Sentry SDKs. This means you follow the official Sentry integration guide for your platform, but point it at your Telebugs DSN.

Find Your Setup Instructions

Open your project in the dashboard. If no errors have arrived yet, Telebugs shows tailored SDK instructions right there. They include your exact DSN and link to the official Sentry docs for the platform you selected.

The DSN is the unique URL that routes errors to this project. It looks like:

https://[email protected]/123

Copy it carefully.

Install the SDK

Add the Sentry SDK to your app. The process is the same as for Sentry itself.

Example for Ruby on Rails:

  1. Add to your Gemfile:

    gem "sentry-rails"
    
  2. Run:

    bundle install
    
  3. Initialize it (usually in config/initializers/sentry.rb):

    Sentry.init do |config|
      config.dsn = "https://[email protected]/123"
    end
    
  4. Restart your app.

For JavaScript, Python, PHP, Go, etc., follow the official Sentry guide for your platform. Just replace the DSN with yours from Telebugs.

Test the Connection

Trigger a test error in your code. Examples:

  • Ruby: raise "Test error from Telebugs"
  • JavaScript: Sentry.captureException(new Error("Test"))

The error should appear in your Telebugs project within seconds.

If nothing shows up:

  • Double-check the DSN (copy-paste again).
  • Make sure the SDK initializes early in your app lifecycle.
  • Restart or redeploy the app.
  • Confirm your server can reach the internet (no firewall block).

Feature Notes

Telebugs focuses on core error tracking. It works perfectly with:

  • Error reports
  • Breadcrumbs
  • Contexts
  • Tags
  • User information

Advanced Sentry features (Performance Tracing, Session Replay, Profiling) are not supported. Disable them in your SDK config if they are on by default (e.g., set traces_sample_rate = 0.0).

That is it! Your app is now reporting to Telebugs.