Sentryエラートラッキング

Sentryは、オープンソースのエラートラッキングシステムです。GitLabでは、管理者がSentryをGitLabに接続することで、ユーザーがGitLabでSentryエラーの一覧を表示できるようになります。

GitLabは、クラウドでホストされているSentryと、オンプレミスインスタンスにデプロイされたSentryの両方とインテグレーションできます。

プロジェクトのSentryインテグレーションを有効にする

GitLabには、Sentryをプロジェクトに接続する方法が用意されています。

前提要件:

• プロジェクトのメンテナー以上のロールを持っている必要があります。

Sentryインテグレーションを有効にするには、次の手順に従います:

1. Sentry.ioにサインアップするか、独自のオンプレミスSentryインスタンスをデプロイします。
2. 新しいSentryプロジェクトを作成します。インテグレーションするGitLabプロジェクトごとに、新しいSentryプロジェクトを作成します。
3. Sentryの認証トークンを検索または生成します。SaaSバージョンのSentryの場合は、https://sentry.io/api/で認証トークンを検索または生成できます。少なくとも次のスコープをトークンに付与します。project:read、event:read、およびevent:write (解決イベント用)。
4. GitLabで、エラートラッキングを有効にして設定します:
   1. 左側のサイドバーで、検索または移動先を選択して、プロジェクトを見つけます。
   2. 左側のサイドバーで、設定を選択して、プロジェクトを見つけます。モニタリング > エラートラッキングを選択し、[エラートラッキング]を展開します。
   3. エラートラッキングを有効にするで、有効を選択します。
   4. バックエンドのトラッキングエラーでSentryを選択します。
   5. Sentry API URLに、Sentryのホスト名を入力します。たとえば、https://sentry.example.comと入力します。SaaSバージョンのSentryの場合、ホスト名はhttps://sentry.ioです。EUでホストされているSaaSバージョンのSentryの場合、ホスト名はhttps://de.sentry.ioです。
   6. 認証トークンに、以前に生成したトークンを入力します。
   7. Sentryへの接続をテストし、プロジェクトドロップダウンリストに入力された状態で表示するには、接続を選択します。
   8. プロジェクトリストから、GitLabプロジェクトにリンクするSentryプロジェクトを選択します。
   9. 変更を保存を選択します。

Sentryエラーのリストを表示するには、プロジェクトのサイドバーで、モニタリング > エラートラッキングに移動します。

GitLabとのSentryのインテグレーションを有効にする

Sentryドキュメントの手順に従って、SentryのGitLabインテグレーションを有効にすることもできます。

トラブルシューティング

エラートラッキングを使用していると、次の問題が発生する可能性があります。

エラーConnection failed. Check auth token and try again

プロジェクト設定でモニタリング機能が無効になっている場合、プロジェクトのSentryインテグレーションを有効にするときにエラーが表示されることがあります。/project/path/-/error_tracking/projects.json?api_host=https:%2F%2Fsentry.example.com%2F&token=<token>へのリクエストの結果、404エラーが返されます。

この問題を修正するには、プロジェクトのモニタリング機能を有効にします。

エラーConnection has failed. Re-check Auth Token and try again

接続を試みると、オンプレミスのSentryインテグレーションでこの問題が発生する可能性があります。

このイシューを解決するには、次の手順に従います:

1. 左側のサイドバーの下部で、管理者を選択します。
2. 左側のサイドバーの下部にある設定 > ネットワークを選択します。
3. アウトバウンドリクエストを展開します。
4. ウェブフックとインテグレーションからローカルネットワークへの要求を許可するチェックボックスとシステムフックからのローカルネットワークへのリクエストを許可するチェックボックスを選択します。
5. 変更を保存を選択します。