Skip to content

Commit

Permalink
Merge pull request #7761 from newrelic/DOC-6567
Browse files Browse the repository at this point in the history
chore(insights): Remove references to Insights product
  • Loading branch information
austin-schaefer committed May 25, 2022
2 parents 2a910fa + b5fb51e commit ee8b6ad
Show file tree
Hide file tree
Showing 45 changed files with 57 additions and 71 deletions.
Original file line number Diff line number Diff line change
Expand Up @@ -147,7 +147,6 @@ Account management
* [Export dashboards to other accounts](/docs/apis/nerdgraph/examples/export-import-dashboards-using-api/)
* [Export dashboards as files](/docs/apis/nerdgraph/examples/export-dashboards-pdfpng-using-api/)
* [Manage externally shared dashboards](/docs/apis/nerdgraph/examples/manage-live-chart-urls-via-api)
* [Migrate from Insights Dashboard API to NerdGraph](/docs/new-relic-one/use-new-relic-one/core-concepts/dashboards-api-migration-insights-api-nerdgraph/)
</td>
</tr>
<tr>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -33,6 +33,5 @@ This partner-only authentication method will only work with the [New Relic REST

* [Deployment API](/docs/apm/new-relic-apm/maintenance/deployment-notifications#api)
* [Infrastructure API for alerts](/docs/infrastructure/new-relic-infrastructure/infrastructure-alert-conditions/rest-api-calls-new-relic-infrastructure-alerts)
* [Insights API](/docs/insights/new-relic-insights/adding-querying-data/inserting-custom-events-insights-api)
* [Partner API](/docs/accounts-partnerships/partnerships/partner-api/partner-api-reference)
* [Synthetics API](/docs/apis/synthetics-rest-api/monitor-examples/manage-synthetics-monitors-rest-api)
Original file line number Diff line number Diff line change
@@ -1,7 +1,6 @@
---
title: Report mobile monitoring custom events and attributes
tags:
- Insights
- Event data sources
- Custom events
metaDescription: 'How to query your mobile events and attributes in New Relic, and how to create custom events and attributes.'
Expand Down Expand Up @@ -234,7 +233,7 @@ By default, New Relic transmits event data in any of these situations:
* The app session ends by backgrounding.
* The app crashes.

If the app crashes, New Relic gathers the attributes and events for that session and sends them to Insights. (On iOS, this happens the next time the app is launched). You can then use Insights to query and analyze the event and attribute data.
If the app crashes, New Relic collects the attributes and events for that session. (On iOS, this happens the next time the app is launched). You can then use NRQL to query and analyze the event and attribute data.

To set the maximum time (in seconds) that the agent will store events in memory, use the following SDK calls:

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -46,7 +46,6 @@ Related content:
* Learn about [all options for reporting custom events](/docs/insights/insights-data-sources/custom-data/report-custom-event-data).
* For details about how event data is retained, see [Event data retention](/docs/insights/use-insights-ui/manage-account-data/extend-event-data-retention).
* For how to add attributes to existing events, see [Add custom attributes](/docs/agents/manage-apm-agents/agent-data/collect-custom-attributes).
* Check out New Relic University’s tutorial [Adding custom events with the Event API](https://newrelic.wistia.com/medias/d530wfeqyo) (aka the Insights API). Or, go directly to the full online course [Custom data](https://learn.newrelic.com/custom-data-with-insights).

## Requirements

Expand Down Expand Up @@ -81,8 +80,6 @@ You'll need a [license key](/docs/apis/intro-apis/new-relic-api-keys/#ingest-lic

You can submit multiple event types to the same account with the same license key. However, to help ensure security, we recommend that you use different keys for different applications or data sources.

Alternatively, you can use an [Insights insert key](/docs/apis/intro-apis/new-relic-api-keys/#insights-insert-key)for this API, but we recommend using a license key.

## Format the JSON [#instrument]

The Event API accepts specific formats for attributes included in the payload. Only float or string values are allowed.
Expand Down Expand Up @@ -158,7 +155,7 @@ The Event API accepts specific formats for attributes included in the payload. O
</td>

<td>
For attributes that contain date information, use an unformatted Unix timestamp in the Insights [data formatter](/docs/insights/use-insights-ui/manage-account-data/data-formatter-set-default-formats-numeric-values). You can [define the date attribute](#timestamp) either in seconds or in milliseconds, both relative to the Unix epoch.
For attributes that contain date information, use an unformatted Unix timestamp in the [data formatter](/docs/insights/use-insights-ui/manage-account-data/data-formatter-set-default-formats-numeric-values). You can [define the date attribute](#timestamp) either in seconds or in milliseconds, both relative to the Unix epoch.
</td>
</tr>

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -437,7 +437,7 @@ Additional restrictions include:
</td>

<td>
The Metric API inherits some [reserved words from New Relic Insights](/docs/insights/insights-data-sources/custom-data/insights-custom-data-requirements-limits#reserved-words), including `accountID`, `appId`, and `eventType`. Additionally, the syntax terms for NRQL are restricted unless you backtick (``` `` ```) them. For a full list, see [Reserved words: NRQL syntax terms](/docs/insights/insights-data-sources/custom-data/insights-custom-data-requirements-limits#reserved-syntax).
Avoid using [reserved words](/docs/insights/insights-data-sources/custom-data/insights-custom-data-requirements-limits#reserved-words), such as `accountID`, `appId`, and `eventType`. You should also avoid using NRQL syntax terms unless you backtick (``` `` ```) them.
</td>
</tr>

Expand Down
Original file line number Diff line number Diff line change
@@ -1,7 +1,6 @@
---
title: 'Security for New Relic-reported events and attributes '
tags:
- Insights
- Event data sources
- Default events
metaDescription: How to manage the security of events and attributes reported to New Relic.
Expand Down
Original file line number Diff line number Diff line change
@@ -1,7 +1,6 @@
---
title: Default events reported by New Relic products
tags:
- Insights
- Event data sources
- Default events
metaDescription: A summary of the default events and attributes reported by New Relic products.
Expand Down
Original file line number Diff line number Diff line change
@@ -1,7 +1,6 @@
---
title: Events reported by synthetic monitoring
tags:
- Insights
- Event data sources
- Default events
metaDescription: Events and attributes reported by synthetic monitoring in New Relic.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ redirects:
- /docs/mobile-monitoring/mobile-monitoring-ui/network-pages
---

Monitoring HTTP and network requests gives you insight into how your app is performing and provides data that can help you improve your app. To find HTTP and network requests and errors, you can view them in the [mobile monitoring UI](#view-mobile) or query [`MobileRequest` and `MobileRequestError` events](#query-insights) in Insights.
Monitoring HTTP and network requests gives you insight into how your app is performing and provides data that can help you improve your app. To find HTTP and network requests and errors, you can view them in the [mobile monitoring UI](#view-mobile) or query [`MobileRequest` and `MobileRequestError` events](#query-insights) with NRQL.

## Enable MobileRequest for earlier versions of iOS and Android [#enable_mobilerequest]

Expand Down Expand Up @@ -56,7 +56,7 @@ For earlier versions, starting with Android version 5.14.0 or iOS version 5.14.0
</Collapser>
</CollapserGroup>

## Query HTTP and network requests in Insights [#query-insights]
## Query HTTP and network requests with NRQL [#query-insights]

To create custom dashboards for HTTP and network requests, run queries using the following events and attributes:

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -128,8 +128,7 @@ For a description of the non-Enterprise **HTTP requests** UI page, see [Legacy H

To view any **HTTP requests** chart in Insights:

1. Select <Icon name="fe-more-horizontal"/>
for any chart.
1. Select <Icon name="fe-more-horizontal"/> for any chart.
2. Select **View query > View in Insights**.
3. Optional: Add the data to a dashboard, or [share it by using a permalink](/docs/data-analysis/user-interface-functions/share-your-data/permalink).
4. To delve deeper into your request data, query [`MobileRequest`](/docs/insights/nrql-new-relic-query-language/nrql-query-examples/insights-query-examples-new-relic-mobile#mobilerequest-examples) events and [attributes](/docs/insights/insights-data-sources/default-data/mobile-events-attributes#mobilerequest-attributes).
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -42,7 +42,7 @@ All settings, including the call to invoke the agent, are called in the `onCreat
id="ff-withAnalyticsEvents"
title="withAnalyticsEvents"
>
Enable or disable collection of event data. These events are reported to [Insights](/docs/insights/explore-data/attributes/mobile-default-attributes-insights) and used in the [**Crash analysis** page](/docs/mobile-monitoring/mobile-monitoring-ui/crashes/crash-analysis-group-filter-your-crashes).
Enable or disable collection of event data. These events [can be queried with NRQL](/docs/insights/explore-data/attributes/mobile-default-attributes-insights) and used in the [**Crash analysis** page](/docs/mobile-monitoring/mobile-monitoring-ui/crashes/crash-analysis-group-filter-your-crashes).

<table>
<tbody>
Expand Down Expand Up @@ -345,7 +345,7 @@ All settings, including the call to invoke the agent, are called in the `onCreat
id="ff-networkRequests"
title="FeatureFlag.NetworkRequests"
>
Enable or disable reporting successful HTTP requests to the [MobileRequest](/docs/insights/nrql-new-relic-query-language/nrql-query-examples/insights-query-examples-new-relic-mobile#mobilerequest-examples) event type in Insights.
Enable or disable reporting successful HTTP requests to the [MobileRequest](/docs/insights/nrql-new-relic-query-language/nrql-query-examples/insights-query-examples-new-relic-mobile#mobilerequest-examples) event type.

Available for Android agent version 5.14.0 or higher.

Expand Down Expand Up @@ -380,7 +380,7 @@ All settings, including the call to invoke the agent, are called in the `onCreat
id="ff-networkErrorRequests"
title="FeatureFlag.NetworkErrorRequests"
>
Enable or disable reporting network and Http request errors to [MobileRequestError](/docs/insights/nrql-new-relic-query-language/nrql-query-examples/insights-query-examples-new-relic-mobile#mobilerequesterror-examples) event type in Insights.
Enable or disable reporting network and HTTP request errors to the [MobileRequestError](/docs/insights/nrql-new-relic-query-language/nrql-query-examples/insights-query-examples-new-relic-mobile#mobilerequesterror-examples) event type.

Available for Android agent version 5.11.0 or higher.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -26,7 +26,7 @@ The Android agent provides an SDK API to set up [custom instrumentation](/docs/m
* [Instrument your own code](#instrumenting).
* [Create](#creating), [name](#naming), and [end](#ending) interaction traces from events in your mobile app.
* [Record custom metrics](#create-custom).
* [Send custom attributes and events to New Relic Insights](#attributes-events-insights).
* [Send custom attributes and events](#attributes-events-insights).
* [Track networking from libraries not supported automatically](#track-custom).

## Install the SDK [#installing]
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -28,7 +28,7 @@ Compatible with all agent versions.

Returns the current session ID. This method is useful for consolidating monitoring of app data (not just New Relic data) based on a single session definition and identifier. For example, you might want to use the same identifier for marketing analytics, or user analytics.

For more context on how to use this API, see [Send custom attributes and events to Insights](/docs/mobile-monitoring/new-relic-mobile-android/install-configure/work-android-sdk-api#attributes-events-insights).
For more context on how to use this API, see [Send custom attributes and events](/docs/mobile-monitoring/new-relic-mobile-android/install-configure/work-android-sdk-api#attributes-events-insights).

## Return values

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -28,7 +28,7 @@ Agent version 5.0.0 or higher.

When passed with only a name value, this method increments the count for the specified attribute by 1. If the attribute does not exist, it creates the attribute with a value of 1. When passed an optional float value, it increments the count for the specified attribute by the float value.

For context on how to use this API, see [Send custom attributes and events to Insights](/docs/mobile-monitoring/new-relic-mobile-android/install-configure/work-android-sdk-api#attributes-events-insights).
For context on how to use this API, see [Send custom attributes and events](/docs/mobile-monitoring/new-relic-mobile-android/install-configure/work-android-sdk-api#attributes-events-insights).

## Parameters

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -25,11 +25,11 @@ Agent version 5.13.0 or higher.

## Description

This call creates and records a `MobileBreadcrumb` event, which can be found in Insights and in the [crash event trail](/docs/mobile-monitoring/mobile-monitoring-ui/crashes/mobile-crash-event-trail). Mobile breadcrumbs are useful for crash analysis; they should be created for app activity that may be helpful for troubleshooting crashes.
This call creates and records a `MobileBreadcrumb` event, which can be queried with NRQL and in the [crash event trail](/docs/mobile-monitoring/mobile-monitoring-ui/crashes/mobile-crash-event-trail). Mobile breadcrumbs are useful for crash analysis; they should be created for app activity that may be helpful for troubleshooting crashes.

In addition to whatever custom attributes you choose, the event will also have associated [session attributes](/docs/insights/explore-data/attributes/mobile-default-attributes-insights#mobile-list). Unlike with using [`setAttribute`](/docs/mobile-monitoring/new-relic-mobile-android/android-sdk-api/set-attribute), adding attributes to a breadcrumb event adds them only to that event; they are not session attributes.

For related Android SDK API calls, see [Send custom attributes and events to Insights](/docs/mobile-monitoring/new-relic-mobile-android/install-configure/guide-custom-instrumentation-api#send-insights).
For related Android SDK API calls, see [Send custom attributes and events](/docs/mobile-monitoring/new-relic-mobile-android/install-configure/guide-custom-instrumentation-api#send-insights).

## Parameters

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ tags:
- Mobile monitoring
- New Relic Mobile Android
- Android SDK API
metaDescription: 'New Relic API for Android mobile app monitoring: record a custom event for New Relic Insights.'
metaDescription: 'New Relic API for Android mobile app monitoring: record a custom event.'
redirects:
- /docs/mobile-monitoring/new-relic-mobile-android/android-sdk-api/recordevent-android-agent-api
- /docs/mobile-monitoring/new-relic-mobile-android/android-sdk-api/record-event
Expand Down Expand Up @@ -38,10 +38,10 @@ Important considerations and best practices include:
<Callout variant="important">
As of New Relic [Android agent version 5.12.0](/docs/release-notes/mobile-release-notes/android-release-notes/android-5120), the `recordEvent` method is deprecated and replaced with `recordCustomEvent`. The `recordEvent` method will continue to work for an unspecified period of time, but if your app contains `recordEvent` methods, New Relic recommends you replace them.

Updating these methods will affect any Insights queries and dashboards that use the deprecated event types. Be sure to adjust your NRQL queries and dashboards as needed.
Updating these methods will affect any NRQL queries and dashboards that use the deprecated event types. Be sure to adjust your NRQL queries and dashboards as needed.
</Callout>

For more on other Android APIs, see [Send custom attributes and events to Insights](/docs/mobile-monitoring/new-relic-mobile-android/install-configure/guide-custom-instrumentation-api#send-insights).
For more on other Android APIs, see [Send custom attributes and events](/docs/mobile-monitoring/new-relic-mobile-android/install-configure/guide-custom-instrumentation-api#send-insights).

## Parameters

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -40,8 +40,6 @@ To get the most out of your metrics, follow these guidelines to create clear, co

The `category` is also required; it is displayed in the UI and is useful for organizing custom metrics if you have many of them. It can be a custom category or it can be a predefined category using the [`MetricCategory` enum](/docs/mobile-monitoring/new-relic-mobile-android/install-configure/work-android-sdk-api#cat).

To view your custom metrics, use [Insights Metric Explorer](/docs/insights/new-relic-insights/explore/metric-data-explorer-search-chart-metrics-sent-new-relic-agents) to search metrics, create customizable charts, and add those charts to Insights dashboards. For more information, see the [Android SDK API usage guide](/docs/mobile-monitoring/new-relic-mobile-android/install-configure/work-android-sdk-api).

## Parameters

This call accepts four sets of parameters.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -28,7 +28,7 @@ Agent version 5.0.0 or higher.

Removes all attributes from the session.

For context on how to use this API, see [Send custom attributes and events to Insights](/docs/mobile-monitoring/new-relic-mobile-android/install-configure/work-android-sdk-api#attributes-events-insights).
For context on how to use this API, see [Send custom attributes and events](/docs/mobile-monitoring/new-relic-mobile-android/install-configure/work-android-sdk-api#attributes-events-insights).

## Return values

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -28,7 +28,7 @@ Agent version 5.0.0 or higher.

This method removes the attribute specified by the name string.

For context on how to use this API, see [Send custom attributes and events to Insights](/docs/mobile-monitoring/new-relic-mobile-android/install-configure/work-android-sdk-api#attributes-events-insights).
For context on how to use this API, see [Send custom attributes and events](/docs/mobile-monitoring/new-relic-mobile-android/install-configure/work-android-sdk-api#attributes-events-insights).

## Parameters

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ tags:
- Mobile monitoring
- New Relic Mobile Android
- Android SDK API
metaDescription: 'New Relic API for Android mobile app monitoring: create an attribute for sending data to New Relic Insights.'
metaDescription: 'New Relic API for Android mobile app monitoring: create a custom attribute to annotate your data.'
redirects:
- /docs/mobile-monitoring/new-relic-mobile-android/android-sdk-api/setattribute-android-agent-api
- /docs/mobile-monitoring/new-relic-mobile-android/android-sdk-api/setattribute-android-sdk-api
Expand All @@ -30,7 +30,7 @@ This static method creates a session-level custom [attribute](/docs/insights/exp

For more context on how to use this API, see the [Android API guide](/docs/mobile-monitoring/new-relic-mobile-android/install-configure/work-android-sdk-api#attributes-events-insights).

You can override any of the [MobileSession default attributes](/docs/insights/insights-data-sources/default-attributes/mobile-default-attributes-insights) for New Relic Insights except:
You can override any of the [MobileSession default attributes](/docs/insights/insights-data-sources/default-attributes/mobile-default-attributes-insights) except:

* `appId`
* `appName`
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -40,7 +40,7 @@ See also [`setMaxEventPoolSize()`](/docs/mobile-monitoring/new-relic-mobile-andr
Be aware that reporting a large number of events, or reporting events too frequently, may impact app performance.
</Callout>

For context on how to use this API, see [Send custom attributes and events to Insights](/docs/mobile-monitoring/new-relic-mobile-android/install-configure/work-android-sdk-api#attributes-events-insights).
For context on how to use this API, see [Send custom attributes and events](/docs/mobile-monitoring/new-relic-mobile-android/install-configure/work-android-sdk-api#attributes-events-insights).

## Parameters

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -38,7 +38,7 @@ See also [`setMaxEventBufferTime()`](/docs/mobile-monitoring/new-relic-mobile-an
Be aware that reporting a large number of events, or reporting events too frequently, may impact app performance.
</Callout>

For context on how to use this API, see [Send custom attributes and events to Insights](/docs/mobile-monitoring/new-relic-mobile-android/install-configure/work-android-sdk-api#attributes-events-insights).
For context on how to use this API, see [Send custom attributes and events](/docs/mobile-monitoring/new-relic-mobile-android/install-configure/work-android-sdk-api#attributes-events-insights).

## Parameters

Expand Down

0 comments on commit ee8b6ad

Please sign in to comment.