SentryまたはGlitchTipに接続する

SentryとGlitchTipはどちらも同じSentry SDKプロトコルを使用しています。Elido側の設定はどちらも同じです — 唯一の違いは貼り付けるDSNです。

このガイドでは2つの方向を説明します：Elidoのアラートをエラートラッカーにパイプすること（不正使用、TLS、APIの問題をトリアージできるissueとして表示させる）と、GlitchTipを既にセルフホストしている場合に既存のSentry設定と一緒にElidoを使用すること。

なぜ接続するのか#

Elidoは以下のような運用イベントを発行します。これらはSentryのissueとして活用できます：

abuse.flagged — スキャナーが宛先URLをマルウェア/フィッシングとしてマーク。
domain.tls_renewed（失敗バリアント） — CaddyがTLS証明書を更新できなかった。
webhook.delivery_failed — 自分のWebhookエンドポイントが応答しなくなった。
link.clicked.aggregated（異常バリアント） — 単一リンクで突然のトラフィック10倍スパイク。

すべてをissueにする必要はありません — 人間の対応が必要なものだけを選んでください。

インテグレーションを追加する#

Dashboard → Integrations → Sentry / GlitchTip。
Sentry DSNを貼り付けます。GlitchTip DSNは同じ形式で、同じフィールドで動作します。
転送するイベントの種類を選択します。デフォルトは abuse.flagged とTLS更新失敗のみです。
Send test event をクリックします。10秒以内にSentryプロジェクトに「テストissue」が表示されるはずです。
Save。

インテグレーションはサーバーサイドで動作します。ダッシュボードにSentryブラウザSDKを読み込みません — DSNは訪問者のブラウザに届きません。

issueの見た目#

転送された各イベントはSentryフォーマットのissueになります：

event_id = ElidoイベントID（重複排除用）。
level = 不正使用とTLS失敗は error、Webhook配信失敗は warning、スパイク異常は info。
fingerprint = ワークスペースID + イベント種別 + 関連リソースID。同じissueの再発が正しくSentryでグループ化されます。
extra = 完全なElidoイベントペイロード。
tags = workspace、event_kind、リソース固有のタグ（link_slug、domain など）。

GlitchTipに関する注意#

GlitchTipはSentryイベント取り込みAPIを実装していますが、Sentryのフル機能セットは実装していません。インテグレーションは取り込みエンドポイントを通じてイベントを送信するだけなので、そのスコープ内の機能（issue グループ化、fingerprint、検索、アラート）はGlitchTipでも動作します。パフォーマンストレース、リプレイ、プロファイリングは動作しませんが、Elidoはそれらを送信しません。

プライベートネットワーク内でGlitchTipをセルフホストしている場合は、ElidoのエグレスIPへのHTTPアクセスを許可してください。完全なリストはトラストページにあります。簡潔に言うと：5.75.0.0/16（Hetzner FRA）と 51.79.0.0/16（OVH SGP）です。

無効化する#

インテグレーションページで Disconnect をクリックします。DSNが消去され、それ以降イベントは送信されません。既存のSentryのissueは削除されません — Sentryプロジェクトに残ります。

制限#

ワークスペースごとに1つのSentryデスティネーション。複数のSentryプロジェクトにファンアウトが必要な場合は、webhooksと小さなプロキシを使用してください。
Sentryのデフォルトのレート制限50/sをプロジェクトごとに尊重します。スパイク異常は制限内に収まるよう送信前にサンプリングされます。

トラブルシューティング#

テストイベントは届くが実際のイベントが届かない。 インテグレーション設定で正しいイベントの種類を選択していることを確認してください。デフォルトの選択は保守的です。

イベントは届くが tags が空。 Sentryは200文字を超えるタグ値（スラグ、ドメイン）を切り捨てることがあり、unknown として表示されます。これはSentryの制限であり、Elido側の問題ではありません。

GlitchTipの取り込みエンドポイントが429を返す。 GlitchTipインスタンスがレート制限しています。GlitchTipの管理画面でプロジェクトごとの制限を引き上げるか、必要なイベント種別だけにフィルタリングしてください。

DSNがローテーションされ、401が返されるようになった。 インテグレーションページでDSNを更新してください。DSNローテーションの自動検出はありません。