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 GUI

Use this procedure to install Contail Analytics.

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 GUI, 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 considered 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 GUI.
    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 GUI, point your browser to https://<node-IP-address>:30443. You can log in to your cluster using your kubeconfig.
    Note:

    The CN2 GUI 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)