Integrate Analytics with New Relic
Updated
Configure Agora Analytics to push data directly to your New Relic account.
New Relic is an observability platform that you can use to monitor applications and infrastructure, query metrics, set up alerts, and build dashboards. To analyze Agora product data alongside your other telemetry, you can push Agora Analytics usage, quality, and performance statistics directly to your New Relic account.
This page shows you how to set up the New Relic integration with Agora Analytics.
Prerequisites
To use the New Relic integration, you need:
- An Agora Analytics Premium or Enterprise pricing plan. Both plans include the New Relic integration, so you don't need to request access.
- A New Relic account and a license key for the account that receives the data.
Enable and configure New Relic
To enable the Agora Analytics integration with New Relic:
-
In Agora Analytics, go to Integration > New Relic.
-
On the configuration page, select the Region, the Projects, and the Metrics you want to push to New Relic. For the full list of metrics, see Reference.
-
Enter your New Relic license key, then click Save and Enable.
-
Check that the Configuration Status changes to Online.
The configuration page also shows the following information:
- Updated at: The time of the last data push, in your local time zone.
- Updated by: The last user to enable or disable the feature.
- Expiration date: The time remaining before your package expires.
After you change the status, it can take up to five minutes for the data push to start or stop.
-
To confirm that data is arriving, open the New Relic query builder and run the following NRQL query:
FROM Metric SELECT max(agora.rtc.app_id.online_user) AS 'Online users' FACET product_type SINCE 1 hour ago TIMESERIES 1 minuteAgora Analytics stores metrics in New Relic as the
Metricevent type. Theproduct_typeattribute breaks the results down by Agora product.
You are now ready to use New Relic to analyze the use of your Agora products.
Reference
Agora Analytics pushes the following RTC metrics to New Relic:
| Metric name | Type | Description |
|---|---|---|
agora.rtc.app_id.online_user | gauge | Number of online users aggregated by App ID, calculated every minute. |
agora.rtc.app_id.online_channel | gauge | Number of online channels aggregated by App ID, calculated every minute. |
agora.rtc.app_id.join_success_rate | gauge | Join success rate aggregated by App ID, calculated every minute. |
agora.rtc.app_id.join_success_in_5s_rate | gauge | Join success rate within 5 seconds aggregated by App ID, calculated every minute. |
agora.rtc.app_id.join_attempt | count | Number of join attempts aggregated by App ID, calculated every minute. |
agora.rtc.app_id.join_success_count | count | Number of successful joins aggregated by App ID, calculated every minute. |
agora.rtc.app_id.audio_freeze_rate | gauge | Audio freeze rate aggregated by App ID, calculated every minute. |
agora.rtc.app_id.video_freeze_rate | gauge | Video freeze rate aggregated by App ID, calculated every minute. |
agora.rtc.app_id.network_delay_rate | gauge | Network delay rate aggregated by App ID, calculated every minute. |
