Rubyエージェントのその他の設定

trueの場合、トランザクションイベントのサンプリングを有効にします。

1つのハーベストから報告されるトランザクションイベントの最大数を定義する。

trueの場合、NewRelicコレクターとの通信をログに記録する監査ログを有効にします。

監査ログに含めることを許可するエンドポイントのリスト。

監査ログファイルのパス（ファイル名を含む）を指定します。

エージェントが自動的に起動しないようにする定数のリストを指定します。個々の定数はコンマ,で区切ります。たとえば、 "Rails::Console,UninstrumentedBackgroundJob" 。

エージェントがインストルメントしてはならない実行可能ファイルのコンマ区切りリストを定義します。たとえば、 "rake,my_ruby_script.rb"です。

エージェントがインストルメントしてはならないRakeタスクのコンマ区切りリストを定義します。たとえば、 "assets:precompile,db:migrate"です。

このアプリケーションに関連付けられているAWSアカウントID。

trueの場合、エージェントはトレースされたメソッドについてソースコードレベルのメトリクスを報告します。詳細は、https://docs.newrelic.com/docs/apm/agents/ruby-agent/features/ruby-code-level-metrics/を参照してください。

falseの場合、カスタム属性はイベントで送信されません。

trueの場合、エージェントはカスタムイベントをキャプチャします。

一度にメモリにバッファリングするカスタムイベントの最大数を指定します。 AI監視用にエージェントを設定する際は、最大値（100000）に設定してください。これにより、エージェントは最大数のLLMイベントを確実に取得できます。

falseの場合、エージェントはdatabase_nameパラメーターをトランザクションまたは遅いsqlトレースに追加しません。

falseの場合、エージェントはデータストアインスタンスメトリックを報告せず、トランザクションにhostまたはport_path_or_idパラメータを追加したりSQLトレースを遅くしたりしません。

trueの場合、アクションケーブルの計装を無効にします。

trueの場合、アクション コントローラーの計測を無効にします。

trueの場合、アクション メールボックスの計測を無効にします。

trueの場合、Action Mailer インストルメンテーションを無効にします。

trueの場合、アクティブなジョブの計測を無効にします。

trueに設定すると、Rails Active Job Continuationsのステップ名をメトリクス名に含めません。この設定により、メトリクスのカーディナリティは削減されますが、個々のステップのパフォーマンスを把握しづらくなります。ステップ数が多いジョブや動的に名前が付けられたステップが原因でメトリクスのカーディナリティの問題が発生している場合にのみ、trueに設定してください。

trueの場合、アクティブ ストレージの計測を無効にします。

trueの場合、Active Support インスツルメンテーションを無効にします。

trueの場合、Active Record インストルメンテーションを無効にします。

trueの場合、Active Record 4+の計装が無効になります。

trueの場合、エージェントはホストプロセスのCPU使用率をサンプリングしません。

trueの場合、エージェントは遅延ジョブキューの深さを測定しません。

trueの場合、ガベージコレクションの実行にかかった時間を計測するためのGC::Profilerを使用しません。

trueの場合、エージェントはホストプロセスのメモリ使用量をサンプリングしません。

trueの場合、エージェントはサードパーティのミドルウェアをインストルメンテーションにラップしません ( Rack::Builderまたは Rails を介してインストールされているかどうかに関係なく)。

trueの場合、サンプラーメトリックの収集を無効にします。サンプラーメトリックは、イベントベースではないメトリックです（CPU時間やメモリ使用量など）。

trueの場合、 Sequelインストルメンテーションを無効にします。

trueの場合、 Sidekiqインストルメンテーションを無効にします。

trueの場合、Roda のエージェント ミドルウェアを無効にします。このミドルウェアは、 ページの読み込みタイミング や エラー収集などの高度な機能のサポートを担当します。

trueの場合、Sinatra のエージェント ミドルウェアが無効になります。このミドルウェアは、ディストリビューティッド（分散）トレーシング、ページ読み込みタイミング、エラー収集などの高度な機能サポートを担当します。

trueの場合、ビューインストルメンテーションを無効にします。

trueの場合、エージェントはRubyVMからパフォーマンス測定値をサンプリングしません。

