Code-level metrics allow developers using the New Relic CodeStream extension to see APM data displayed contextually in their IDE, alongside individual methods in the code. This allows developers to be more proactive about addressing performance issues as they write and review code.
Getting started
First, install the New Relic CodeStream extension into your supported IDE of choice and log in.
Important
Code-level metrics are available in Ruby agent version 8.8.0 and higher. For versions 8.10.0 and higher, code-level metrics are enabled by default. For versions 8.8.0 and 8.9.0 they must be enabled via configuration. To enable code-level metrics, either set code_level_metrics.enabled: true in newrelic.yml or NEW_RELIC_CODE_LEVEL_METRICS_ENABLED=true as an environment variable.
Agent attributes
The Ruby agent reports and attaches the following attributes to spans produced by your application:
Name | Description | Example |
|---|---|---|
| The name of the instrumented function (Ruby method). Note that class methods will be prefixed by | create |
| The absolute path to the source code file in which | /app/app/controllers/widgets_controller.rb |
| The line number where | 1138 |
| The namespace (class or module name) in which | WidgetsController |
Important
Not every method in your application code will be instrumented with the above attributes. As of version 8.10.0, the Ruby agent will provide code-level metrics for Rails controller methods, ActiveJob methods, and any Ruby method which has been configured to be manually traced.