アトリビュート は、イベントやトランザクションのプロパティを決定する情報を含むキーとバリューのペアです。これらのキー・バリュー・ペアは、APMのトランザクション・トレース、APMのトレースされたエラー、ダッシュボードのトランザクション・イベント、ダッシュボードのページ・ビューで見ることができます。どの属性がこれらの各送信先に送信されるかを正確にカスタマイズすることができます。
これらの属性設定は、Rubyエージェントのバージョン3.12.0以降に適用されます。
Rubyエージェントの属性
次の表は、Rubyエージェントが自動的に取り込むことができる属性の一覧です。
Webリクエストの応答ステータスコードです。デフォルトでは
HTTPリファラーヘッダーが存在する場合は、クエリー文字列を除いたもの。デフォルトでは
- トランザクションのトレース。無効です。
- エラーコレクター（トレースされたエラー）。有効
- トランザクションイベント。使用不可
- ページビュー（ブラウザモニタリング）。利用不可
HTTP リクエスト パラメータはトランザクションに関連付けられます。Rails、Sinatra、Roda、および Grape アプリケーションでのみ利用可能です。デフォルト:
- トランザクションのトレース。無効です。
- エラーコレクター（トレースされたエラー）。無効です。
- トランザクションイベント。使用不可
- ページビュー（ブラウザ監視）。使用不可
Resque ワーカーに渡されるジョブの引数。Resque ワーカーに渡される引数は位置に応じたものです。これらの引数は、 job.resque.args.<position>形式のキーとして保存されます。ここで、position は、 performメソッドへの引数のインデックスです。たとえば、2 つの引数を取る Resque ジョブにはキーjob.resque.args.0とjob.resque.args.1があります。デフォルト:
Sidekiq ワーカーに渡されるジョブの引数。Sidekiq ワーカーに渡される引数は位置に応じたものです。これらの引数は、 job.sidekiq.args.<position>形式のキーとして保存されます。ここで、position は、 performメソッドへの引数のインデックスです。たとえば、2 つの引数を取る Sidekiq ジョブにはキーjob.sidekiq.args.0とjob.sidekiq.args.1があります。デフォルト:
カスタム属性の追加
アプリケーションから追加のカスタム属性を取得するには、 NewRelic::Agent.add_custom_attributesを使用します。詳細については、 「カスタム属性の収集」を参照してください。デフォルト:
- トランザクションのトレースEnabled
- エラーコレクター（トレースされたエラー）。有効
- トランザクションイベント。有効
- ページビュー（ブラウザ監視）。使用不可
注意
カスタムパラメータや属性を照会したい場合は、その命名に 予約語 を使わないようにしましょう。
Rubyエージェントのアップグレード
Rubyエージェント 3.12.0 以上にアップグレードする場合は、newrelic.yml 設定をアップグレードしてください。