trueに設定すると、PumaマスタープロセスからRuby/Puma/*メトリクスをサンプリングするPumaサーバー統計の計装が無効になります。デフォルトでは、この計装は無効になっています。有効にした場合、エージェントはPumaマスタープロセスでレポートスレッドを開始し、これらのメトリクスを送信します。

trueの場合、エージェントは、段階トレース内のElasticsearchクラスタ名をキャプチャします。

trueの場合、エージェントはトランザクション追跡で Elasticsearch クエリをキャプチャします。

trueの場合、エージェントはトランザクション追跡で Elasticsearch クエリを難読化します。

trueの場合、エージェントはホスト名としてHerokudyno名を使用します。

通常、エージェントは、末尾にドットとプロセス ID を付けて dyno 名を報告します (例: worker.3 )。末尾のデータなしで報告するプレフィックスを指定することで、この末尾のデータを削除できます (たとえば、 worker )。

エージェントがサブスクライブするActiveSupport通知イベント名（主にキャッシュイベントとメッセージシリアライザーのイベント）の許可リストです。リストに含まれないイベント名は無視されます。cache_fetch_hit.active_supportのように、完全なイベント名を指定してください。アスタリスクや正規表現は使用できません。また、バックスラッシュで文字をエスケープすることもできません。

設定可能なイベント名の完全な一覧は、Railsドキュメントのキャッシュ関連のイベント名およびメッセージ関連のイベント名のリストを参照してください。

起動時のActiveSupport::BroadcastLoggerの自動計測を制御します。auto 、 prepend 、 chain 、 disabledのいずれかになります。Rails バージョン 7.1 以上で使用されます。

起動時のActiveSupport::Loggerの自動計測を制御します。auto 、 prepend 、 chain 、 disabledのいずれかになります。Rails 7.1 より前のバージョンで使用されます。

起動時の Async::HTTP の自動計測を制御します。auto 、 prepend 、 chain 、 disabledのいずれかになります。

起動時のバニーの自動計測を制御します。auto 、 prepend 、 chain 、 disabledのいずれかになります。

起動時のsemantic_loggerライブラリの自動インストゥルメンテーションを制御します。設定可能な値は次のとおりです：auto、prepend、chain、disabled。

起動時の並列ライブラリの自動インストゥルメンテーションを制御します。 auto 、 prepend 、 chain 、 disabledのいずれかになります。

起動時の AWS-sdk-firehose ライブラリの自動インストゥルメンテーションを制御します。 auto 、 prepend 、 chain 、 disabledのいずれかになります。

起動時の aws_sdk_lambda ライブラリの自動インストゥルメンテーションを制御します。 auto 、 prepend 、 chain 、 disabledのいずれかになります。

起動時の AWS-sdk-kinesis ライブラリの自動インストゥルメンテーションを制御します。 auto 、 prepend 、 chain 、 disabledのいずれかになります。

起動時のruby-kafkaライブラリの自動インストゥルメンテーションを制御します。 auto 、 prepend 、 chain 、 disabledのいずれかになります。

起動時の opensearch-ruby ライブラリの自動インストゥルメンテーションを制御します。 auto 、 prepend 、 chain 、 disabledのいずれかになります。

起動時の rdkafka ライブラリの自動インストゥルメンテーションを制御します。 auto 、 prepend 、 chain 、 disabledのいずれかになります。

起動時の AWS-sdk-sqs ライブラリの自動インストゥルメンテーションを制御します。 次のいずれかになります: auto 、 prepend 、 chain 、 disabled 。

起動時の AWS-sdk-dynamodb ライブラリの自動インストゥルメンテーションを制御します。 auto 、 prepend 、 chain 、 disabledのいずれかになります。

起動時のファイバー クラスの自動インスツルメンテーションを制御します。auto 、 prepend 、 chain 、 disabledのいずれかになります。

起動時の並行 Ruby ライブラリの自動インスツルメンテーションを制御します。auto 、 prepend 、 chain 、 disabledのいずれかになります。

起動時の Curb の自動計測を制御します。auto 、 prepend 、 chain 、 disabledのいずれかになります。

起動時の遅延ジョブの自動計測を制御します。auto 、 prepend 、 chain 、 disabledのいずれかになります。

起動時の elasticsearch ライブラリの自動インストルメンテーションを制御します。auto 、 prepend 、 chain 、 disabledのいずれかになります。

起動時のethonの自動インストゥルメンテーションを制御します。設定可能な値は次のとおりです：auto、prepend、chain、disabled。

起動時の Excon の自動計測を制御します。enabled 、 disabledのいずれかになります。

起動時の Grape の自動計測を制御します。auto 、 prepend 、 chain 、 disabledのいずれかになります。

起動時の gRPC クライアントの自動インストルメンテーションを制御します。auto 、 prepend 、 chain 、 disabledのいずれかになります。

New Relicにトラフィックを無視させるgRPCホスト名に一致する正規表現パターンをカンマ区切りで並べたリスト。ホスト名がリスト内のいずれかのパターンに一致する場合、New RelicのgRPCクライアント計装はそのホストへの呼び出しのトレースをスキップし、gRPCサーバー計装はそのホスト上で実行されているサーバーが受信するリクエストのトレースをスキップします。例："private.com$,exception.*" Empty by default, meaning no traffic is ignored.。

起動時の gRPC サーバーの自動インストルメンテーションを制御します。auto 、 prepend 、 chain 、 disabledのいずれかになります。

起動時の HTTPClient の自動インストルメンテーションを制御します。auto 、 prepend 、 chain 、 disabledのいずれかになります。

起動時の http.rb gem の自動インストルメンテーションを制御します。auto 、 prepend 、 chain 、 disabledのいずれかになります。

起動時のhttpxの自動インストゥルメンテーションを制御します。設定可能な値は次のとおりです：auto、prepend、chain、disabled。

Ruby標準ライブラリLoggerの起動時の自動計測を制御します。auto 、 prepend 、 chain 、 disabledのいずれかになります。

起動時のロギングライブラリの自動インストゥルメンテーションを制御します。 auto 、 prepend 、 chain 、 disabledのいずれかになります。

起動時の LogStasher ライブラリの自動インストゥルメンテーションを制御します。 次のいずれかになります: auto 、 prepend 、 chain 、 disabled 。

Rails.eventを構造化ログとして計装するかどうかを制御します。設定可能な値は次のとおりです：enabled、disabled。

構造化ログイベントとして取得するRails.event名の配列。例：[user.signup, payment.processed, order.created]。すべてのRails.event通知を取得するには、空のままにします。ここで指定したイベントは、イベントペイロードの:levelキーで上書きされない限り、UNKNOWNレベルでログに記録されます（フィルターで除外されることはありません）。

起動時に Memcache の dalli gem の自動インスツルメンテーションを制御します。auto 、 prepend 、 chain 、 disabledのいずれかになります。

起動時に Memcache の memcached gem の自動インストルメンテーションを制御します。auto 、 prepend 、 chain 、 disabledのいずれかになります。

起動時に Memcache の memcache-client gem の自動インストルメンテーションを制御します。auto 、 prepend 、 chain 、 disabledのいずれかになります。

起動時の Mongo の自動計測を制御します。enabled 、 disabledのいずれかになります。

起動時のNet::HTTPの自動計測を制御します。auto 、 prepend 、 chain 、 disabledのいずれかになります。

起動時の ruby-openai gem の自動インストゥルメンテーションを制御します。 次のいずれかになります: auto 、 prepend 、 chain 、 disabled 。高セキュリティ モードではデフォルトでdisabledになります。

Puma::Rackの自動計測を制御します。有効にすると、エージェントはPuma::Rack::Builderのto_appメソッドにフックして、アプリケーションの起動時に計測する gem を見つけます。auto 、 prepend 、 chain 、 disabledのいずれかです。

起動時のPuma::Rack::URLMapの自動計測を制御します。auto 、 prepend 、 chain 、 disabledのいずれかになります。

Rack の自動計測を制御します。有効にすると、エージェントはRack::Builderのto_appメソッドにフックして、アプリケーションの起動時に計測する gem を見つけます。auto 、 prepend 、 chain 、 disabledのいずれかです。

起動時のRack::URLMapの自動計測を制御します。auto 、 prepend 、 chain 、 disabledのいずれかになります。

起動時の rake の自動計測を制御します。auto 、 prepend 、 chain 、 disabledのいずれかになります。

起動時の Redis の自動インストルメンテーションを制御します。auto 、 prepend 、 chain 、 disabledのいずれかになります。

起動時の resque の自動計測を制御します。auto 、 prepend 、 chain 、 disabledのいずれかになります。

起動時の Roda の自動計測を制御します。auto 、 prepend 、 chain 、 disabledのいずれかになります。

起動時の Sinatra の自動計測を制御します。auto 、 prepend 、 chain 、 disabledのいずれかになります。

起動時の Stripe の自動計測を制御します。enabled 、 disabledのいずれかになります。

起動時に ViewComponent の自動実行を制御します。 auto 、 prepend 、 chain 、 disabledのいずれかになります。

起動時に Thread クラスの自動計測を制御して、エージェントが非同期トランザクション内でスパンを正しくネストできるようにします。これにより、エージェントは作成されたすべてのスレッドを自動的にトレースできなくなります ( instrumentation.thread.tracingを参照)。auto 、 prepend 、 chain 、 disabledのいずれかになります。

起動時に Thread クラスの自動インスツルメンテーションを制御し、アプリケーションで作成されたすべてのスレッドにトレースを自動的に追加します。

起動時の Tilt テンプレート レンダリング ライブラリの自動インストルメンテーションを制御します。auto 、 prepend 、 chain 、 disabledのいずれかになります。

起動時の Typhoeus の自動計測を制御します。auto 、 prepend 、 chain 、 disabledのいずれかになります。

trueの場合、エージェントはメッセージに関するメタデータを収集し、それらをセグメントパラメータとして添付します。

trueの場合、エージェントはトランザクショントレースでMongoクエリをキャプチャします。

trueの場合、エージェントはトランザクショントレースでMongoクエリを難読化します。

trueの場合、エージェントは、発言トレースで OpenSearch 書き込みをキャプチャします。

trueの場合、エージェントは現場トレースで OpenSearch 書き込みを難読化します。

New Relic経由で送信されるすべてのOpenTelemetryシグナルを無効にするためのグローバル設定オプション。falseに設定すると、OpenTelemetryシグナルはNew Relicに送信されません。trueに設定した場合は、シグナル固有の有効化設定オプション（例：opentelemetry.traces.enabled）に基づいて、そのシグナルタイプのテレメトリーがNew Relicに報告されるかどうかが決まります。

OpenTelemetryスパンからの瞬間トレース セグメントとタイムスライス メトリクスの作成を有効にします。 これは、OpenTelemetry スパンの New Relic UI エクスペリエンスの向上に役立ちます。

OpenTelemetryのカンマ区切りのリスト。文字列として表されます(例: "AppTracer1, OpenTelemetry ::計装::Bunny::計装")、トレースがNew Relicに送信されます。

OpenTelemetryのカンマ区切りのリスト。文字列として表されます(例: "AppTracer1,OpenTelemetry::Instrumentation::Bunny::Instrumentation")、トレースはNew Relicに送信されません。

New Relic UIに表示するカスタムホスト名を指定します。

trueに設定すると、継続的プロファイリングが有効になります。有効にするには、アプリケーションにstackprofとgoogle-protobufのgemがインストールされている必要があります。JRubyではサポートされていません。高セキュリティモードが有効になっている場合、継続的プロファイリングは自動的に無効になります。

継続的プロファイリングが有効になってから開始されるまでの遅延時間（ミリ秒）です。デフォルトは0で、遅延なしにプロファイリングが開始されます。

継続的プロファイリングが自動的に停止するまでの実行時間（ミリ秒）です。デフォルトは0で、明示的に停止しない限り、プロファイリングは無期限に実行されます。

継続的プロファイリングに使用するstackprofサンプリングモードです（cpuまたはobject）。

継続的プロファイラーがスタックサンプルを取得する間隔（秒）です。profiling.includeがcpuの場合にのみ使用されます。指定できる値は0.000001～0.999999です。

継続的プロファイラーがスタックサンプルを取得する間に発生するオブジェクトの割り当て回数です。profiling.includeがobjectの場合にのみ使用されます。指定できる値は1,000～999,999です。

Pumaマスタープロセスで取得されるPumaサーバー統計のサンプル間の秒数。

自動インストゥルメントするRakeタスクの配列を指定します。この設定オプションは、配列を正規表現リストに変換します。このリストに追加されない限り、Rakeタスクはインストルメントされません。デフォルトで全てのタスクを許可したい場合は、rake.tasks: [.+]を使用してください。詳細については、New RelicのRake計装に関するドキュメントを参照してください。

Rakeタスクを実行する前に接続の完了を待つ時間（秒）を指定します。

エージェントに無視させるトランザクションを、除外するURIに一致するパターンのリストで指定します。詳細については、特定のトランザクションを無視する方法に関するドキュメントを参照してください。

trueの場合、セキュリティエージェントがロードされます（Rubyの「require」が実行されます）。

trueの場合、セキュリティエージェントが起動します（エージェントはイベントループで実行されます）。

セキュリティエージェントが動作するモードを定義します。現時点では、IASTのみに対応しています。

セキュリティ関連データの送信先となるエンドポイントのURLを定義します。

アプリケーションがリッスンしているポート。この設定は Passenger サーバーでは必須です。エージェントはデフォルトで他のサーバーを検出します。

セキュリティ エージェントが IAST スキャンで無視する API パスを定義します。無視する URI に一致する正規表現パターンの配列を受け入れます。正規表現パターンは、エンドポイントのない URL に完全に一致するものを見つける必要があります。例えば、 [".*account.*"], [".*/\api\/v1\/.*?\/login"]

