Errors Inboxによるバージョン追跡

Errors Inboxバージョン追跡により、開発者は各コンポーネントを監視して、正確性と成功を確認できます。 あなたとあなたのチームが、あなたのグループの 1 つでエラー率が急上昇したという集計を受け取ったとします。 エラーの原因を特定し、カナリアデプロイメントをリリースすることを決定します。 バージョン追跡を使用すると、修正と以前の修正を監視して、問題が解決されたかどうか、または最初からやり直す必要があるかどうかを判断できます。

エラーステータスによるトリアージ

受信トレイをトリアージするときに、さまざまなステータスから選択できます。 エラーをすぐに解決したり、無視されるようにマークしたりすることもできます。 場合によっては、次のバージョンまたは特定のバージョンで問題を解決したいこともあります。

次のいずれかのステータスを設定し、ステータスごとに受信トレイをフィルタリングできます。

• Unresolved

  : これはエラー グループのデフォルトのステータスです。

• Resolve in next version

  : 次のリリースでこのエラー グループを解決する予定の場合は、このステータスを使用することをお勧めします。 このオプションを有効にするには、 Errors Inboxが新しいリリースを検出し、エラー グループが実際に解決されたことを確認できるように、アプリケーションの 変更追跡 (変更追跡機能) を設定する必要があります。次のバージョンまたは将来のバージョンでもエラー グループが引き続き検出された場合、エラー グループは自動的に未解決となり、回帰としてマークされ、回帰に関する Slack 通知が届きます。

• Resolve in specific version

  : 次の状況でエラー グループを解決するには、このオプションを選択します。

  • エラーグループが特定のバージョンで解決されることがわかっている場合
  • 既存のバージョンでエラーグループが解決されていることがわかっている場合
  • 特定のバージョンを入力したい場合

  このオプションを有効にするには、アプリケーションまたはサービスのバージョン追跡を計測する必要があります。 同等以上のセマンティック バージョンを持つエラー発生が検出されると、エラー グループは自動的に未解決となり、回帰としてマークされ、回帰に関する Slack 通知が届きます。

• Resolve

  : エラー グループを解決済みとして設定すると、フィルターを更新して解決済みのエラー グループを含めない限り、そのエラー グループがデフォルトの受信トレイ ビューに表示されなくなります。 エラー グループを解決済みとしてマークした後に、エラー グループのフィンガープリントと一致するイベントが発生すると、ステータスは自動的にUnresolved [未解決]にリセットされます。 これは回帰を識別するのに役立ちます。

• Ignore

  : 無視されたエラーを含めるようにフィルターが更新されない限り、またはエラー グループの無視を停止するまで、受信トレイ ビューでエラー グループが非表示になります。

バージョン追跡フィールドを理解する

バージョン追跡をインストルメント化する前に、エラー受信箱が結果をどのように分類するかを理解することが重要です。APM および OpenTelemetry アプリケーションでは、エラーを追跡するときに、次のイベント フィールドがチェックされ、この順序で表示されます。

1. service.version
2. tags.service.version
3. tags.releaseTag
4. tags.commit

モバイル アプリケーションの場合、イベント フィールドはappVersionです。

ブラウザ アプリケーションの場合、イベント フィールドはapplication.versionです。

楽器のバージョン追跡

バージョン追跡からデータを取得するには、関連するエンティティのフィールドを構成する必要があります。

• OpenTelemetry エンティティの場合は、 service.versionを構成します。

• APM エンティティの場合は、APM エンティティの環境変数を構成します。

  • Go
  • Java
  • .NET
  • Node.js
  • PHP
  • Python
  • Ruby

• モバイル エンティティの場合は、 appVersionを構成します。

• ブラウザエンティティの場合は、 application.versionを使用します。

バージョンでフィルタリングする

バージョン追跡を設定すると、エラー グループが各リリースからデータを自動的にキャプチャします。バージョンごとにフィルタリングできます。

複数のバージョンを持つエラー グループをフィルタリングするには、+ 演算子を使用してOR条件を選択します。

変更追跡を使用して展開を監視できます。これを行った場合は、エラーのバージョンとデプロイメントのバージョンを一致させることができるように、デプロイメントがエンティティにインストルメントしたのと同じバージョン形式と一致していることを確認することが重要です。

エラーグループごとにバージョンを検索

また、エラー グループをクリックして、エラー グループの最初と最後に確認された日付に一致する各デプロイメントを表示することもできます。最初に確認した日から 30 分以内、最後に確認した日から 30 分以内に公開されていたバージョンのみが表示されます。

発生した各エラーをバージョン別にグループ化して表示するグラフを使用すると、エラー グループをさらに詳しく調べることができます。

変更追跡を使用してデプロイメントも設定している場合は、このグラフにデプロイメント マーカーが表示されます。これらのマーカーは、各デプロイメントがいつリリースされたかを示します。マーカーをクリックしてデプロイメントに移動します。