Dokumentation

OpenErrorAPI spricht das Sentry-Drahtprotokoll, sodass du das offizielle SDK, das du bereits verwendest, behältst und eine Zeile änderst: den DSN. Diese Seite erklärt wie, und – genauso wichtig – was wir nicht unterstützen.

In 10 Minuten von Sentry wechseln

Es gibt kein SDK zu ersetzen und keinen Code umzuschreiben. Du richtest das SDK, das du bereits hast, auf einen anderen DSN.

  1. 1

    Erstelle ein Projekt in der Konsole. Du erhältst einen DSN in der Form https://PUBLIC_KEY@openerrorapi.com/PROJECT_ID.

  2. 2

    Ersetze den DSN in deinem vorhandenen Sentry.init() – üblicherweise eine Umgebungsvariable. Behalte das SDK, die Version und jede Option, die du bereits gesetzt hast.

  3. 3

    Deploye und löse einen Fehler aus. Er erscheint innerhalb einer Sekunde in der Konsole, gruppiert wie 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');

Lädst du bereits Source Maps mit sentry-cli hoch? Behalte diesen Schritt ebenfalls – setze SENTRY_URL auf https://openerrorapi.com und verwende einen Upload-Token als SENTRY_AUTH_TOKEN.

Sentry-Kompatibilität, ehrlich

Kompatibilität ist das ganze Versprechen, was es zur gefährlichsten Sache macht, sie zu übertreiben. Diese Tabelle wird aus derselben Quelle generiert, die der Code und unsere maschinenlesbaren Docs verwenden, sodass sie nicht unbemerkt von der Realität abweichen kann.

7 Bereiche vollständig unterstützt · 3 teilweise · 3 nicht unterstützt.

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

Weiterführendes