セキュリティ エージェントが IAST スキャンで無視する HTTP 要求ヘッダーの配列。配列には、無視するヘッダーに一致するパターンのリストを指定する必要があります。

HTTP リクエストの配列は、セキュリティ担当者がIASTスキャンで無視する必要があります。 配列には、HTTP リクエストに一致する無視するパターンのリストを指定する必要があります。

セキュリティ エージェントが IAST スキャンで無視する HTTP リクエスト本文キーの配列。

trueの場合、重大度の低い安全でない設定の検出を無効にします。例：ハッシュ、暗号、クッキー、乱数ジェネレーター、信頼境界。

trueの場合、ファイル操作関連の IAST 検出 (ファイル アクセスとアプリケーションの整合性違反) を無効にします。

trueの場合、IAST スキャンでの SQL インジェクション検出が無効になります。

trueの場合、IASTスキャンでのNOSQLインジェクション検出を無効にします。

trueの場合、IAST スキャンでの LDAP インジェクション検出が無効になります。

trueの場合、IASTスキャンでのJavaScriptインジェクション検出を無効にします。

trueの場合、IAST スキャンでのシステム コマンド インジェクション検出が無効になります。

trueの場合、IASTスキャンでのXPATHインジェクション検出を無効にします。

trueの場合、IASTスキャンでのサーバーサイドリクエストフォージェリ（SSRF）の検出を無効にします。

