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:

  1. In Agora Analytics, go to Integration > New Relic.

  2. 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.

  3. Enter your New Relic license key, then click Save and Enable.

  4. 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.

  5. 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 minute

    Agora Analytics stores metrics in New Relic as the Metric event type. The product_type attribute 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 nameTypeDescription
agora.rtc.app_id.online_usergaugeNumber of online users aggregated by App ID, calculated every minute.
agora.rtc.app_id.online_channelgaugeNumber of online channels aggregated by App ID, calculated every minute.
agora.rtc.app_id.join_success_rategaugeJoin success rate aggregated by App ID, calculated every minute.
agora.rtc.app_id.join_success_in_5s_rategaugeJoin success rate within 5 seconds aggregated by App ID, calculated every minute.
agora.rtc.app_id.join_attemptcountNumber of join attempts aggregated by App ID, calculated every minute.
agora.rtc.app_id.join_success_countcountNumber of successful joins aggregated by App ID, calculated every minute.
agora.rtc.app_id.audio_freeze_rategaugeAudio freeze rate aggregated by App ID, calculated every minute.
agora.rtc.app_id.video_freeze_rategaugeVideo freeze rate aggregated by App ID, calculated every minute.
agora.rtc.app_id.network_delay_rategaugeNetwork delay rate aggregated by App ID, calculated every minute.