Documentazione
OpenErrorAPI parla il protocollo Sentry, quindi mantieni l'SDK ufficiale che già usi e cambi una riga: il DSN. Questa pagina spiega come, e — altrettanto importante — cosa non supportiamo.
Migra da Sentry in 10 minuti
Non devi sostituire SDK né riscrivere codice. Punti l'SDK che già usi a un DSN diverso.
-
1
Crea un progetto nella console. Ottieni un DSN nella forma https://PUBLIC_KEY@openerrorapi.com/PROJECT_ID.
-
2
Sostituisci il DSN nel tuo Sentry.init() esistente — di solito una variabile d'ambiente. Mantieni l'SDK, la versione e ogni opzione già configurata.
-
3
Fai deploy e genera un errore. Appare nella console in un secondo, raggruppato come lo era in Sentry.
PHP
composer require sentry/sentry\Sentry\init(['dsn' => 'https://PUBLIC_KEY@openerrorapi.com/PROJECT_ID']);JavaScript / TypeScript
npm i @sentry/browserSentry.init({ dsn: 'https://PUBLIC_KEY@openerrorapi.com/PROJECT_ID' });Node.js
npm i @sentry/nodeSentry.init({ dsn: 'https://PUBLIC_KEY@openerrorapi.com/PROJECT_ID' });Python
pip install sentry-sdksentry_sdk.init(dsn="https://PUBLIC_KEY@openerrorapi.com/PROJECT_ID")Go
go get github.com/getsentry/sentry-gosentry.Init(sentry.ClientOptions{Dsn: "https://PUBLIC_KEY@openerrorapi.com/PROJECT_ID"})Dart / Flutter
flutter pub add sentry_flutterawait SentryFlutter.init((o) => o.dsn = 'https://PUBLIC_KEY@openerrorapi.com/PROJECT_ID');Stai già caricando source map con sentry-cli? Mantieni anche quel passaggio — imposta SENTRY_URL a https://openerrorapi.com e usa un token di upload come SENTRY_AUTH_TOKEN.
Compatibilità Sentry, senza illusioni
La compatibilità è l'intera promessa, il che la rende la cosa più pericolosa da sopravvalutare. Questa tabella è generata dalla stessa fonte che usa il codice e la nostra documentazione machine-readable, quindi non può discostarsi dalla realtà senza che ce ne accorgiamo.
7 aree completamente supportate · 3 parziali · 3 non supportate.
| Area | Stato | Dettaglio |
|---|---|---|
Envelope ingest (/api/{id}/envelope/) |
Supportato | The modern endpoint every current SDK uses. Gzip/deflate bodies, multiple items per envelope, all three auth methods (X-Sentry-Auth header, querystring, envelope dsn header). |
Store ingest (/api/{id}/store/) |
Supportato | Legacy endpoint for older SDKs. Same processing pipeline as envelopes. |
| Error events & grouping | Supportato | Exceptions, messages, stack traces, tags, user, contexts, breadcrumbs, request. Grouping by fingerprint with an explicit `fingerprint[]` override. |
| Sessions / release health | Supportato | Session envelope items are processed; crash-free sessions and users are shown per release. Available from the Team plan. |
| Security reports (CSP) | Supportato | CSP violation reports are stored and grouped like any other issue. Point report-uri at /api/{project_id}/security/?sentry_key={PUBLIC_KEY} — the browser cannot send headers, so the key goes in the URL. Both the classic csp-report body and the Reporting API array are accepted. |
| Source maps | Supportato | Upload via our API, from the console, or with sentry-cli. Frames are de-minified on read, so uploading a map fixes old events too. |
sentry-cli |
Parziale | Releases (new / finalize / set-commits) and source-map upload work unchanged. Chunked upload is not implemented — sentry-cli detects that and falls back to the regular upload automatically. |
| User feedback widget | Supportato | Embeddable widget; reports land next to the errors they belong to. |
| Transactions / performance | Parziale | Transaction envelope items are accepted so SDKs do not error, but we do not build a performance product on top of them. If you need distributed tracing, keep Sentry — we are an error tracker. |
Logs (log envelope items) |
Non supportato | Not processed yet. Log items are ignored, which does not affect error reporting from the same SDK. |
Cron monitors (check_in items) |
Parziale | We have our own cron/heartbeat monitoring in the console, but the Sentry `check_in` envelope item is not wired to it yet. |
| Profiling, session replay | Non supportato | Deliberately out of scope. These are the reasons to stay on Sentry; we do not pretend otherwise. |
| Native symbolication (dSYM / ProGuard) | Non supportato | Not supported. Native mobile crashes arrive, but stay unsymbolicated. |