trueの場合、 IASTでの Reflected Cross-Site Script (RXSS) 検出を無効にします。

アプリケーションの起動後に IAST スキャンが開始されるまでの遅延時間 (分単位) を指定します。

IASTスキャンを実施する時間（分）を指定します。

IAST スキャンをいつ実行するかを設定する cron 式を指定します。

true場合、IAST はバックグラウンドでトレース データを継続的に収集できます。セキュリティ エージェントは収集されたデータを使用して、スケジュールされた時間に IAST スキャンを実行します。

IASTスキャンで1分あたりに許可されるHTTPリクエストの最大数を設定します。12～3600（デフォルト）の整数で指定してください。

IAST 分析を実行する特定のエンティティのアプリケーション インスタンスの数。

true場合、HTTP 応答本文の送信が有効になります。これを無効にすると、Reflected Cross-Site スクリプト (RXSS) の脆弱性検出も無効になります。

CI/CD環境でIASTを実行する際に、各テスト実行を区別するための固有のテスト識別子。例：ビルド番号。

trueの場合、エージェントは有効期間の短いサーバーレス機能での使用に適した合理化モードで動作します。 注意: 現在、 AWS Lambda 関数のみがサポートされており、このオプションはNew RelicのRuby Lambdaレイヤーオファリングなしで使用するためのものではありません。

