ドキュメント

OpenErrorAPIはSentryワイヤープロトコルに対応しているため、既に使用している公式SDKをそのまま利用でき、変更が必要なのはDSNの1行だけです。このページでは、その方法と、同じく重要な点として、サポートしていない機能について説明します。

Sentryから10分で切り替え

SDKの置き換えもコードの書き換えも不要です。既存のSDKが指すDSNを変更するだけです。

  1. 1

    コンソールでプロジェクトを作成すると、https://PUBLIC_KEY@openerrorapi.com/PROJECT_ID 形式のDSNが発行されます。

  2. 2

    既存の Sentry.init() 内のDSNを置き換えます。通常は環境変数1つです。SDKやバージョン、既存の設定はそのまま維持してください。

  3. 3

    デプロイしてエラーを1つ発生させると、1秒以内にコンソールに表示され、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');

既に sentry-cli でソースマップをアップロードしていますか?その手順も維持してください。SENTRY_URL を https://openerrorapi.com に設定し、アップロードトークンを SENTRY_AUTH_TOKEN として使用します。

Sentry互換性、正直に

互換性こそが約束の全てであり、だからこそ誇張が最も危険です。この表はコードと機械可読ドキュメントが使用する同じソースから生成されているため、現実から静かに乖離することはありません。

7件の領域を完全サポート · 3件が部分対応 · 3件が未対応

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

さらに詳しく