Skip to main content

Verify Cluster Connection

Overview​

After installing the OpsWorker Kubernetes Agent, verify that your cluster is connected and data collection is working.

Validation Steps​

1. Check Cluster Status in Portal​

Navigate to your cluster in the OpsWorker portal. The status indicator should show Connected.

StatusMeaningAction
ConnectedAgent is running and communicatingReady to go
PendingAgent not yet installed or not yet connectedInstall agent or wait a minute
DisconnectedNo recent communication from agentCheck troubleshooting steps below

2. Check Agent Pod​

Verify the agent pod is running in your cluster:

kubectl get pods -n opsworker

Expected output:

NAME                               READY   STATUS    RESTARTS   AGE
opsworker-agent-xxxxx-xxxxx        1/1     Running   0          2m

3. Check Agent Logs​

Review the agent logs for successful connection:

kubectl logs -n opsworker -l app=opsworker-agent

Look for messages indicating successful SQS connection and polling.

4. Run a Test Investigation​

Click the Test Integration button in your cluster settings. This sends a synthetic alert through the complete pipeline:

  1. Synthetic alert → OpsWorker
  2. Investigation runs against your cluster
  3. Results appear in the portal (and Slack, if configured)

If the test investigation completes successfully, your cluster is fully operational.

Troubleshooting​

If your cluster doesn't show as Connected:

  • Pod not running: Check kubectl describe pod -n opsworker -l app=opsworker-agent for scheduling or image pull issues
  • Outbound connectivity: Verify the agent can reach AWS SQS — test HTTPS access to *.amazonaws.com from the cluster
  • Network policies: Check if any NetworkPolicy resources are blocking outbound traffic from the opsworker namespace
  • Cluster token: Verify the correct token was used during installation — regenerate from the portal if needed
  • Proxy: If behind a corporate proxy, configure proxy settings in the Helm values

See Agent Connectivity Troubleshooting for detailed guidance.

Next Steps​