• /
  • EnglishEspañol日本語한국어Português
  • ログイン今すぐ開始

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

英語版と翻訳版に矛盾がある場合は、英語版が優先されます。詳細については、このページを参照してください。

問題を作成する

Javaエージェントのエラー設定

APMのJavaエージェントは、アプリケーション内で発生したエラーの詳細情報をレポートします。これにより、アプリケーションのパフォーマンスやエンドユーザーの体験に影響を与えている可能性のある問題領域を把握することができます。

Java エージェント バージョン 3.40.0 以降 では、エラーの報告方法を制御するための設定オプションがいくつかあります。

  • 予想されるエラーがエラーレートやApdexに影響を与えないように設定する
  • エラーの無視
  • 自動的に報告されないエラーを報告する

エラーデータの表示については、 Error analytics を参照してください。すべてのエージェントのエラーデータの概要については、 Manage errors in APM を参照してください。

一般的に報告されているエラー例

次のような場合に、Javaエージェントでエラーが発生することがありました。

エラー報告

Comments

ハンドリングされないエラー(スタックトレースを含む)

Javaエージェントがトレースしていたトランザクション内で処理されないエラーが発生した場合、そのエラーはフルスタックトレースとともに報告されます。

HTTPステータスコード(スタックトレースなし)

アプリケーション内の トレース が HTTP ステータス コード (クライアント エラーの場合は400など) を生成すると、スタック トレースなしでエラーが報告されます。 その理由は次のとおりです。

  • アプリケーション サーバーはエラー状態を検出し、ステータス コードを明示的に設定しました。

    また

  • プログラム ロジックによってエラー状態が検出されたため、例外オブジェクトまたはスタックはありませんでした。

    これらのタイプのトランザクションにスタック トレースを含めるには、 noticeError(...) API 呼び出しを使用する必要があります。

noticeError(...) APIコール

Java エージェントがnoticeError(...) API 呼び出しを使用して明示的な呼び出しを行った場合、トランザクション内で発生したかどうかに関係なく、エラーが報告されます。報告される情報は、 Javadocsで説明されているように、 noticeError(...) API 呼び出しで使用されるパラメーターによって異なります。

100%以上の未処理エラー報告

Javaagent は、スコープ外エラー (どのトランザクションにも関連付けられていないエラー) を報告できます。 このため、タイムスライス内に 1 つのトランザクションがあり、同じタイムスライス内に複数のエラーが発生する可能性があります。 この状況では、New Relic はエラー率over 100%を表示します。

エラーレポートの設定

重要

この機能を使用するには、 を最新のリリース にアップグレードしてください。 (Java agent 3.40.0 以上)。

Javaエージェントには、エラーの報告方法を制御するための柔軟な設定オプションがいくつか用意されています。

Config options

Details

UIによるエラーの設定

サーバーサイドコンフィグ によって、エラーを無視したり、期待通りのマークを付けたりすることができます。

予想されるエラーとして設定するには newrelic.yml

これらのバージョンのnoticeErrorによって報告されるエラーは、 newrelic.yml予想されるエラーとして構成できます。エラーがnewrelic.yml無視されるように構成されている場合、この API の呼び出しはオーバーライドされます。詳細については、 エラー構成の優先順位を参照してください。

これらのnoticeError() API 呼び出しを使用して、自動的に報告されないエラーを報告し、それらをnewrelic.yml予想されるエラーとして構成します:

  • noticeError(Throwable throwable)

予想されるエラーを上書きする newrelic.yml

noticeErrorのこれらのバージョンによって報告されたエラーは、 newrelic.yml予想されるエラー構成をオーバーライドします。エラーが yml で無視されるように構成されている場合、この API の呼び出しはオーバーライドされます。詳細については、 エラー構成の優先順位を参照してください。

これらのnoticeError(...) API 呼び出しを使用して、自動的に報告されないエラーを報告し、API で予期されるエラーとして構成します (yml の予期されるエラー構成をオーバーライドします)。

設定ファイル経由でエラーを無視または予測する

バージョン 3.40.0 以降では、 YAML ベースの設定を使用してエラーの報告方法を制御できます。 これにより、例外クラス名のリストとオプションのエラーメッセージに基づいて、HTTP ステータス コードorに基づいてエラーを無視したり、エラーを予期したりすることができます。

  • Ignoring errors 指定された例外クラスまたはコードがに報告されないようにします。

  • Expecting errors 指定された例外クラスまたはコードがアプリケーションのエラー率Apdex スコアに影響を与えないようにします。 これにより、エラー率や Apdex スコアに基づくアラートを回避しながら、トラブルシューティングの目的でエラー情報を保持できます。

    これらの設定は動的であるため、実行中のエージェントは JVM を再起動せずにnewrelic.ymlの変更を認識します。 詳細と例については、 Javaagent 構成ファイルを参照してください。

エラー収集のためのYAMLベースの設定

YAMLベースのエラーコレクションの設定では、特定のエラーを完全に無視したり、予想されるエラーを除外して、アプリケーションのエラーレートやApadexスコアに影響を与えないようにすることができます。以下の基準に基づいて、エラーを無視または予期されるものとしてマークすることができます。

  • HTTPステータスコードの指定された範囲を、カンマで区切られたリストまたは破線の範囲として表示します。

  • パッケージ/クラスの完全修飾名を使用したコンマ区切りのリスト

    and

    オプションで提供されるエラーメッセージ文字列

エラー設定の優先順位

エラー設定の優先順位は

  1. サーバー側の設定 (YAMLファイルに値を重ねる)
  2. ignore_* YAML の構成
  3. expected noticeError(..) API 呼び出しのパラメーター
  4. expected_* YAML の構成

ここでは、さまざまなAPIコールとYAMLの設定を組み合わせた場合の結果の例を紹介します。

エラーの詳細についてログを調べる

ログやアプリケーションのデータをまとめて、トラブルシューティングを簡単かつ迅速に行うことができます。 logs in context では、エラーやトレースに関連するログメッセージをアプリのUIで直接確認することができます。

  1. Errors

    ページからトレースをクリックすると、

    Error details

    ページに移動します。

  2. エラーの詳細ページで、

    See logs

    をクリックします。

  3. 個々のログメッセージに関連する詳細を表示するには、メッセージを直接クリックします。

無視されるエラーと期待されるエラーをUIで設定

APM UIを介して、 予想されるエラー を設定すること。

  1. 有効になっていない場合は、サーバーサイドコンフィグレーションを有効化します。

  2. 期待通りとマークしたいエラーのあるアプリケーションのサーバー側の設定メニュー にアクセスします。

  3. Error collection

    の下の

    Ignore

    または

    Exclude expected errors

    いずれかに、構成するエラーの HTTP コードまたはエラー クラスを入力します。

  4. Save

    を選択します。

予想されるエラーをUIで表示する方法については、 予想されるエラーを表示する を参照してください。

Copyright © 2024 New Relic株式会社。

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.