Skip to content

Commit

Permalink
updates
Browse files Browse the repository at this point in the history
  • Loading branch information
adutta-newrelic committed Feb 1, 2025
1 parent ea43c05 commit e204f5a
Show file tree
Hide file tree
Showing 22 changed files with 697 additions and 122 deletions.
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ translate:
- jp
metaDescription: 'Compatible build systems, OS versions, and more for the Android agent.'
redirects:
- /docs/streaming-video-&-ads/installation/mobile/android/android-compatibility-and-requirement
- /docs/streaming-video-&-ads/installation/android/android-compatibility-and-requirement
freshnessValidatedDate: never
---

Expand Down Expand Up @@ -335,3 +335,4 @@ Kotlin DSL support was officially added to Android Gradle Plugin in version 4.1,
## Unit testing not supported [#testing]

Our New Relic mobile agents are designed and tested to work in a normal app lifecycle. We do not support running any testing environment on applications with the agent. Testing can cause conflicts and unpredictable behavior.

Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ tags:
- Get started
metaDescription: 'Before installing the iOS agent, review these requirements.'
redirects:
- /docs/streaming-video-&-ads/installation/mobile/ios/ios-compatibility-requirements
- /docs/streaming-video-&-ads/installation/ios/ios-compatibility-requirements
freshnessValidatedDate: never
---

Expand Down