Sidekiqジョブの引数のうち、New Relicに報告する引数を指定するための許可リスト（文字列の配列）。Sidekiqの引数をキャプチャするには、job.sidekiq.args.*を別のattributes.include設定オプションにも追加する必要があります。この配列内の各文字列はRegexp.newを介して正規表現に変換されるため、高度なパターンマッチングが可能です。ジョブ引数ハッシュの場合、キーまたは値のいずれかが一致すると、そのペアは対象となります。一致するジョブ引数の配列要素とスカラー値はすべて対象となります。

Sidekiqジョブの引数のうち、New Relicに報告しない引数を指定するための拒否リスト（文字列の配列）。Sidekiqの引数をキャプチャするには、job.sidekiq.args.*を別のattributes.include設定オプションにも追加する必要があります。この配列内の各文字列はRegexp.newを介して正規表現に変換されるため、高度なパターンマッチングが可能です。ジョブ引数ハッシュの場合、キーまたは値のいずれかが一致すると、そのペアは除外されます。一致するジョブ引数の配列要素とスカラー値はすべて除外されます。

trueの場合、エージェントは Sidekiq の再試行中に発生した例外を無視し、ジョブが永続的に失敗した場合にのみエラーを報告します。

trueに設定すると、エージェントは、ウェブトランザクション中にSidekiqジョブが実行された際、新しいトランザクションを開始します。これにより、Sidekiqジョブの実行時間がウェブトランザクションのメトリクスに含まれないようにできます。

