API integration

This page describes StackState version 4.0.

The StackState 4.0 version range is End of Life (EOL) and no longer supported. We encourage customers still running the 4.0 version range to upgrade to a more recent release.

Go to the documentation for the latest StackState release.

What is the API-Integration StackPack?

The StackState API-Integration StackPack enables the StackState synchronization for the StackState's API-Integration Agents.

With API-Integration Agents you can run checks which connect to external systems like ServiceNow.

The StackState API-Integration Agent is open source: view the source code on GitHub.

Installation

Install the API-Integration StackPack by using the following sequence of steps:

1. Download the API-Integration Agent from Bintray

   Alternatively run this command on the machine where you wish to install the Agent:

    wget 'https://dl.bintray.com/stackstate-agent/stackstate-agent-deb-repo/pool/s/stackstate-agent/stackstate-agent_1.2.18-1_amd64.deb'

2. Use dpkg to install the Agent

    dpkg -i stackstate-agent_1.2.18-1_amd64.deb

3. Set the following keys in the stackstate.conf.example file:

    api_key: {{config.apiKey}}
    dd_url: {{config.baseUrl}}/stsAgent

   After this the example configuration can be used as configuration.

    cp /etc/sts-agent/stackstate.conf.example /etc/sts-agent/stackstate.conf

If you're still having trouble, our support team will be glad to provide further assistance.