Skip to content

Commit

Permalink
Merge branch 'develop' into pr/16531
Browse files Browse the repository at this point in the history
  • Loading branch information
rhetoric101 committed Mar 15, 2024
2 parents 7035209 + 7c0b986 commit bfadc3f
Show file tree
Hide file tree
Showing 174 changed files with 81,940 additions and 544 deletions.
2 changes: 1 addition & 1 deletion package.json
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@
"@emotion/styled": "^11.3.0",
"@mdx-js/mdx": "2.0.0-next.8",
"@mdx-js/react": "2.0.0-next.8",
"@newrelic/gatsby-theme-newrelic": "9.3.1",
"@newrelic/gatsby-theme-newrelic": "9.3.2",
"@splitsoftware/splitio-react": "^1.2.4",
"ansi-colors": "^4.1.3",
"cockatiel": "^3.0.0-beta.0",
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -480,7 +480,7 @@ Use SqlClient from [System.Data.SqlClient](https://www.nuget.org/packages/System

<DoNotTranslate>**Microsoft.Data.SqlClient**</DoNotTranslate>
* Minimum supported version: 1.0.19239.1
* Verified compatible versions: 1.0.19239.1, 2.1.5, 3.1.1, 4.1.1, 5.0.1, 5.1.1
* Verified compatible versions: 1.0.19239.1, 2.1.5, 3.1.1, 4.1.1, 5.0.1, 5.1.1, 5.2.0
</td>
</tr>

Expand Down Expand Up @@ -521,7 +521,7 @@ Prior versions of Npgsql may also be instrumented, but duplicate and/or missing
<td>
Minimum supported version: 2.3.0

Verified compatible versions: 2.3.0, 2.8.1, 2.13.1, 2.14.1, 2.17.1, 2.19.0, 2.20.0, 2.21.0, 2.22.0, 2.23.0, 2.23.1
Verified compatible versions: 2.3.0, 2.8.1, 2.13.1, 2.14.1, 2.17.1, 2.19.0, 2.20.0, 2.21.0, 2.22.0, 2.23.0, 2.23.1, 2.24.0

Beginning in agent version 10.12.0, the following methods added in or after driver version 2.7 are instrumented:
* IMongoCollection.CountDocuments[Async]
Expand Down Expand Up @@ -573,7 +573,7 @@ Use [MySql.Data](https://www.nuget.org/packages/MySql.Data/) or [MySQL Connector
<td>
Minimum supported version: .0.488

Verified compatible versions: 1.0.488, 1.1.608, 1.2.6, 2.0.601, 2.1.58, 2.2.88, 2.6.66, 2.6.116, 2.7.4, 2.7.10, 2.7.17
Verified compatible versions: 1.0.488, 1.1.608, 1.2.6, 2.0.601, 2.1.58, 2.2.88, 2.6.66, 2.6.116, 2.7.4, 2.7.10, 2.7.17, 2.7.33
</td>
</tr>

Expand Down Expand Up @@ -796,7 +796,7 @@ Use [Elastic.Clients.Elasticsearch](https://www.nuget.org/packages/Elastic.Clien
9.7.0
</td>
<td>
2.0.10, 2.0.12, 2.0.13, 2.0.14
2.0.10, 2.0.12, 2.0.13, 2.0.14, 2.0.16
</td>

</tr>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -548,7 +548,7 @@ Use SqlClient from [System.Data.SqlClient](https://www.nuget.org/packages/System

<DoNotTranslate>**Microsoft.Data.SqlClient**</DoNotTranslate>
* Minimum supported version: 1.0.19239.1
* Verified compatible versions: 1.0.19239.1, 2.1.5, 3.1.1, 4.1.1, 5.0.1, 5.1.1
* Verified compatible versions: 1.0.19239.1, 2.1.5, 3.1.1, 4.1.1, 5.0.1, 5.1.1, 5.2.0

<DoNotTranslate>**System.Data**</DoNotTranslate>
* Minimum supported version: .NET Framework 4.6.2
Expand Down Expand Up @@ -591,7 +591,7 @@ Known incompatible versions: Instance details aren't available in lower version
<td>
Minimum supported version: 2.3.0

Verified compatible versions: 2.3.0, 2.8.1, 2.13.1, 2.14.1, 2.17.1, 2.19.0, 2.20.0, 2.21.0, 2.22.0, 2.23.0, 2.23.1
Verified compatible versions: 2.3.0, 2.8.1, 2.13.1, 2.14.1, 2.17.1, 2.19.0, 2.20.0, 2.21.0, 2.22.0, 2.23.0, 2.23.1. 2.24.0

Beginning in agent version 10.12.0, the following methods added in or after driver version 2.7 are instrumented:
* `IMongoCollection.CountDocuments[Async]`
Expand Down Expand Up @@ -695,7 +695,7 @@ Prior versions of Npgsql may also be instrumented, but duplicate and/or missing
</td>
<td>
* Minimum supported version: 1.0.488
* Verified compatible versions: 1.0.488, 1.1.608, 1.2.6, 2.0.601, 2.1.58, 2.2.88, 2.6.66, 2.6.116, 2.7.4, 2.7.10, 2.7.17
* Verified compatible versions: 1.0.488, 1.1.608, 1.2.6, 2.0.601, 2.1.58, 2.2.88, 2.6.66, 2.6.116, 2.7.4, 2.7.10, 2.7.17, 2.7.33
</td>
</tr>

Expand Down Expand Up @@ -863,7 +863,7 @@ Use [Elastic.Clients.Elasticsearch](https://www.nuget.org/packages/Elastic.Clien
9.7.0
</td>
<td>
1.2.10, 2.0.5, 2.0.14
1.2.10, 2.0.5, 2.0.14, 2.0.16
</td>
</tr>

Expand Down
18 changes: 15 additions & 3 deletions src/content/docs/codestream/observability/code-level-metrics.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
title: Code-level metrics
metaDescription: "See performance data at the method level."
redirects:
freshnessValidatedDate: never
freshnessValidatedDate: 2024-03-14
---

import codestreamCodeLevelMetricsExample from 'images/codestream_screenshot-crop_code-level-metrics-example.webp'
Expand All @@ -29,12 +29,24 @@ Click the CodeLens to see charts visualizing each of the metrics. If the reposit

Along with a chart of the error rate you’ll also see a list of the actual errors happening in the same timeframe, including the number of occurrences for each. If the error rate is spiking, and you see one particular error is causing the problem, you can click on it to view the stack trace and [start collaborating](/docs/codestream/observability/error-investigation) on resolution.

## Requirements [#requirements]
## Coverage [#coverage]

To see in-editor performance data, your service must meet the requirements listed below, and the service should have collected data in the last 30 minutes. The New Relic agent attempts to automatically collect data for functions on classes that are tied to HTTP requests. In many cases, and with many frameworks that use an MVC framework, these are often methods on a Controller class.
The New Relic agent attempts to automatically collect data for functions on classes that are tied to HTTP requests. In many cases, and with many frameworks that use an MVC framework, these are often methods on a Controller class.

Because all requests by the New Relic agent are not collected all the time, it’s possible that low-traffic methods won't see any data. If data is missing for a specific method that you wish to see results for, you can use custom instrumentation to fill any gaps. See guidance for [Java](/docs/apm/agents/java-agent/custom-instrumentation/java-custom-instrumentation), [.NET](/docs/apm/agents/net-agent/custom-instrumentation/introduction-net-custom-instrumentation), [PHP](/docs/apm/agents/php-agent/features/php-custom-instrumentation), [Python](/docs/apm/agents/python-agent/custom-instrumentation/python-custom-instrumentation), [Ruby](/docs/apm/agents/ruby-agent/api-guides/ruby-custom-instrumentation), [Go](/docs/apm/agents/go-agent/instrumentation/instrument-go-transactions) and [Node.js](/docs/apm/agents/nodejs-agent/extend-your-instrumentation/nodejs-custom-instrumentation).

Run the following NRQL query to identify where you might see CodeLenses with code-level metrics for one of your services. Just replace the example `entity.guid` value with the one for the given service. In the query results, look at the `code.*` attributes to see if any of them represent your code, and not framework code.

```
SELECT *
FROM Span
WHERE entity.guid = 'MXxBUE18QVBQTElDQVRJT058MjM' AND code.function is not null
SINCE 30 minutes ago LIMIT MAX
```
## Requirements [#requirements]

To see in-editor performance data, your service must meet the requirements listed below, and the service should have collected data in the last 30 minutes.

* [Distributed tracing](/docs/distributed-tracing/enable-configure/language-agents-enable-distributed-tracing) must be enabled. Distributed tracing is on by default in recent versions of all agents, so you only need to worry about this if you've disabled distributed tracing.
* <DoNotTranslate>**Go:**</DoNotTranslate> Requires Go agent version 3.24.0 or higher. If you're using VS Code, you must also have the [Go for VS Code](https://marketplace.visualstudio.com/items?itemName=golang.go) extension installed with the language server enabled.
* <DoNotTranslate>**Java:**</DoNotTranslate> Requires Java agent version 7.11.0 or higher. Code-level metrics are only available for projects implemented with a [supported Java framework](/docs/apm/agents/java-agent/getting-started/compatibility-requirements-java-agent/#frameworks). If you're using VS Code, you must also have the [Language Support for Java by Red Hat](https://marketplace.visualstudio.com/items?itemName=redhat.java) extension installed. Note that Kotlin support is only available in IntelliJ.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -96,6 +96,7 @@ To enable and use custom attributes for APM, follow the procedure for your <Inli
title="Java"
>
Custom attribute collection is enabled by default in Java. You can collect custom attributes using XML and the Java agent APIs. These two methods can be used in conjunction with each other.
Note that collecting custom attributes requires that the [New Relic Java API jar](/docs/apm/agents/java-agent/api-guides/guide-using-java-agent-api) be in the application's classpath.

<table>
<thead>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -21,7 +21,7 @@ Our JMX [integration](/docs/integrations/host-integrations/getting-started/intro
Before installing the integration, make sure that you meet the following requirements:

* A New Relic account. Don't have one? [Sign up for free!](https://newrelic.com/signup) No credit card required.
* Java versions 8 or higher.
* Java version 8 or higher.
* If you need to use a different Java version than the one configured in `PATH`, follow [New Relic's configuration documentation on GitHub](https://github.com/newrelic/nrjmx#configuring-java-version).
* This integration does not support the IIOP protocol.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -1555,7 +1555,7 @@ Metrics can also be enriched with extended cloud metadata (including custom reso
<td>
Linux: `etc/newrelic-infra/integrations.d/`

Windows: `\Program Files\NewRelic\newrelic-infra\inregrations.d`
Windows: `\Program Files\NewRelic\newrelic-infra\integrations.d`
</td>

<td>
Expand Down
10 changes: 10 additions & 0 deletions src/content/docs/logs/ui-data/use-logs-ui.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -404,6 +404,16 @@ Depending on your New Relic subscription, you can access your logs from several
Go to <DoNotTranslate>**[one.newrelic.com > All capabilities](https://one.newrelic.com/all-capabilities) > All entities > (select an entity) > Logs**</DoNotTranslate>.
</td>
</tr>

<tr>
<td>
From your IDE
</td>

<td>
[Install New Relic's CodeStream extension](/docs/codestream/start-here/install-codestream) to view logs in your IDE.
</td>
</tr>
</tbody>
</table>

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ tags:
metaDescription: "New Relic's Cordova agent for Android and iOS: Features, compatibility, requirements, installation, and upgrade procedures."
redirects:
- /docs/mobile-monitoring/new-relic-mobile-cordova-phonegap/get-started/new-relic-cordova-overview
- /docs/mobile-monitoring/new-relic-mobile-cordova-phonegap/get-started/introduction-new-relic-cordova
- /docs/mobile-monitoring/new-relic-mobile-cordova-phonegap/get-started/introduction-new-relic-cordova
freshnessValidatedDate: never
---

Expand Down Expand Up @@ -45,7 +45,7 @@ If you need to install the agent manually, follow these steps:

### Create an application token(s) [#app-token]

1. Go to <DoNotTranslate>**[one.newrelic.com](https://onenr.io/02wdd6ngXwE) > Browser & Mobile > (choose Android or iOS)**</DoNotTranslate>, then complete the instrumentation steps in the UI.
1. Go to <DoNotTranslate>**[one.newrelic.com](https://onenr.io/02wdd6ngXwE) > Browser & Mobile > (choose Android or iOS)**</DoNotTranslate>, then complete the instrumentation steps in the UI.
2. From <DoNotTranslate>**Step 4**</DoNotTranslate> in the UI, copy the application token(s) (one for iOS and Android if applicable).

</Step>
Expand Down Expand Up @@ -85,10 +85,12 @@ Add the following optional configurations to the `--variable` argument, which wi
* `COLLECTOR_ADDRESS`: Specifies the URI authority component of the harvest data upload endpoint.
* `CRASH_COLLECTOR_ADDRESS`: Specifies the authority component of the crash data upload URI.
* `FEDRAMP_ENABLED`: Enable or disable reporting data using different endpoints for US government clients.
* Possible values are `true` and `false`. Defaults to `false`.
* Possible values are `true` and `false`. Defaults to `false`.
* `OFFLINE_STORAGE_ENABLED`: Enable or disable offline data storage when no internet connection is available.
* Possible values are `true` and `false`. Defaults to `true`.

These options are only available on Cordova agent v6.2.1 and higher.

For example, if you wanted to disable crash reporting, call the following:

```
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -54,20 +54,20 @@ Before you install the Flutter agent, make sure your Flutter app meets these ver
</Step>
<Step>
### Add the Flutter agent to your project [#add-agent]
First, you'll need to add the Flutter agent into your dart project. In your `pubspec.yaml`, add the following to `dependencies`:
First, you'll need to add the Flutter agent into your dart project. In your `pubspec.yaml`, add the following to `dependencies`:
```dart
dependencies:
newrelic_mobile: 0.0.1
```
</Step>
<Step>
### Copy your application token [#app-token]
The application token is used for New Relic to authenticate your Flutter app's data.
The application token is used for New Relic to authenticate your Flutter app's data.
To view and copy your application token in the New Relic UI:
1. Go to <DoNotTranslate>**[one.newrelic.com](https://one.newrelic.com/all-capabilities)**</DoNotTranslate>, click <DoNotTranslate>**Add data**</DoNotTranslate>, then click <DoNotTranslate>**Mobile**</DoNotTranslate>.
2. Select your Flutter app.
2. Select your Flutter app.
3. Go to <DoNotTranslate>**Settings > Application**</DoNotTranslate> and copy the displayed <DoNotTranslate>**Application token**</DoNotTranslate>.


You'll add this application token in the next step.
</Step>
Expand All @@ -78,9 +78,9 @@ In your Flutter project, open `main.dart` and add the following code:
import 'package:newrelic_mobile/newrelic_mobile.dart';
var appToken = "";
if (Platform.isAndroid) {
appToken = "<android app token>"; // Replace with your application token copied from the New Relic UI.
appToken = "<android app token>"; // Replace with your application token copied from the New Relic UI.
} else if (Platform.isIOS) {
appToken = "<ios app token>"; // Replace with your application token copied from the New Relic UI.
appToken = "<ios app token>"; // Replace with your application token copied from the New Relic UI.
}
Config config =
Config(accessToken: appToken,
Expand Down Expand Up @@ -108,6 +108,8 @@ import 'package:newrelic_mobile/newrelic_mobile.dart';
httpInstrumentationEnabled:true,
// Optional: Enable or disable reporting data using different endpoints for US government clients
fedRampEnabled: false,
// Optional: Enable or disable offline data storage when no internet connection is available.
offlineStorageEnabled: true
);
NewrelicMobile.instance.start(config, () {
runApp(MyApp());
Expand Down Expand Up @@ -204,7 +206,7 @@ The following customizations are available for the Flutter agent.
<td id="create-custom">
Record errors.
</td>

<td>
[Record errors](/docs/mobile-monitoring/new-relic-mobile/mobile-sdk/record-errors)
</td>
Expand Down Expand Up @@ -247,13 +249,11 @@ The following customizations are available for the Flutter agent.
<td>
Shut down the agent.
</td>

<td>
[Shut down the agent](/docs/mobile-monitoring/new-relic-mobile/mobile-sdk/shut-down-agent)
</td>
</tr>

<tr>
<tr>
<td>
Enable/disable default mobile monitoring settings.
</td>
Expand All @@ -262,13 +262,10 @@ The following customizations are available for the Flutter agent.
[Enable/disable monitoring features](/docs/mobile-monitoring/new-relic-mobile/mobile-sdk/configure-settings)
</td>
</tr>


<tr>
<tr>
<td>
Run a test crash report.
</td>

<td>
[Test crash reporting](/docs/mobile-monitoring/new-relic-mobile/mobile-sdk/test-crash-reporting)
</td>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -41,7 +41,7 @@ If you need to install the agent manually, follow these steps:

### Create an application token(s) [#app-token]

1. Go to <DoNotTranslate>**[one.newrelic.com](https://onenr.io/0EjOpynz0Q6) > Browser & Mobile > (choose Android or iOS)**</DoNotTranslate>, then complete the instrumentation steps in the UI.
1. Go to <DoNotTranslate>**[one.newrelic.com](https://onenr.io/0EjOpynz0Q6) > Browser & Mobile > (choose Android or iOS)**</DoNotTranslate>, then complete the instrumentation steps in the UI.
2. From <DoNotTranslate>**Step 4**</DoNotTranslate> in the UI, copy the application token(s) (one for iOS and Android if applicable).

</Step>
Expand Down Expand Up @@ -110,6 +110,8 @@ let agentConfig : AgentConfiguration = {
sendConsoleEvents: true,
// Optional:Enable or disable reporting data using different endpoints for US government clients
//fedRampEnabled: false
// Optional: Enable or disable offline data storage when no internet connection is available.
offlineStorageEnabled: true
}
NewRelicCapacitorPlugin.start({appKey:appToken, agentConfiguration:agentConfig})
```
Expand Down Expand Up @@ -140,7 +142,6 @@ Make sure you paste your application token(s) into `appToken = ""` in the code a
```groovy
apply plugin: "com.android.application"
apply plugin: 'newrelic' // <-- add this
```
4. Make sure your app requests `INTERNET` and `ACCESS_NETWORK_STATE` permissions by adding these lines to your `AndroidManifest.xml`:
```
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -81,7 +81,7 @@ using NewRelic.MAUI.Plugin;
CrossNewRelic.Current.HandleUncaughtException();
CrossNewRelic.Current.TrackShellNavigatedEvents();
// Set optional agent configuration
// Options are: crashReportingEnabled, loggingEnabled, logLevel, collectorAddress, crashCollectorAddress,analyticsEventEnabled, networkErrorRequestEnabled, networkRequestEnabled, interactionTracingEnabled,webViewInstrumentation, fedRampEnabled
// Options are: crashReportingEnabled, loggingEnabled, logLevel, collectorAddress, crashCollectorAddress, analyticsEventEnabled, networkErrorRequestEnabled, networkRequestEnabled, interactionTracingEnabled, webViewInstrumentation, fedRampEnabled, offlineStorageEnabled
// AgentStartConfiguration agentConfig = new AgentStartConfiguration(crashReportingEnabled:false);
if (DeviceInfo.Current.Platform == DevicePlatform.Android)
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -83,7 +83,7 @@ using NewRelic.Xamarin.Plugin;
CrossNewRelicClient.Current.HandleUncaughtException();
CrossNewRelicClient.Current.TrackShellNavigatedEvents()
// Set optional agent configuration
// Options are: crashReportingEnabled, loggingEnabled, logLevel, collectorAddress, crashCollectorAddress,analyticsEventEnabled, networkErrorRequestEnabled, networkRequestEnabled, interactionTracingEnabled,webViewInstrumentation, fedRampEnabled
// Options are: crashReportingEnabled, loggingEnabled, logLevel, collectorAddress, crashCollectorAddress, analyticsEventEnabled, networkErrorRequestEnabled, networkRequestEnabled, interactionTracingEnabled, webViewInstrumentation, fedRampEnabled, offlineStorageEnabled
// AgentStartConfiguration agentConfig = new AgentStartConfiguration(crashReportingEnabled:false);
if (Device.RuntimePlatform == Device.Android)
Expand Down
Loading

0 comments on commit bfadc3f

Please sign in to comment.