Connect an Agent check to StackState

StackState Self-hosted v4.5.x

This page describes StackState v4.5.x. The StackState 4.5 version range is End of Life (EOL) and no longer supported. We encourage customers still running the 4.5 version range to upgrade to a more recent release.

Go to the documentation for the latest StackState release.

Overview

The recommended way to connect your Agent check and visualize the data within StackState is to install the Custom Synchronization StackPack. Note that the Custom Synchronization StackPack only supports a single instance, to synchronize multiple instances you will need to create a multi-tenant StackPack.

Install

Install the Custom Synchronization StackPack from the StackState UI StackPacks > Integrations screen. You will need to provide the following parameters:

• Instance type (source identifier) - TopologyInstance

• Instance URL

These are directly mapped to the TopologyInstance supplied in the get_instance_key function of your agent check.

In the example Agent check below StackState, the Custom Synchronization StackPack Instance type would be example and the Instance URL would be instance_url.

    def get_instance_key(self, instance):
        if 'url' not in instance:
            raise ConfigurationError('Missing url in topology instance configuration.')

        instance_url = instance['url']
        return TopologyInstance("example", instance_url)

When the StackPack has been installed, the Custom Synchronization should become enabled and you should start to see the topology coming in for your Agent Check.

See also

• Agent check API

• How to develop Agent checks

• Developer guide - Custom Synchronization StackPack