Backend Application Setup
Instrument your backend application to send telemetry data to the Sailfish cloud platform for production observability, AI-activated debugging, and issue detection.
Auto-Installation
If you connected GitHub and received Auto-Installation PRs, the API key, service identifier, and graphql endpoint are already configured for you. Merge the PR and you're done.
Supported Languages
| Language | Package | Status |
|---|---|---|
| JavaScript/TypeScript | @sailfish-ai/sf-veritas | Full Support |
| Python | sf-veritas | Full Support |
| Go | github.com/SailfishAI/sf-veritas-go | Full Support |
| Java | ai.sailfish:sf-veritas | Full Support |
| Ruby | sf-veritas | Full Support |
| C# | SfVeritas | Full Support |
| PHP | sailfish/sf-veritas | Full Support |
Choose Your Language
- JavaScript/TypeScript - Node.js applications
- Python - Django, FastAPI, Flask, and other Python frameworks
- Go - net/http, Gin, Echo, Fiber, and other Go frameworks
- Java - Spring Boot, Jakarta Servlet, JAX-RS, Micronaut, Quarkus, Vert.x, and Dropwizard
- Ruby - Ruby on Rails, Sinatra, and other Rack-compatible frameworks
- C# - ASP.NET Core Minimal API, MVC, and Worker Services
- PHP - Laravel, Symfony, and standalone PHP applications
What Gets Captured
Backend instrumentation automatically captures:
- Console Output: All
console.log,console.info,console.warn,console.errorcalls - Exceptions: Unhandled exceptions with full stack traces
- Function Traces: Execution timing and call hierarchy (for Flamechart)
- Print Statements: Any output to stdout/stderr
Requirements
Before instrumenting your backend:
- Have a Sailfish Enterprise account and API key (get your key)
- Have Node.js 16+ for JavaScript/TypeScript projects
- Have Python 3.8+ for Python projects
- Have Go 1.22+ for Go projects
- Have Java 11+ (17+ recommended) for Java projects
- Have Ruby 2.6+ for Ruby projects
- Have .NET 9.0+ for C# projects
- Have PHP 8.1+ for PHP projects
Quick Verification
After setup, verify instrumentation is working:
- Deploy your application with the Sailfish SDK configured
- Trigger some activity that produces logs
- Open the Sailfish dashboard
- You should see telemetry appearing in your project
Local Development
Looking to set up Sailfish for local development only? See the Desktop App backend setup guide.