Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
 

Install Contrail Analytics and the CN2 Web UI

Use this procedure to install Contail 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.

Packaged with Contrail Analytics 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.

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 a Tech Preview feature.

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.

  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.

  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.

  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. The default CN2 Web UI username/password is super/c0ntrail123.
    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)