Rubyエージェントのエラーコレクターを設定して、エラーのキャプチャ方法、無視または想定内として処理するエラー、およびエラーイベントのサンプリング方法をカスタマイズします。
エラーコレクター
エージェントは、デフォルトでは、すべてのアンキャッチャー例外を収集して報告します。これらの設定オプションにより、エラー収集をカスタマイズすることができます。
無視されたエラーと予想されるエラーの詳細については、APM のエラー分析に関するこのページを参照してください。NewRelic::Agent.notice_error Ruby メソッドを介して予想されるエラーを設定するには、Ruby エージェント API を参照してください。
タイプ | ブール値 |
|---|
デフォルト | true
|
|---|
環境変数 | NEW_RELIC_ERROR_COLLECTOR_CAPTURE_EVENTS
|
|---|
trueの場合、エージェントは TransactionErrorイベントを収集します。
タイプ | ブール値 |
|---|
デフォルト | true
|
|---|
環境変数 | NEW_RELIC_ERROR_COLLECTOR_ENABLED
|
|---|
trueの場合、エージェントはトレースされたエラーとエラーカウントメトリックをキャプチャします。
エージェントが期待通りに扱うべきエラークラスのリストです。
注意
このオプションは、環境変数で設定することはできません。
メッセージのリストへのエラー・クラスのマップです。ここで指定されたクラスのエラーが発生したとき、そのエラーメッセージにここで指定された文字列のいずれかが含まれていれば、そのエラーは期待どおりに処理されます。
注意
このオプションは、環境変数で設定することはできません。
タイプ | 弦 |
|---|
デフォルト | ""
|
|---|
環境変数 | NEW_RELIC_ERROR_COLLECTOR_EXPECTED_STATUS_CODES
|
|---|
HTTPステータスコードまたはステータスコード範囲をカンマ区切りで並べたリスト（例：404, 429, 500-599）。エラーのステータスコードがリストにある場合、そのエラーは想定内のエラーとして処理されます。
タイプ | 配列 |
|---|
デフォルト | ["ActionController::RoutingError", "Sinatra::NotFound"]
|
|---|
環境変数 | None
|
|---|
エージェントが無視すべきエラークラスのリストです。
注意
このオプションは、環境変数で設定することはできません。
タイプ | ハッシュ |
|---|
デフォルト | {ThreadError: ["queue empty"]}
|
|---|
環境変数 | None
|
|---|
メッセージのリストへのエラー・クラスのマップです。ここで指定されたクラスのエラーが発生したとき、そのエラーメッセージにここで指定された文字列のいずれかが含まれていれば、そのエラーは無視されます。
注意
このオプションは、環境変数で設定することはできません。
タイプ | 弦 |
|---|
デフォルト | ""
|
|---|
環境変数 | NEW_RELIC_ERROR_COLLECTOR_IGNORE_STATUS_CODES
|
|---|
HTTPステータスコードまたはステータスコード範囲をカンマ区切りで並べたリスト（例：404, 429, 500-599）。エラーのステータスコードがリストにある場合、そのエラーは無視対象として処理されます。
タイプ | 整数 |
|---|
デフォルト | 50
|
|---|
環境変数 | NEW_RELIC_ERROR_COLLECTOR_MAX_BACKTRACE_FRAMES
|
|---|
エラーバックトレースにおけるフレームの最大数を定義します。デフォルトでは、設定値を超えるバックトレースは中間部分が切り捨てられ、スタックトレースの先頭と末尾が保持されます。切り捨て位置をカスタマイズする方法については、error_collector.backtrace_truncate_locationを参照してください。
タイプ | 弦 |
|---|
デフォルト | "middle"
|
|---|
環境変数 | NEW_RELIC_ERROR_COLLECTOR_BACKTRACE_TRUNCATE_LOCATION
|
|---|
フレーム数がerror_collector.max_backtrace_framesを超えた場合に、バックトレースのどの部分を切り捨てるかを指定します。設定可能なオプションは、top（先頭からフレームを削除）、middle（先頭と末尾は残し、中間からフレームを削除）、end（末尾からフレームを削除）です。
タイプ | 整数 |
|---|
デフォルト | 100
|
|---|
環境変数 | NEW_RELIC_ERROR_COLLECTOR_MAX_EVENT_SAMPLES_STORED
|
|---|
収集サイクルごとに報告される TransactionErrorイベント の最大数を定義します。
受信トレイ構成のエラー
次の環境変数のいずれかを設定すると、ソフトウェアのどのバージョンでエラーが発生したかを特定するのに役立ちます。
NEW_RELIC_METADATA_SERVICE_VERSION デプロイされているコードのバージョンを含むtags.service.versionをイベントデータに作成します。このバージョンは多くの場合、1.2.3などのセマンティックバージョンですが、そうでない場合もあります。NEW_RELIC_METADATA_RELEASE_TAG リリースタグ（v0.1.209またはrelease-209など）を含むtags.releaseTagをイベントデータに作成します。NEW_RELIC_METADATA_COMMIT コミットSHAを含むtags.commitをイベントデータに作成します。SHA全体を使用することも、先頭7文字（例：734713b）のみを使用することもできます。
Errors Inboxは、ソフトウェアのどのバージョンでエラーが発生しているかを自動追跡します。