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

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

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

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

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

Mac ユーザー

In the source file, to select multiple lines of code hold shift or command and select row numbers you want to select. then you can copy the browser URL and share it.

Windows

In the source file, to select multiple lines of code hold shift or CTRL and select row numbers you want to select, then you copy the browser URL and share it. to unselect lines, hold command/ctrl and select row numbers that are already selected.

ソース ビュー URL

src の URI テンプレート

src の URL 例

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

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

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

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

• 命名規則が必要です。

• 問い合わせます。

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

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

Bitbucket provides, as add-ons, a number of file viewers which can be useful for files that are not source code: like graphics, videos, or 3D models. However, most products that do production monitoring don't own the format of the underlying source code. Moreover, using a custom file viewer will require that any user who select the link has that file viewer installed.