Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
 

Install Contrail Analytics

SUMMARY Learn how to install Contrail Analytics and the CN2 Web UI.

Contrail Analytics packages popular open source software such as Prometheus, Grafana, and Fluentd together with CN2 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. Also included is the CN2 Web UI, which allows you to monitor and configure CN2 components.

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 and the CN2 Web UI

Use this procedure to install Contail Analytics and the CN2 Web UI on Amazon EKS.

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:

    The --create-namespace option creates the contrail-analytics namespace. You can omit this option if your cluster already has the contrail-analytics namespace defined.

    Contrail Analytics is installed as a NodePort service. You can reach the service by specifying the IP address of any node running Contrail Analytics. By default, the port to use is 30443.

    Alternatively, you can specify an Internet-facing AWS load balancer service by adding --set enableLoadBalancer=true. You can then find the external load balancer IP address by kubectl get service -n contrail-analytics ambassador-loadbalancer and look for the EXTERNAL-IP address or HOSTNAME.

  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.

      The --create-namespace option creates the contrail-analytics namespace. You can omit this option if your cluster already has the contrail-analytics namespace defined.

      Contrail Analytics is installed as a NodePort service. You can reach the service by specifying the IP address of any node running Contrail Analytics. By default, the port to use is 30443.

      Alternatively, you can specify an Internet-facing AWS load balancer service by adding --set enableLoadBalancer=true. You can then find the external load balancer IP address by kubectl get service -n contrail-analytics ambassador-loadbalancer and look for the EXTERNAL-IP address or HOSTNAME.

  4. Verify that the analytics components are installed and running.
  5. After you install Contrail Analytics, you can access Grafana or the CN2 Web UI.
    To access Grafana, point your browser to https://<node-IP-address>:30443/grafana/. Be sure to include the trailing /. The default Grafana administrator username/password is admin/prom-operator.
    To access the CN2 Web UI, point your browser to https://<node-IP-address>:30443. You can log in to your cluster using your kubeconfig.
    Note:

    The CN2 Web UI 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.

  6. To uninstall Contrail Analytics:
  7. To upgrade Contrail Analytics:
    or (for upgrading HA)