💠StackState Agent V2

StackState Self-hosted v5.1.x

Overview

The StackState Agent V2 StackPack works with StackState Agent V3 to synchronize topology, metrics, events and traces data from external systems with StackState. A number of integrations are automatically enabled when the StackState Agent V2 StackPack is installed, however, integration with some systems will require an additional StackPack and configuration.

StackState Agent V2 is a StackState core integration.

Note on StackPack V2 and Agent V3

The StackState Agent V3 has been released with feature parity and full backwards-compatibility with the StackState Agent V2 StackPack. Agent V2 has been sunsetted, and no new features will be added to it. The core difference between V2 and V3 is the bundled Python runtime, and therefore Python support for custom StackPacks and integrations.

Please note that V3 refers only to the agent, and V2 is the version of the Agent StackPack. The StackState Agent V2 StackPack is compatible with StackState Agent V3.

Setup

Prerequisites

• StackState Agent V3 installed on a machine that can connect to StackState and any system you will integrate with.

Install

Install the StackState Agent V2 StackPack from the StackState UI StackPacks > Integrations screen.

Configure

The integrations included in the StackState Agent V2 StackPack are listed below. Refer to the integration pages to find configuration details for each integration:

• Apache TomCat

• AWS ECS

• AWS Xray

• DotNet APM

• Java APM

• JMX

• MySQL

• OpenMetrics

• PostgreSQL

• Static Health

• WMI

Status

To find the status of an installed Agent, use the status commands provided in the StackState Agent documentation.

Upgrade

When a new version of the StackState Agent V2 StackPack is available in your instance of StackState, you will be prompted to upgrade in the StackState UI on the page StackPacks > Integrations > StackState Agent V3.

For an overview of recent StackPack updates, check the StackPack versions shipped with each StackState release.

To upgrade StackState Agent V3, see the StackState Agent documentation.

Integration details

Data retrieved

When installed and running, StackState Agent V3 will synchronize the following data with StackState from the host it's running on:

Linux:

• Hosts, processes and containers

• Network connections between processes and containers including network traffic telemetry

• Telemetry for hosts, processes and containers

Docker:

• Hosts, processes, and containers

• Network connections between processes, containers and services including network traffic telemetry

• Telemetry for hosts, processes, and containers

• Trace Agent support

When additional checks have been enabled on the Agent, data from other external systems will be integrated. Refer to the individual integration pages for details of the data retrieved from each system.

Troubleshooting

Troubleshooting steps for any known issues can be found in the StackState support knowledge base.

Uninstall

Uninstall the StackState Agent V2 StackPack from the StackState UI StackPacks > Integrations screen.

To uninstall StackState Agent V3, see the StackState Agent documentation.

Release notes

Agent V2 StackPack v4.5.2 (2022-06-10)

• Improvement: Added CPU throttled metrics for containers.

Agent V2 StackPack v4.5.1 (2022-04-08)

• Improvement: Added a Deprovisioning screen when uninstalling the StackState Agent V2 StackPack.

Agent V2 StackPack v4.5.0 (2022-03-02)

• Feature: Automatically add OpenTelemetry HTTP health checks

  • Error count (sum) check

  • Request count (sum) check

  • Response Time (milliseconds) check

• Feature: Add Container integration DataSource and Sync

Agent V2 StackPack v4.4.14 (2022-02-18)

• Feature: Health check added for HTTP error (5xx) rate over total rate ratio

Agent V2 StackPack v4.4.13 (2022-02-03)

• Improvement: Documentation updated - added documentation for OpenMetrics integration.

• Feature: Automatically add anomaly health checks for golden signals

  • HTTP Success response time (s) (95th percentile) AAD Check

  • HTTP 5xx error response time (s) (95th percentile) AAD Check

  • HTTP total response time (s) (95th percentile) AAD Check

  • HTTP Success rate (req/s) AAD Check

  • HTTP 5xx error rate (req/s) AAD Check

Agent V2 StackPack v4.4.12 (2021-12-15)

• Improvement: Supported additional identifiers for Disk component

See also

• StackState Agent documentation