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.
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 the Custom Synchronization StackPack from the StackState UI StackPacks > Integrations screen. You will need to provide the following parameters:
- Instance type (source identifier) -
- Instance URL
These are directly mapped to the
TopologyInstancesupplied in the
get_instance_keyfunction of your agent check.
In the example Agent check below StackState, the Custom Synchronization StackPack Instance type would be
exampleand the Instance URL would be
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.