エラーインボックスの影響を受けたユーザーを追跡する

New Relic エージェントは、ユーザーへの影響に関するデータを自動的にキャプチャします。エラーグループ別に整理すると、エラーの影響を受けるユーザーの数を確認できます。これにより、影響を受けるユーザー数が最も多いエラーが表示されるため、デバッグ作業をどこに集中させるかを優先順位付けするのに役立ちます。

one.newrelic.com > APM & Services > Errors (Errors Inbox) > Triageに移動します。影響を受けるユーザーは、Error count [エラー数]とError rate [エラー率の]時系列の下にあるError groups [エラーグループ]テーブルの 2 番目の列で確認できます。

影響を受けるユーザーを追跡するためのカスタムアトリビュート

場合によっては、エラーイベントには、そのエラーイベントの影響を受けるエンドユーザーを識別するプロパティがない場合があります。カスタムアトリビュートを手動で追加して、取り込み時にユーザーを識別するメタデータをエージェントがキャプチャできるようにすることができます。

カスタムアトリビュートを追加する必要がある場合は、エンドユーザープロパティの命名には複数の共通規則があるため、 OpenTelemetryのプロパティ規則を確認することをお勧めします。

たとえば、 OpenTelemetry 標準では、優先順位に従って次の属性が使用されます。

userId
user

New Relicカスタムイベントの収集に関するドキュメントを読むことで、カスタムアトリビュートをどのように処理するかを確認できます。

影響を受けたユーザーへの投稿

エラーグループの影響を受けるユーザーの数は、 newrelic.error.group.userImpactという名前のメトリックデータ型として記録されます。このメトリクスは、次の NRQL 文字列で使用できます。

SELECT uniqueCount(newrelic.error.group.userImpact) 
FROM Metric 
WHERE metricName='newrelic.error.group.userImpact'

このメトリクスは、選択した期間内のユニークユーザーのおおよその数を取得します。userImpactメトリクスによって提供され、 FACET句で使用できる追加の属性は、 error.group.guid 、 entity.guidです。

影響を受けたユーザーの集計

NRQLアラート条件を作成することにより、開発者は、エラーの影響を受けるユーザーの数が閾値を超えたときにをトリガーできます。

このアラートを作成するには、ユースケースを最もよく捉える方法で影響を受けるユーザーの数を測定するNRQL クエリを決定する必要があります。

例として、次の NRQL クエリは、特定のエンティティからのエラーグループの影響を受けたユニークユーザーの数を測定します。

SELECT uniqueCount(newrelic.error.group.userImpact) 
FROM Metric 
WHERE metricName='newrelic.error.group.userImpact' 
AND entity.guid='RXxCUk9XU9182nNEFQUExJQ0FLsU9OfDgzNzgwNw' FACET error.group.guid TIMESERIES

uniqueCount()関数の使用方法、エンティティのエンティティ GUID を検索する方法の詳細をご覧ください。

同様に、次の NRQL クエリは、過去 1 時間にアカウントのすべてのエンティティからのエラーの影響を受けたユーザーの総数を測定します。

SELECT count(newrelic.error.group.userImpact) 
FROM Metric 
WHERE metricName='newrelic.error.group.userImpact' SINCE 1 hour ago TIMESERIES

NRQL クエリを決定したら、それを使用してNRQL アラート条件を作成できます。

トリガーされたアラートの信号対ノイズ比を改善するには、アラート作成のヒント、アラートしきい値の評価方法、およびアラート条件の例を参照してください。

setUser メソッドで影響を受けるユーザーを設定する

エージェントメソッドを使用して、エンドユーザーを識別できます。以下の各エージェントの実装の詳細を参照してください。

エージェント	エンドユーザーを識別する方法
ブラウザ	`newrelic.setUserId(value: string\|null)`
Go	`txn.SetUserID("example user ID")`
Java	`NewRelic.setUserId(String userId);`
モバイル	`setUserId`
.NET	`SetUserId`
Node.js	`setUserID(id)`
PHP	`newrelic_set_user_id(string $user_id)`
Python	`newrelic.agent.set_user_id(user_id)`
Ruby	`NewRelic::Agent.set_user_id`

この機械翻訳は、参考として提供されています。

エラー インボックスの影響を受けたユーザーを追跡する

影響を受けるユーザーを追跡するためのカスタムアトリビュート .css-21sua1{background:none;border:none;width:0;padding:0;}

影響を受けたユーザーへの投稿

影響を受けたユーザーの集計

setUser メソッドで影響を受けるユーザーを設定する

エラーインボックスの影響を受けたユーザーを追跡する

影響を受けるユーザーを追跡するためのカスタムアトリビュート