Documentatie

OpenErrorAPI spreekt het Sentry wire protocol, dus je houdt de officiële SDK die je al gebruikt en wijzigt één regel: de DSN. Deze pagina legt uit hoe, en — net zo belangrijk — wat we niet ondersteunen.

Overstappen vanaf Sentry in 10 minuten

Je hoeft geen SDK te vervangen en geen code te herschrijven. Je wijst de SDK die je al hebt naar een andere DSN.

  1. 1

    Maak een project aan in de console. Je krijgt een DSN in de vorm https://PUBLIC_KEY@openerrorapi.com/PROJECT_ID.

  2. 2

    Vervang de DSN in je bestaande Sentry.init() — meestal één environment variable. Behoud de SDK, de versie en alle opties die je al hebt ingesteld.

  3. 3

    Deploy en trigger één error. Die verschijnt binnen een seconde in de console, gegroepeerd zoals in Sentry.

PHP

composer require sentry/sentry
\Sentry\init(['dsn' => 'https://PUBLIC_KEY@openerrorapi.com/PROJECT_ID']);

JavaScript / TypeScript

npm i @sentry/browser
Sentry.init({ dsn: 'https://PUBLIC_KEY@openerrorapi.com/PROJECT_ID' });

Node.js

npm i @sentry/node
Sentry.init({ dsn: 'https://PUBLIC_KEY@openerrorapi.com/PROJECT_ID' });

Python

pip install sentry-sdk
sentry_sdk.init(dsn="https://PUBLIC_KEY@openerrorapi.com/PROJECT_ID")

Go

go get github.com/getsentry/sentry-go
sentry.Init(sentry.ClientOptions{Dsn: "https://PUBLIC_KEY@openerrorapi.com/PROJECT_ID"})

Dart / Flutter

flutter pub add sentry_flutter
await SentryFlutter.init((o) => o.dsn = 'https://PUBLIC_KEY@openerrorapi.com/PROJECT_ID');

Upload je al source maps met sentry-cli? Behoud die stap ook — stel SENTRY_URL in op https://openerrorapi.com en gebruik een upload token als SENTRY_AUTH_TOKEN.

Sentry-compatibiliteit, eerlijk

Compatibiliteit is de hele belofte, wat het het gevaarlijkste maakt om te overdrijven. Deze tabel is gegenereerd uit dezelfde bron die de code en onze machine-readable docs gebruiken, dus het kan niet ongemerkt afdrijven van de werkelijkheid.

7 gebieden volledig ondersteund · 3 gedeeltelijk · 3 niet ondersteund.

Gebied Status Detail
Envelope ingest (/api/{id}/envelope/) Ondersteund 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/) Ondersteund Legacy endpoint for older SDKs. Same processing pipeline as envelopes.
Error events & grouping Ondersteund Exceptions, messages, stack traces, tags, user, contexts, breadcrumbs, request. Grouping by fingerprint with an explicit `fingerprint[]` override.
Sessions / release health Ondersteund Session envelope items are processed; crash-free sessions and users are shown per release. Available from the Team plan.
Security reports (CSP) Ondersteund 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 Ondersteund 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 Gedeeltelijk 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 Ondersteund Embeddable widget; reports land next to the errors they belong to.
Transactions / performance Gedeeltelijk 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) Niet ondersteund Not processed yet. Log items are ignored, which does not affect error reporting from the same SDK.
Cron monitors (check_in items) Gedeeltelijk 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 Niet ondersteund Deliberately out of scope. These are the reasons to stay on Sentry; we do not pretend otherwise.
Native symbolication (dSYM / ProGuard) Niet ondersteund Not supported. Native mobile crashes arrive, but stay unsymbolicated.

Verder gaan