Skip to content

Commit

Permalink
Without collapsible
Browse files Browse the repository at this point in the history
  • Loading branch information
orishoshan committed Aug 22, 2023
1 parent a27bba8 commit 73ba191
Showing 1 changed file with 6 additions and 10 deletions.
16 changes: 6 additions & 10 deletions docs/troubleshooting/README.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -7,30 +7,26 @@ import TabItem from '@theme/TabItem';

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

<details open>

<summary><h2>Connecting Otterize OSS in a Kubernetes cluster to Otterize Cloud</h2></summary>
## Connecting Otterize OSS in a Kubernetes cluster to Otterize Cloud

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

![Components not integrated](/img/troubleshooting/not-integrated.png)

### Steps to try:
#### Steps to try:

#### 1. Check that all your Otterize pods are in 'Running' state: `kubectl get pods -n otterize-system`
##### 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
##### 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](/img/troubleshooting/connection-guide-cloud-instructions.png)

#### 3. Check the disconnected component's logs: `kubectl logs -n otterize-system <pod name>`
##### 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.

</details>
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.

0 comments on commit 73ba191

Please sign in to comment.