StackPacks & integrations

What is a StackPack?

A StackPack is a complete configuration package for StackState that simplifies the setup of deep integrations with various external services. It can be easily installed and uninstalled.

What is the difference between a StackPack and an integration?

StackPacks are plugins for StackState which extend the functionality of StackState. For now all StackPack’s provide a way to configure StackState in an automated way to integrate with specific systems.

Which StackPacks are available?

For an overview of the available StackPacks, see <stackstate>/stackpacks.

How to install a StackPack or an Integration

Choose the desired StackPack or Integration and proceed to its page. There you can see the overview of the StackPack or an Integration, list of already installed Instances (if any) and helpful resources and FAQs. Integrations are provided by a StackPack. To install a specific Integration you will need to install the StackPack that provides it.

Before installation of a StackPack or an Integration please make sure you meet all prerequisites listed on the page.

To install an instance of a StackPack:

  • Press Add new Configuration button.
  • Fill in all the required fields - some of the StackPacks may require such data as credentials, access keys, passwords or any other configuration parameters that can be necessary during installation. An explanation for each of the required parameters will be provided on the StackPack page.
  • Click the Install button.
  • Provisioning of a StackPack may take some time as it potentially installs and configures many different objects for you. You will see a loading indicator while the provisioning is still in-progress.
  • After the provisioning is done you may be presented with additional installation instructions to be executed outside of StackState. During this time the StackPack is provisioned but waiting for data so it is not considered installed yet. Follow the instructions to finalize the installation.
  • When the Instance receives the data that it expects, it will register itself as installed and the StackPack will be ready to go.

Standard StackPacks

There are a few standard StackPacks available in StackState that you can install.

Manual Topology StackPack

This StackPack contains everything you need to manually create topology (components and relations) in StackState.

Use the Manual Topology StackPack if you want to create topology in StackState via the GUI.

Custom Synchronization StackPack

This StackPack contains everything you need to automatically synchronize topology information from an external topology source.

Use the Custom Synchronization StackPack if you want to connect an external topology source that is not listed as a standard StackPack.

StackState Agent StackPack

The StackState Agent StackPack installs the StackState Agent. The agent instruments physical or virtual machines and sends telemetry and topology information to StackState.

The StackState Agent is supported on the following platforms:

OSReleaseArchNetwork TracerStatusNotes
UbuntuTrusty (14)64bit-OK-
UbuntuXenial (16)64bitOKOK-
UbuntuBionic (18)64bitOKOK-
DebianWheezy (7)64bit--Needs glibc upgrade to 2.17
DebianJessie (8)64bit-OK-
DebianStretch (9)64bitOKOK-
CentOS664bit--Needs glibc upgrade to 2.17