New Relic エージェントは、アプリケーションに影響するエラーの範囲に関するデータを自動的にキャプチャします。エラー グループ別に整理すると、次の 3 つの主要な指標を通じて影響を確認できます。
- 影響を受けたユーザー: エラーの影響を受けたユニーク ユーザーの数
- 影響を受けたセッション数: 影響を受けたユニークブラウザセッションの数（ブラウザエンティティのフォールバック）
- 影響を受けるデバイス: 影響を受けるモバイルデバイスの数（モバイルエンティティのフォールバック）
ユーザーの影響を受けるデータが利用できない場合、 New Relicエンティティ タイプに基づいて適切なフォールバック メトリクスを自動的に表示します。 これにより、影響範囲が最も大きいエラーが表示されるため、デバッグ作業をどこに集中させるかを優先順位付けできます。
one.newrelic.com > APM & Services > Errors (errors inbox) > Triageに移動します。影響メトリクスは、Error count [エラー数]とError rate [エラー率]時系列の下にあるError groups [エラー グループ]テーブルの 2 番目の列にあります。
フォールバックの影響メトリクス
New Relic は、特定のアプリケーション タイプに最も関連性の高い影響データを優先して表示します。Users impacted [ユーザーの影響を受ける]データが利用できない場合、システムは自動的にエンティティ固有のメトリクスにフォールバックします。
- Browserエンティティ:Sessions impacted [影響を受けたセッション]を表示します - エラーの影響を受けた一意のブラウザセッションの数
- モバイルエンティティ:Devices impacted [影響を受けたデバイス]（エラーの影響を受けたモバイルデバイスの数）を表示します
これらのフォールバック メトリクスは、カスタム アトリビュートが必要となる影響を受けるユーザーとは異なり、追加の設定を必要とせずに自動的に収集されます。 これにより、セットアップに関係なく、アプリケーションに影響するエラーの範囲を常に把握できるようになります。
影響を受けるユーザーを追跡するためのカスタムアトリビュート
場合によっては、エラー イベントには、そのエラー イベントの影響を受けるエンドユーザーを識別するプロパティがない場合があります。 カスタムアトリビュートを手動で追加して、取り込み時にユーザーを識別するメタデータをエージェントがキャプチャできるようにすることができます。
カスタム アトリビュートを追加する必要がある場合は、エンド ユーザー プロパティの命名には複数の共通規則があるため、 OpenTelemetryのプロパティ規則を確認することをお勧めします。
たとえば、 OpenTelemetry 標準では、優先順位に従って次の属性が使用されます。
userIduser
New Relicカスタムイベントの収集 に関するドキュメントを読むことで、 カスタムアトリビュートをどのように処理するかを確認できます。
インパクトのための手紙 メトリクス
エラー グループの影響メトリクスは、特定のメトリクス名を持つメトリクス データ型として記録されます。
インパクトメトリクスに関する集計
NRQLアラート条件を作成することにより、開発者はエラーの範囲が許容値を超えたときにトリガーできます。 任意のインパクト メトリクスに対してアラートを作成できます。
- 影響を受けたユーザー: ユーザーへの影響があなたの許容値を超えたときの集計
- 影響を受けたセッション: ブラウザー セッションの影響が許容値を超えたときの集計
- 影響を受けたデバイス: モバイル デバイスの影響が閾値を超えたときの集計
このアラートを作成するには、ユースケースを最もよく捉える方法で影響を受けるユーザーの数を測定するNRQL クエリを決定する必要があります。
例として、次の NRQL クエリは、特定のエンティティからのエラー グループの影響を受けたユニーク ユーザーの数を測定します。
NRQL クエリを決定したら、それを使用してNRQL アラート条件を作成できます。
トリガーされたアラートの信号対ノイズ比を改善するには、 アラート作成のヒント、 アラートしきい値の評価方法、およびアラート条件の例を参照してください。
setUser メソッドで影響を受けるユーザーを設定する
エージェントメソッドを使用して、Users impacted [影響を受けるユーザー]のエンドユーザーを特定できます。 影響を受けるセッションとデバイスは、追加の設定なしで自動的に収集されます。 各エージェントの実装の詳細については以下を参照してください。