trueの場合、エージェントは、クラスの許可リストに含まれる例外を除き、すべての例外からメッセージを削除します。高セキュリティモードでは、この設定が自動的に有効になります。

strip_exception_messagesがtrueの場合に、エージェントが削除しない例外のリストを指定します。例外はコンマで区切ります。たとえば、 "ImportantException,PreserveMessageException" 。

Stripe イベントのuser_dataハッシュ内のどのキーを New Relic に報告するかを指定する文字列の配列。この配列内の各文字列は、高度な一致を可能にするためにRegexp.newを介して正規表現に変換されます。値を["."]に設定すると、すべてのuser_dataが報告されます。

Stripe イベントのuser_dataハッシュ内のどのキーや値を New Relic に報告しないかを指定する文字列の配列。この配列内の各文字列は、高度な一致を可能にするためにRegexp.newを介して正規表現に変換されます。各ハッシュ ペアについて、キーまたは値のいずれかが一致する場合、そのペアは報告されません。デフォルトでは、 user_dataは報告されません。このオプションは、 stripe.user_data.includeオプションも使用されている場合にのみ使用してください。

trueの場合、スレッドプロファイラーの使用を有効にします。

trueの場合、エージェントはAWS環境で実行されていることを自動的に検出します。

trueの場合、エージェントはAzure環境で実行されていることを自動的に検出します。

trueの場合、エージェントはDockerで実行されていることを自動的に検出します。

trueの場合、エージェントはGoogleCloudPlatform環境で実行されていることを自動的に検出します。

trueに設定すると、Google Cloud Run（Services、Worker Pools、Jobs）上で動作するエージェントは、GCPインスタンスIDをホスト名として報告します。

trueに設定すると、エージェントがGoogle Cloud Run上でホスト名を生成する際、GCPインスタンスIDの前にCloud Runリビジョン名を付加します（{revision}-{instance id}）。リビジョン名は、Cloud Run ServiceではK_REVISION、Cloud Run Worker PoolではCLOUD_RUN_REVISION、Cloud Run JobではCLOUD_RUN_EXECUTIONから取得されます。ただし、この設定が有効になるには、utilization.gcp_cloud_run.use_instance_as_hostもtrueに設定する必要があります。

trueの場合、エージェントはKubernetesで実行されていることを自動的に検出します。

trueの場合、エージェントはPivotalCloudFoundry環境で実行されていることを自動的に検出します。

trueの場合、エージェントは環境検出を並行して実行し、エージェントの起動時間を短縮します。