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.

    Agents tab for viewing Agents status

  • 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 agent install failed on the Agents tab also indicates there are issues that require your attention.

    Agents view showing multiple issues and available remedies

    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 Installing DataStax Agents 6.8.

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:

    Column description tooltips

  • When available, additional details display by hovering the mouse pointer over the status icons in each column:

    opscAgentsErrorTooltip

  • To view more details about the current state of an Agent, click anywhere in the row for the Agent. A JSON representation 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.

    opscAgentStatusDetailsJson

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 install failed in for installed status in the Last Known Version column; the Upgrade all agents button and What is impacted link are present.

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 limitations indicates that there could be some incompatibility but Agents degrade gracefully.

Agent version is equal to OpsCenter version.

Completely compatible versions. Ideal scenario.

Green checkmark lifecycleJobComplete for installed status in the Last Known Version column.

Icon Status Legend

The following table summarizes all of the icons that can appear in the Agents status columns:

Icon Description

agent install pending (rotating green circles)

Currently installing, configuring, or upgrading an Agent.

lifecycleJobPending (greenish yellow clock)

Agent install job pending.

agent service status unknown (yellow question mark)

Unknown status.

agent install failed(red exclamation point)

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 (greenish yellow warning bell)

Agent version limitations; partially compatible Agent versions.

lifecycleJobComplete (green check mark)

Up, satisfactory, or install complete status.