DataStax Agents status view
View the current installation, configuration, and connection status of Agents. Agent status automatically updates in the list view as the information becomes available within OpsCenter. Use the features in the Agents view to set up, upgrade, and configure Agents when the status prompts indicate issues and provide buttons to launch the Agent installation processes. Interpret the information provided to troubleshoot Agent installation, configuration, and connections.
Access the Agents view
To access the Agents view:
-
Click cluster > Nodes > Agents tab.
-
Agent issue indicators: If displayed in the Agent issues detected banner at the top of the OpsCenter workspace, click the Show Details > problems link. The banner displays for Agent issues that require immediate attention, such as incompatible Agent versions or connection issues. A red exclamation mark
on the Agents tab also indicates there are issues that require your attention.
The Agents status page is divided into Healthy, Pending, and Unhealthy sections depending on the current status of your environment. Any unhealthy DataStax Agents that need attention appear at the top of the list.
Also see Install DataStax Agents.
Review Agent status information summary
Review the available Agent information:
-
An Upgrade all agents button is available to upgrade nodes that have an incompatible Agent version installed. To view which services might be adversely impacted, click the What is impacted link.
When the upgrade all Agents prompt is displayed, DataStax recommends upgrading all Agents immediately to avoid any loss of functionality.
-
An Upgrade agents button is available to upgrade nodes that do not have the most current version of the Agent installed.
DataStax recommends keeping the installed Agent versions up-to-date and homogeneous on all nodes.
For more details, see DataStax Agent version compatibility with OpsCenter version below.
-
A Set Up Agents button is available to queue installation for any nodes that currently do not have the Agent installed.
-
A Configure Agents button is available when Agents cannot connect to OpsCenter because the Agents are misconfigured. Click Configure Agents to update the STOMP configuration for those Agents.
-
If there is a problem with an Agent connection to OpsCenter, the issue and status is clearly indicated in the appropriate column. Hover over each column to view its description:
-
When available, additional details display by hovering the mouse pointer over the status icons in each column:
-
To view more details about the current state of an Agent, click anywhere in the row for the Agent. A
JSONrepresentation of the Agent status details is displayed. The condition of an Agent and the status of its individual services is visible. The type of Agent install (package or tarball) is also indicated.
DataStax Agent version compatibility with OpsCenter version
The following table summarizes the visual indicators when the Agent version is earlier than, the same as, or greater than the currently installed version of OpsCenter:
| Installed DataStax Agent vs. OpsCenter version | Result and recommendation | Visual indicators |
|---|---|---|
Agent version is earlier than OpsCenter 6.1.0. For example, 6.0.3 as shown in the Agent issues image above. |
Incompatible versions require upgrading Agents. |
Red exclamation point |
Agent version is not up-to-date with the OpsCenter version but is 6.1.0 or later. For example, OpsCenter is version 6.1.2 (future hypothetical release version) but the Agent is version 6.1.1. Going forward from OpsCenter version 6.1, OpsCenter has improved backward-compatibility with Agent versions for future releases. |
Partially compatible versions. The currently installed version of OpsCenter is backward-compatible enough with the currently installed Agent version so as not to cause any loss of service. Upgrading the Agent version is recommended. |
Yellow warning bell |
Agent version is equal to OpsCenter version. |
Completely compatible versions. Ideal scenario. |
Green checkmark |
Icon status legend
The following table summarizes all of the icons that can appear in the Agents status columns:
| Icon | Description |
|---|---|
|
Currently installing, configuring, or upgrading an Agent. |
|
Agent install job pending. |
|
Unknown status. |
|
Down, incompatible version, Agent install failed, or some other issue status as indicated in context within each column in the Agents status view. |
|
Agent version limitations; partially compatible Agent versions. |
|
Up, satisfactory, or install complete status. |
