Citrix Application Delivery Management service

Integration with New Relic

You can now integrate Citrix ADM with New Relic to view analytics for WAF, Bot, and behavior-based violations in your New Relic dashboard. With this integration, you can:

  • Combine all other external data sources in your New Relic dashboard.

  • Get visibility of analytics in a centralized place.

Citrix ADM collects Bot, WAF, and behavior-based events and sends them to New Relic either in real time or periodically based on your choice. As an administrator, you can also view the Bot, WAF, and other behavior-based events in your New Relic dashboard.

Prerequisites

For a successful integration, you must:

  • Obtain a New Relic event endpoint in the following format:

    https://insights-collector.newrelic.com/v1/accounts/<account_id>/events

    For more information on configuring an event endpoint, see New Relic documentation.

    For more information on getting an account ID, see New Relic documentation.

  • Obtain a New Relic key. For more information, see New Relic documentation.

  • Add the key details in Citrix ADM

Add the key details in Citrix ADM

After you generate a token, you must add details in Citrix ADM to integrate with New Relic.

  1. Log on to Citrix ADM.

  2. Navigate to Settings > Ecosystem Integration.

  3. In the Subscriptions page, click Add.

  4. In the Select features to subscribe tab, select the features that you want to export and click Next.

    • Realtime Export - The selected violations are exported to New Relic immediately.

    • Periodic Export - The selected violations are exported to New Relic based on the duration you select.

      Select features

  5. In the Specify export configuration tab:

    1. End Point Type – Select New Relic from the list.

    2. End Point – Specify the New Relic end point details. The end point must be in the https://insights-collector.newrelic.com/v1/accounts/<account_id>/events format.

      Note

      It is recommended to use HTTPS for security reasons.

    3. Authentication token – Copy and paste the authentication token from the New Relic page.

    4. Click Next.

      Create subscription

  6. In the Subscribe page:

    1. Export Frequency – Select Daily or Hourly from the list. Based on the selection, Citrix ADM exports the details to New Relic.

      Note

      Applicable only if you have selected violations in Periodic Export.

    2. Subscription Name – Specify a name of your choice.

    3. Select the Enable Notifications check box.

    4. Click Submit.

      Subscribe

      Note

      • When you configure with Periodic Export option for the first time, the selected features data get pushed to New Relic immediately. The next export frequency happens based on your selection (daily or hourly).

      • When you configure with Realtime Export option for the first time, the selected features data pushed to New Relic immediately as soon as the violations are detected in Citrix ADM.

The configuration is complete. You can view details in the Subscriptions page.

Subscriptions page

New Relic dashboard

When the events are exported in New Relic, you can view event details under Metrics & events in the following JSON format:

<subsription_name>_adm_<event name> where event name can be Bot, WAF, and so on.

In the following example, ADMSTAGING is the <subscription_name> and bot is the <event_name>.

Dashboard

Once you get the JSON data ingested into your New Relic dashboard, as an administrator, you can use the NRQL (New Relic Query Language) and create a custom dashboard with facets and widgets based on your choice by constructing queries around the ingested data. For more information, see https://docs.newrelic.com/docs/query-your-data/nrql-new-relic-query-language/get-started/introduction-nrql-new-relics-query-language/

The following is an example dashboard created using the NRQL:

Example dashboard

To create this dashboard, the following queries are required:

  • Widget 1: Total Unique Attacks in events table

    SELECT count(total_attacks) from <event_name> since 30 days ago

  • Widget 2: Unique Transaction IDs in event table

    SELECT uniqueCount(transaction_id) from <event_name> since 30 days ago

  • Widget 3: Total Unique Bot Types and their counts

    SELECT uniqueCount(bot_type_desc), uniques(bot_type_desc) from <event_name> since 30 days ago

  • Widget 4: Total unique App Names seeing Bot Violations

    SELECT uniques(appname) from <event_name> since 30 days ago

Integration with New Relic