Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
ON THIS PAGE
 

Install Contrail Analytics

SUMMARY Learn how to install Contrail Analytics.

Contrail Analytics packages popular open source software such as Prometheus, Grafana, and Fluentd together with Contrail telemetry exporters to provide an industry-standard way for you to monitor and analyze your network and network infrastructure. Information collected includes logs, metrics, status' of various component, and flows.

When you install Contrail Analytics, all analytics components are preconfigured to work with each other.

Note:

We use Helm charts to install Contrail Analytics. Install Helm 3.0 or later on the host that you're using to install Contrail Analytics.

Install Contrail Analytics in Release 22.1

Use this procedure to install Contail Analytics in release 22.1.

  1. Locate the Contrail Analytics package that you downloaded.
  2. Create a namespace for the Contrail Analytics pods.
  3. Create a secret based on your repository login credentials. We'll call this secret juniper-hub-auth in this example.
  4. Populate the image-pull-secret-values.yaml file with references to the secret you just created.
    1. Extract the image-pull-secret-values.yaml file from the Contrail Analytics package.
    2. Replace all occurrences of _SECRET_NAME_ in that file with the name of the secret you created.
  5. Install the Contrail Analytics package, referencing the image-pull-secret-values.yaml file you just updated.

    where <ipAddress> is the optional externally-routable virtual IP address that you want to use to access the analytics components. You would use this IP address, for example, to access Grafana from your web browser. In the example networks shown in this document, this IP address would be an unused address in the 172.16.0.0/24 (machine) subnet. If you want to access this address from outside this subnet, then you may need to create a NAT rule to allow external browsers to reach this address.

  6. Verify that the analytics components are installed and running.
  7. After you install Contrail Analytics, you can access Grafana by pointing your browser to https://<external-IP-address>/grafana/. Be sure to include the trailing /.
  8. To uninstall Contrail Analytics:

Install Contrail Analytics in Release 22.2 or Higher

Use this procedure to install Contail Analytics in release 22.2 or higher.

You have the option of installing Contrail Analytics with a single instance of Prometheus or with HA Prometheus support. HA Prometheus for Contrail Analytics is considered a Tech Preview feature.

  1. Locate the Contrail Analytics package that you downloaded.
  2. To install Contrail Analytics with a single instance of Prometheus:

    where <ipAddress> is the optional externally-routable virtual IP address that you want to use to access the analytics components. You would use this IP address, for example, to access Grafana from your web browser. In the example networks shown in this document, this IP address would be an unused address in the 172.16.0.0/24 (machine) subnet. If you want to access this address from outside this subnet, then you may need to create a NAT rule to allow external browsers to reach this address.

  3. To install Contrail Analytics with HA Prometheus support (Tech Preview):
    Note:

    This feature is classified as a Juniper CN2 Technology Preview feature. These features are "as is" and are for voluntary use. Juniper Support will attempt to resolve any issues that customers experience when using these features and create bug reports on behalf of support cases. However, Juniper may not provide comprehensive support services to Tech Preview features.

    For additional information, refer to the Juniper CN2 Technology Previews (Tech Previews) or contact Juniper Support.
    1. Extract the thanos-values.yaml file from the Contrail Analytics package.
      Contrail Analytics uses Thanos to provide high availability for Prometheus. Thanos is a set of open source components that integrate seamlessly with Prometheus to provide a highly available metric system.
    2. Install Contrail Analytics (referencing the thanos-values.yaml) file.

      where <ipAddress> is the optional externally-routable virtual IP address that you want to use to access the analytics components. You would use this IP address, for example, to access Grafana from your web browser. In the example networks shown in this document, this IP address would be an unused address in the 172.16.0.0/24 (machine) subnet. If you want to access this address from outside this subnet, then you may need to create a NAT rule to allow external browsers to reach this address.

  4. Verify that the analytics components are installed and running.
  5. After you install Contrail Analytics, you can access Grafana by pointing your browser to https://<external-IP-address>/grafana/. Be sure to include the trailing /.
  6. To uninstall Contrail Analytics:
  7. To upgrade Contrail Analytics:
    or (for upgrading HA)