Bitbucket のソース コードへのハイパーリンク

一般的なスタック トレースにはファイル パスや行番号が含まれることが多くありますが、Bitbucket アカウント、リポジトリ、または Git コミットの情報は、ほとんどの場合含まれません。製品は、ランタイム エラーの状態からソース コードに戻れるよう、ランタイム コンテキストの外でこの情報に対応する必要があります。これは通常、ローカル コピーが本番と同じリビジョンであることを前提として、スタック トレース、例外レポート、またはログ メッセージをソース コードのローカル コピーに合わせることを意味します。

この問題をハイパーリンクで解決する方法

インテグレーターは、エラー レポートから Bitbucket のコードの特定の行へハイパーリンクを設定できるようになりました。アカウント、リポジトリ、コミット、ファイル パス、行番号などの情報に適切にリンクすることをおすすめします。

コードの複数の行を選択してハイパーリンク化する方法

Mac ユーザー

ソース ファイルでコードの複数の行を選択するには、Shift キーまたは Command キーを押しながら、選択対象の行番号をクリックします。次に、ブラウザ URL をコピーして共有できます。

Windows

ソース ファイルでコードの複数の行を選択するには、Shift キーまたは CTRL キーを押しながら、選択対象の行番号をクリックします。次に、ブラウザ URL をコピーして共有できます。選択を解除するには、command/ctrl キーを押したまま、選択済みの行番号をクリックします。

ソース ビュー URL

src の URI テンプレート

src の URL 例

オーナー、リポジトリ名、およびコミットを取得する方法

このメタデータはほとんどのスタック トレースでは利用できないため、Bitbucket の知識を活用して調整する必要があります。オプションの一部を紹介します。

• ビルド時間中にメタデータを抽出する。たとえば、Bamboo を使用して Java プロジェクトを構築しているとします。Bamboo は Bitbucket のリポジトリ URL とリビジョンを環境変数として表示します。URL をパースすることで所有者とリポジトリ名を取得できます。これら 3 つはいずれも、JAR にパッケージ化する前に、META-INF/MANIFEST.MF に書き込むことができます。

• プッシュ イベントの Bitbucket Web hook をアーティファクトのデプロイ イベントと関連させます。

• 命名規則が必要です。

• 問い合わせます。

ファイル ビューアーについて

ファイル ビューアーを使用してスタック トレースをリンクする際には、Bitbucket の既定ファイル ビューアーを使用することをお勧めします。

Bitbucket は、画像、動画、3D モデルなどのソース コードで構成ファイルに便利なアドオンや、多数のファイル ビューアーを提供しています。ただし、製品監視を実現するほとんどの製品は、基盤となるソース コードの形式を所有していません。カスタム ファイル ビューアーを使用する場合、リンクをクリックするユーザーはそのファイル ビューアーをインストールしている必要があります。