Installing ContainIQ

Install ContainIQ Metrics Server

Check if it's already installed:

kubectl get pods --all-namespaces | grep metrics-server

If nothing is returned, install it with the command below:

kubectl apply -f https://github.com/kubernetes-sigs/metrics-server/releases/latest/download/components.yaml

Install ContainIQ Agent

Using kubectl

Download the deployment file: curl -L -o deployment.yaml https://raw.githubusercontent.com/containiq/containiq-deployment/master/deployment.yaml

The deployment.yaml file contains all the necessary resources to run the ContainIQ agent in your cluster.

Step 1

Add your API key to the secret object on line 19 of the deployment.yaml file.

Step 2 (Optional)

On line 28 in the configmap, replace default with a name of your choice. This is later used when filtering by cluster on our backend and allows you to differentiate between your clusters.

Step 3

Run kubectl apply -f deployment.yaml

Using Helm

helm repo add containiq https://containiq.github.io/charts/ 
helm repo update

Helm 2

helm install containiq containiq/containiq --namespace=containiq \
 --set comm.Key=<CONTAINIQ_API_KEY> \
--set logs.enabled=true --set latency.enabled=true \
--set clusterName=default

Helm 3

helm install containiq containiq/containiq --namespace=containiq \
--create-namespace \
--set comm.Key=<CONTAINIQ_API_KEY> \
--set logs.enabled=true --set latency.enabled=true \
--set clusterName=default

Capture Request and Response Body

Helm

Add the following to your helm install command --set global.excludeBodies='false'

YAML

change line 135 in the yaml to value: "True"

Enable profiling

Helm

Add the following to your helm install command --set global.profiler='true'



Installing ContainIQ On-Prem

ContainIQ can be run both in-cloud or on-prem following the same installation instructions above. To learn more about ContainIQ's on-prem solution, please contact us directly. It should be noted, in order to run ContainIQ on-prem properly, you will need to install the following tools: PostgreSQL, Kafka, and ClickHouse.

Uninstalling ContainIQ

Uninstall using Kubectl

To uninstall ContainIQ run the following command:

kubectl delete ns containiq

Uninstall using HELM

helm uninstall containiq -n containiq

How to Disable the Latency Feature Set

Disable using kubectl

Download the deployment file: curl -L -o deployment.yaml https://raw.githubusercontent.com/containiq/containiq-deployment/master/deployment.yaml

Step 1

Open the deployment.yaml file and remove the latency-controller DaemonSet (lines 109 through172) and save the file.

Step 2

Run kubectl apply -f deployment.yaml

Disable using Helm

To uninstall the ContainIQ latency-controller using Helm, change latency.enabled=false.

helm install containiq containiq/containiq --namespace=containiq \
 --set comm.Key=<CONTAINIQ_API_KEY> \
--set logs.enabled=true --set latency.enabled=false \
--set clusterName=default

How to Disable the Logging Feature Set

Disable using kubectl

Download the deployment file: curl -L -o deployment.yaml https://raw.githubusercontent.com/containiq/containiq-deployment/master/deployment.yaml

Step 1

Open the deployment.yaml file and remove all mentions of fluentd (lines 173 through 287) and save the file.

Step 2

Run kubectl apply -f deployment.yaml.

Disable using Helm

To uninstall the ContainIQ logging feature set using Helm, change logs.enabled=false.