Skip to main content


The following areas provide tips for troubleshooting specific areas of Otterize usage.

Connecting Otterize OSS in a Kubernetes cluster to Otterize Cloud

Problem: components remain in 'Not integrated' status or become 'Disconnected'

Components not integrated

Steps to try:

1. Check that all your Otterize pods are in 'Running' state: kubectl get pods -n otterize-system

Check whether the intents operator, network mapper, or credentials operator are running. Use kubectl describe pod -n otterize-system <pod name> to check the status and events and see why those pods may not be starting.

2. Verify that the client id and client secret you specified on the command line is correct

The pod may be having trouble connecting to Otterize Cloud because the credentials are incorrect. Make sure that the Cloud credentials specified as values to the Helm chart are correct. The Otterize Cloud connection guide provides you with a Helm command that has the correct values.

Components not integrated

3. Check the disconnected component's logs: kubectl logs -n otterize-system <pod name>

The component may not be able to connect to Otterize Cloud due to connectivity issues. Check for connectivity errors in the relevant component's logs. All errors related to Otterize Cloud will mention Otterize Cloud explicitly.

One possible problem is an egress default-deny network policy, which blocks all outgoing traffic. To solve this, make sure you exclude otterize-system from the namespaces to which the policy applies.