Skip to content

Commit

Permalink
Merge pull request #15147 from cthomas-newrelic/release/android-720
Browse files Browse the repository at this point in the history
chore: add, update Android docs
  • Loading branch information
bradleycamacho committed Nov 15, 2023
2 parents e52e0e4 + 4e8d740 commit 474c24e
Show file tree
Hide file tree
Showing 2 changed files with 64 additions and 1 deletion.
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ redirects:
- /docs/mobile-monitoring/new-relic-mobile-android/install-configure/configure-new-relic-gradle-plugin-extension
---

The New Relic Gradle plugin extension allows you to configure the behavior of plugin tasks executed during Gradle builds. Create a plugin extension in the `build.gradle` files that apply the New Relic plugin, then add any of the following configuration options:
The New Relic Gradle plugin extension allows you to configure the behavior of plugin tasks executed during Gradle builds. Create a plugin extension in the Gradle build files that apply the New Relic plugin, then add any of the following configuration options:

<table>
<thead>
Expand Down Expand Up @@ -57,6 +57,19 @@ The New Relic Gradle plugin extension allows you to configure the behavior of pl
Exclude specific variants from instrumentation during builds. Default: 'None'
</td>
</tr>

<tr>
<td>
`excludePackageInstrumentation`
</td>

<td>
Exclude specific classes whose package name starts with or includes class name patterns from instrumentation during builds. This feature can help when
encountering sensitive or problematic class data. Default: 'None'

Supported when used with Gradle 7.4 and higher.
</td>
</tr>
</tbody>
</table>

Expand All @@ -79,6 +92,9 @@ Here are some simple examples showing how to apply plugin configuration options
// instrument all variants
excludeVariantInstrumentation("")
// Exclude sample classes from instrumentation (regexp supported)
excludePackageInstrumentation("")
}
```
</Collapser>
Expand Down Expand Up @@ -124,4 +140,18 @@ Here are some simple examples showing how to apply plugin configuration options
}
```
</Collapser>

<Collapser
id="app-level"
title="Disable instrumentation of specific classes"
>
You can specificy multiple package patterns, separated by commas, with support for Regexp patterns:

```gradle
newrelic {
// Don't instrument sample classes
excludePackageInstrumentation("com.sample", "org.bouncycastle.*")
}
```
</Collapser>
</CollapserGroup>
Original file line number Diff line number Diff line change
@@ -0,0 +1,33 @@
---
subject: Android agent
releaseDate: '2023-11-15'
version: 7.2.0
downloadLink: 'https://download.newrelic.com/android_agent/ant/NewRelic_Android_Agent_7.2.0.zip'
---

## New

### Adds configurable request header instrumentation to network events

The agent will now produce network event attributes for select header values if the headers are detected on the request. The header names to instrument are passed into the agent when started.

For more information, see [Adding Tracked Headers](https://docs.newrelic.com/docs/mobile-monitoring/new-relic-mobile/mobile-sdk/add-tracked-headers) in the Mobile Monitoring documentation.

### Adds GraphQL attributes to network events

If the agent detects request headers from Apollo GraphQL servers, it will add additional attributes to the network request event.

For more information, see [Adding Tracked Headers](https://docs.newrelic.com/docs/mobile-monitoring/new-relic-mobile/mobile-sdk/add-tracked-headers) in the Mobile Monitoring documentation.

### Exclude instrumentation by package name

The agent plugin can now be configured to exclude classes from a specific package space during instrumentation. These classes will be unmodified. This feature can be useful when encountering sensitive or problematic class data.

For more information, see [Configure the New Relic Gradle plugin](https://docs.newrelic.com/docs/mobile-monitoring/new-relic-mobile-android/install-configure/configure-new-relic-gradle-plugin/).

## Fixed
* Exclude signed jars from instrumentation

## Support statement

We recommend you to upgrade the agent at least every 3 months. The specific policies and dates for Android agent support of the can be found in the [Mobile monitoring agents EOL policy](https://docswebsitedevelop-cthomasnewrelicdocswebsiterele.gatsbyjs.io/docs/mobile-monitoring/new-relic-mobile/get-started/mobile-agents-eol-policy/#android-eol).

0 comments on commit 474c24e

Please sign in to comment.