Merge pull request #19791 from ndesai-newrelic/develop

docs: android agent release
newrelic · Jan 28, 2025 · e0b74e8 · e0b74e8
2 parents 99b8eb1 + 4be41c9
commit e0b74e8
Show file tree

Hide file tree

Showing 3 changed files with 70 additions and 6 deletions.
diff --git a/...ew-relic-mobile-android/install-configure/configure-new-relic-gradle-plugin.mdx b/...ew-relic-mobile-android/install-configure/configure-new-relic-gradle-plugin.mdx
@@ -69,6 +69,20 @@ The New Relic Gradle plugin extension allows you to configure the behavior of pl
         Supported when used with Gradle 7.4 and higher.
       </td>
     </tr>
+
+    <tr>
+      <td>
+        `logInstrumentationEnabled`
+      </td>
+
+      <td>
+          Replaces Android Util Log Classes with NewRelic Log Method for log reporting
+          * Default: `true`
+
+          Supported when used with Gradle 7.4 and higher.
+      </td>
+    </tr>
+
   </tbody>
 </table>
 
@@ -94,6 +108,9 @@ Here are some simple examples showing how to apply plugin configuration options
 
         // Exclude sample classes from instrumentation (regexp supported)
         excludePackageInstrumentation("")
+
+        // Enable log instrumentation
+        logInstrumentationEnabled true
     }
     ```
   </Collapser>
@@ -153,4 +170,18 @@ Here are some simple examples showing how to apply plugin configuration options
     }
     ```
   </Collapser>
+
+  <Collapser
+    id="app-level"
+    title="Disable log instrumentation"
+  >
+    To disable log instrumentation:
+
+    ```gradle
+    newrelic {
+         // disable log instrumentation
+        logInstrumentationEnabled false
+    }
+    ```
+  </Collapser>
 </CollapserGroup>
diff --git a/...mobile-monitoring/new-relic-mobile-xamarin/monitor-your-xamarin-application.mdx b/...mobile-monitoring/new-relic-mobile-xamarin/monitor-your-xamarin-application.mdx
@@ -9,6 +9,18 @@ metaDescription: "New Relic's Xamarin agent for Android and iOS: Features, compa
 freshnessValidatedDate: never
 ---
 
+   <Callout variant="important">
+   Deprecation and end of support for NewRelic Xamarin NuGet package.
+
+   On May 1, 2024, Microsoft will end support for all Xamarin SDKs. For this reason, we're deprecating the NewRelic Xamarin NuGet package in July 2024. We will let you know in which upcoming package version we will be only fixing bugs and addressing important security issues.
+
+  Also, in accordance with the NewRelic Support Policy, we will end support for the NewRelic Xamarin NuGet package in July 2025.
+
+  We recommend that you upgrade your Xamarin projects to .NET and use the NewRelic .NET MAUI NuGet package instead of the deprecated Xamarin NuGet package.
+
+   </Callout>
+
+
 Our New Relic Xamarin agent monitors your Xamarin mobile app and provides deep insights into your app's performance, errors, and user experience. Once you install and configure the Xamarin agent, you'll be able to:
 
 * <DNT>**Capture C# errors:**</DNT> Identify and fix problems quickly.
@@ -88,11 +100,11 @@ If you need to install the agent manually, follow these steps:
           Application.Current.PageDisappearing += PageDisappearing;
           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, newEventSystemEnabled, backgroundReportingEnabled
           // AgentStartConfiguration agentConfig = new AgentStartConfiguration(crashReportingEnabled:false);
 
@@ -101,7 +113,7 @@ If you need to install the agent manually, follow these steps:
             CrossNewRelicClient.Current.Start("YOUR_APP_TOKEN");
             // Start with optional agent configuration
             // CrossNewRelicClient.Current.Start("YOUR_APP_TOKEN", agentConfig);
-          } 
+          }
           else if (Device.RuntimePlatform == Device.iOS)
           {
             CrossNewRelicClient.Current.Start("YOUR_APP_TOKEN");
@@ -258,4 +270,4 @@ The following customizations are available for the Xamarin agent.
 
 Missing HTTP data in the UI?
 
-After installing the .NET MAUI agent, wait at least 5 minutes. If <DNT>**No HTTP data appears:**</DNT> on the HTTP errors and HTTP requests UI pages, make sure you used `HttpMessageHandler` in `HttpClient`.
+After installing the Xamarin agent, wait at least 5 minutes. If <DNT>**No HTTP data appears:**</DNT> on the HTTP errors and HTTP requests UI pages, make sure you used `HttpMessageHandler` in `HttpClient`.
diff --git a/...t/docs/release-notes/mobile-release-notes/android-release-notes/android-763.mdx b/...t/docs/release-notes/mobile-release-notes/android-release-notes/android-763.mdx
@@ -0,0 +1,21 @@
+---
+subject: Android agent
+releaseDate: '2025-01-24'
+version: 7.6.3
+downloadLink: 'https://download.newrelic.com/android_agent/ant/NewRelic_Android_Agent_7.6.3.zip'
+---
+
+
+## New Features
+- Introduced build-time feature flag for LogInstrumentation.
+- Enhanced logging by including Session Attributes as Log Attributes.
+
+## Bug Fixes
+- Resolved missed session events in the background reporting feature.
+- Fixed memory leak related to mobile handled exceptions during network unavailability.
+- Corrected application crash scenario during agent shutdown.
+
+
+## Support statement
+
+We recommend updating the agent at least every three months. Find specific policies and dates for Android agent support in the [Mobile Monitoring Agents EOL Policy](/docs/mobile-monitoring/new-relic-mobile/get-started/mobile-agents-eol-policy/#android-eol).