This file was deleted.

Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ Before you install the media agent, ensure you have a New Relic [account ID](/do

## Install the media agent [#installation]

To get started with Streaming Video & Ads, add our media agent to the type of app you want to monitor.
To begin with Streaming Video & Ads, install our media agent on your media assets for full streaming observability.

<Steps>

Expand Down
43 changes: 43 additions & 0 deletions src/content/docs/streaming-video-&-ads/update-the-media-agent.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,43 @@
---
title: Migrating media agent to version
metaDescription: 'How to update your existing media agent to the latest version.'
redirects:
freshnessValidatedDate: never
---

To make migrating from earlier versions as easy as possible, we have developed a compatibility layer that translates most of the configurable options chart to their new counterparts. This compatibility layer is temporary and will be removed in the future. We encourage you to read this guide carefully and migrate the configuration with human supervision.

## Migration to Version 3.xx

To experience the new curated view, you must migrate to version 3.xx of the media agent.

### Dual Event Type Complications

There is a chance that after migration, some of your end-users may not have opted for the app upgrade, or very few have. During this interim period, you could experience dual event types, which can be complicated. To manage this:

* Gather all the query and action mappings.
* Inform your end-users that during this interim period, they could see data in multiple events and how they are related.

<Callout variant="Important">
This applies to the mobile agent. For the browser, it will be upgraded automatically.
</Callout>

### Viewing Data Post-Migration

After migration, if you want to see data for the past month, we recommend that you use any custom dashboard or query:

```sql
SELECT * FROM pageAction
```

<Callout variant="Important">
With name event defination, they loose the dashboard capability for querying the old data.
</Callout>

### Event Definition Mapping

A detailed mapping of each old event type with the new one is provided to help you migrate any scripts or workflows. This mapping is crucial for ensuring a smooth transition and maintaining data integrity.

We recommend you carefully follow this guide and ensure that all configurations are migrated with supervision. The compatibility layer is a temporary solution, and it is important to transition to the new configuration as soon as possible.

For more detailed information, please contact New Relic customer support.
Original file line number Diff line number Diff line change
Expand Up @@ -11,23 +11,32 @@ Our Streaming Video & Ads <DNT>**Ads Overview**</DNT> page helps you with an ove
* View trends in an app's performance.
* Quickly identify the key performance indicators that display the **Ad quality** and the **Ad engaegment metrics**.
* Go directly to other browser UI pages to examine problems and issues in more detail.
* Add recommended alert conditions.

## View the Ad Overview page
## View the Ad Overview page [#view-the-ad-overview-page]

To view the summary of the media agent for a specific application:

1. Go to <DNT>**[one.newrelic.com](https://one.newrelic.com) > Streaming Video & Ads > Streaming Entities**</DNT>.
2. Select the specific application.
3. In the Overview section, click **Ad Overview**.
3. In the verview section, click **Ad Overview**.

<img
title="Streamng video & ads Ads Overview"
alt="A screenshot about using streaming video & ads"
src="/images/ads-overview.webp"
/>

## View of the Golden metrics
## Personalize the view [#personalize-the-view]

By default, the **Ads Overview** page displays all the entity associated to the account, however, you may search for any attribute or value by using the filter option. For example, you may filter the data by **Platform**, **OS Version**, **Video player name**, **ISP**, **Region**, and **Ad Resolution**.

<img
title="Streamng video & ads Ads Overview"
alt="A screenshot about using streaming video & ads"
src="/images/additional-filter.webp"
/>

## View the golden metrics [#view-of-the-golden-metrics]

Use the golden metrics to understand the performance of the applicaion and how your ad performs according to the **Ad quality** and **Ad engagement**. These include:

Expand Down Expand Up @@ -267,7 +276,7 @@ Use the **Ad quality** metrics to understand how your Ad performs accross the ap
<img
title="Streamng video & ads"
alt="A screenshot about using streaming video & ads"
src="/images/video-metrics.webp"
src="/images/ads-overview-quality.webp"
/>

## Additonal features
Expand Down Expand Up @@ -435,4 +444,14 @@ Explore and analyze traffic in depth by utilizing multiple parameters, including

* **Ad Resolution**: The resolution of the Ad being played at the viewers device.

* Click **Analyse User Session** to access the [User Sessions](/docs/streaming-video-&-ads/view-data-in-newrelic/streaming-video-&-ads-single-application-view/user-sessions) data. This will provide you with detailed insights into sessions that are currently in progress or ongoing for the time period you selected.
## Add Streaming Entity

By default, the **Ads Overview** page displays all the entity associated to the account. However, if you wish to create a new streaming entity:

1. Click **+ Add streaming entity**, top right corner of the page.
2. Select the type of app you want to monitor. See [Install the media agent](/docs/streaming-video-&-ads/installation/install-the-streaming-video-&-ads-agent/#installation)

## Whats next?

* View the [User sessions](/docs/streaming-video-&-ads/view-data-in-newrelic/streaming-video-&-ads-single-application-view/user-sessions) of the customer and troubleshoot users issue by clicking the **Analyse user session**.
* View the [Summary page](/docs/streaming-video-&-ads/view-data-in-newrelic/streaming-video-&-ads-single-application-view/media-summary-page) of the media agent across all platforms.
Original file line number Diff line number Diff line change
@@ -1,8 +1,166 @@
---
title: Streaming Entities
metaDescription: 'The features associated with the New Relic Streaming video & ads.'
metaDescription: 'Explore the features of New Relic Streaming for video and ads, providing detailed insights into active entities.'
redirects:
freshnessValidatedDate: never
---

Streaming Entities for Streaming Video and Ads provide an overview insights into the all the entities that are in progress or ongoing for a specific application. This will provide you with the detailed information about the entities.
Streaming Entities for Streaming Video & Ads offers an overview of insights into all active entities for a specific application. This provides detailed information about each entities, helping you optimize performance and user experience.

## Streaming Entities page UI

The Streaming Entities page displays various information across multiple columns. The following table provides each column available in the Streaming Entities page UI:

<table>
<thead>
<tr>
<th width="50%">
UI
</th>

<th>
Description
</th>
</tr>
</thead>

<tbody>
<tr>
<td>
**Name**
</td>

<td>
Entity name for the application, click the entity name to view the detailed information. See [Summary](/docs/streaming-video-&-ads/view-data-in-newrelic/streaming-video-&-ads-single-application-view/media-summary-page) for more information.
</td>
</tr>

<tr>
<td>
**Account**
</td>

<td>
Information regarding the account where the entity is being registed.
</td>
</tr>

<tr>
<td>
**Video Rebuffering Ratio (%)**
</td>

<td>
Percentage of video plays that experienced buffering.
</td>
</tr>

<tr>
<td>
**Ad Rebuffering Ratio (%)**
</td>

<td>
Percentage of ad plays that experienced buffering.
</td>
</tr>

<tr>
<td>
**Average Bitrate (B/s)**
</td>

<td>
Measurement of video quality based on the bits played back.
</td>
</tr>

<tr>
<td>
**Ad Average Bitrate (B/s)**
</td>

<td>
Measurement of ad video quality based on the bits played back. (see current implementation on how this is calculated)
</td>
</tr>

<tr>
<td>
**Average Start Time (s)**
</td>

<td>
The average time it takes before the first frame loads
</td>
</tr>

<tr>
<td>
**Ad Average Start Time (s)**
</td>

<td>
The average time it takes to load the first frame of the ad.
</td>
</tr>

<tr>
<td>
**Video Start Failures**
</td>

<td>
Count of video play attempts that failed to start (excluding user-initiated terminations).
</td>
</tr>

<tr>
<td>
**Ad Start Failures**
</td>

<td>
Count of ad play attempts that failed to start (excluding user-initiated terminations).
</td>
</tr>

<tr>
<td>
**Video Playback Failures**
</td>

<td>
Count of video plays that started but failed before completion, reporting an error.
</td>
</tr>

<tr>
<td>
**Ad Playback Failures**
</td>

<td>
Count of ad plays that started but failed before completion, reporting an error.
</td>
</tr>
</tbody>
</table>

<img
title="Streamng video & ads"
alt="A screenshot about using streaming video & ads"
src="/images/streaming-entity.webp"
/>

## Add Streaming Entity

By default, the **Streaming Entities** page displays all the entity associated to the account. However, if you wish to create a new streaming entity:

1. Click **+ Add streaming entity**, top right corner of the page.
2. Select the type of app you want to monitor. See [Install the media agent](/docs/streaming-video-&-ads/installation/install-the-streaming-video-&-ads-agent/#installation)

## Whats next?

* View the [User sessions](/docs/streaming-video-&-ads/view-data-in-newrelic/streaming-video-&-ads-single-application-view/user-sessions) of the customer and troubleshoot users issue by clicking the **Analyse user session**.
* View the [Summary page](/docs/streaming-video-&-ads/view-data-in-newrelic/streaming-video-&-ads-single-application-view/media-summary-page) of the media agent across all platforms.
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ User sessions for Streaming Video and Ads provide insights into the all the sess

## User Sessions page UI

The User Session page has multiple columns to display various information for an ongoing session. The following table provides the information aabout each column avaiable in the Session page UI:
The User Session page has multiple columns to display various information for an ongoing session. The following table provides the information about each column avaiable in the Session page UI:

<table>
<thead>
Expand All @@ -31,7 +31,7 @@ The User Session page has multiple columns to display various information for an
</td>

<td>
A unique if that is generated every time any app starts. For more information see [Session ID](#session-id).
A unique if that is generated every time any app starts. For more information see [Session ID](/docs/streaming-video-&-ads/view-data-in-newrelic/streaming-video-&-ads-all-platform-view/user-sessions/session-id).
</td>
</tr>

Expand All @@ -51,7 +51,7 @@ The User Session page has multiple columns to display various information for an
</td>

<td>
The name of the application that was entered at the time of installation.
The name of the application that was entered at the time of installation. Click the application name to view the detailed information. See [Summary](/docs/streaming-video-&-ads/view-data-in-newrelic/streaming-video-&-ads-single-application-view/media-summary-page) for more information.
</td>
</tr>

Expand Down
Loading

0 comments on commit e204f5a

Please sign in to comment.