Troubleshoot DataStax Agent issues

Use this troubleshooting reference for resolving issues with DataStax agents. The issues appear in the Agents View along with troubleshooting tips, links to documentation, and links to the Install Agents dialog.

Issues	Recommendations
No agents detected.	The agents are not installed. Click Set Up Agents to automatically install or start agents, or follow the documentation to manually install agents.
Agents are not connected to OpsCenter because they are misconfigured.	Click Configure Agents to update the stomp configuration for the misconfigured agents.
Package-installed agent has the wrong version.	The agent version installed for a package installation type does not match the currently installed agent version in OpsCenter. Click Upgrade Agents to install the correct version of the agent on all nodes.
Tar-installed agent has the wrong version.	The agent version being attempted to install for a tarball installation type does not match the currently installed agent version in OpsCenter. Tarball agent installs cannot be automatically upgraded. See the Upgrade Guide to upgrade the current version of OpsCenter.
The DataStax Enterprise cluster being monitored is misconfigured.	The DataStax Enterprise configuration does not match for all nodes in your cluster.
No HTTP communication to the agent.	OpsCenter cannot talk to these agents over HTTP. Check that the OpsCenter machine can reach these agents via HTTP and check that SSL is correctly enabled or disabled in both OpsCenter and agent configurations. See Configure SSL for more information.
The DataStax Enterprise storage cluster is misconfigured.	The configuration for the DataStax Enterprise storage cluster does not match for all nodes in your cluster. See Storecollection data on a separate cluster and ensure the storage cluster is properly configured.
Node down.	The agent has confirmed that a node is down and requires investigation into the root cause. In addition to showing a node down in the Agents and Ring views, you can add an alert for nodes marked as down and configure alert notification using email or POSTing to a URL.
JMX is misconfigured.	Check the JMX settings configured in address.yaml. The agent is unable to connect to JMX with the settings configured in OpsCenter: - Either update the configuration in the OpsCenter Connection Settings > Edit Cluster dialog if all nodes have this error, or check the node-specific JMX config if this is an issue on a subset of nodes. The agent is unable to connect to JMX and is using advanced JMX settings configured in address.yaml. The location of the address.yaml file depends on the type of installation: Package installations: /var/lib/datastax-agent/conf/address.yaml Tarball installations: *install_location/conf/address.yaml Check and update the JMX settings on the node: jmx_host* Host used to connect to local JMX server. The default setting is localhost. This information will be sent by opscenterd for convenience, but can be configured locally as needed. Example: `jmx_host: 127.0.0.1` - jmx_port Port used to connect to local `JMX` server. The default setting is `7199`. This information is sent by opscenterd for convenience, but can be configured locally as needed. Example: `jmx_port: 7199` - jmx_user The username used to connect to the local JMX server. Example: `jmx_user: jmx-username` - jmx_pass The password used to connect to the local JMX server. Example: `jmx_pass: jmx-password` [This field may be encrypted for additional security.] - jmx_metrics_threadpool_size The size of the threadpool used for collecting metrics over JMX. Example: `jmx_metrics_threadpool_size: 6`

Issues

Recommendations

No agents detected.

The agents are not installed. Click Set Up Agents to automatically install or start agents, or follow the documentation to manually install agents.

Agents are not connected to OpsCenter because they are misconfigured.

Click Configure Agents to update the stomp configuration for the misconfigured agents.

Package-installed agent has the wrong version.

The agent version installed for a package installation type does not match the currently installed agent version in OpsCenter. Click Upgrade Agents to install the correct version of the agent on all nodes.

Tar-installed agent has the wrong version.

The agent version being attempted to install for a tarball installation type does not match the currently installed agent version in OpsCenter. Tarball agent installs cannot be automatically upgraded. See the Upgrade Guide to upgrade the current version of OpsCenter.

The DataStax Enterprise cluster being monitored is misconfigured.

The DataStax Enterprise configuration does not match for all nodes in your cluster.

No HTTP communication to the agent.

OpsCenter cannot talk to these agents over HTTP. Check that the OpsCenter machine can reach these agents via HTTP and check that SSL is correctly enabled or disabled in both OpsCenter and agent configurations. See Configure SSL for more information.

The DataStax Enterprise storage cluster is misconfigured.

The configuration for the DataStax Enterprise storage cluster does not match for all nodes in your cluster. See Storecollection data on a separate cluster and ensure the storage cluster is properly configured.

Node down.

The agent has confirmed that a node is down and requires investigation into the root cause. In addition to showing a node down in the Agents and Ring views, you can add an alert for nodes marked as down and configure alert notification using email or POSTing to a URL.

JMX is misconfigured.

Check the JMX settings configured in address.yaml. The agent is unable to connect to JMX with the settings configured in OpsCenter: - Either update the configuration in the OpsCenter Connection Settings > Edit Cluster dialog if all nodes have this error, or check the node-specific JMX config if this is an issue on a subset of nodes.

The agent is unable to connect to JMX and is using advanced JMX settings configured in address.yaml. The location of the address.yaml file depends on the type of installation:
Package installations: /var/lib/datastax-agent/conf/address.yaml
Tarball installations: install_location/conf/address.yaml Check and update the JMX settings on the node:
- jmx_host

Host used to connect to local JMX server. The default setting is localhost. This information will be sent by opscenterd for convenience, but can be configured locally as needed. Example:

`jmx_host: 127.0.0.1`

-   **jmx_port**

Port used to connect to local JMX server. The default setting is 7199. This information is sent by opscenterd for convenience, but can be configured locally as needed.

Example:

`jmx_port: 7199`

-   **jmx_user**

The username used to connect to the local JMX server. Example: jmx_user: jmx-username

-   **jmx_pass**

The password used to connect to the local JMX server. Example:

`jmx_pass: jmx-password` [This field may be encrypted for additional security.]

-   **jmx_metrics_threadpool_size**

The size of the threadpool used for collecting metrics over JMX.

Example:

`jmx_metrics_threadpool_size: 6`

Related information

Stop, start, and restart DataStax Agents

Troubleshoot DataStax Agent issues

Was this helpful?

Give Feedback