Getting Started

So, you’ve just installed StackState and you are ready to get started.


The first step to take is integrating StackState with your IT systems. This can be done by installing one or more StackPacks.

StackPacks overview

Explore topology

After installing one or more StackPacks you can go to the Explore Mode to explore your IT landscape or visit a specific view from your installed StackPacks.

StackState visualizes components by the layer and domain they are placed in. These are logical groupings of components. Layers are displayed on the vertical axis. Domains are displayed on the horizontal axis.

You can change what part of the landscape (e.g. layers and domains) you are viewing with the filter options on the left side bar or by right clicking on a component.

Explore topology

Topology elements

A topology consists of components and relations combined with their health state. Because topologies can get very large StackState automatically groups the components.

The health state of a component is indicated by two colors: the outer color and the inner color. The inner color of a component indicates the health state that is calculated for the component itself. The outer color indicates the potential impact of components that this component depends on.

The direction of a relation’s arrow indicates dependency. For example, app -> db means: app depends on db. Health propagates in the opposite direction. So if the db component turns red, the app component will turn red too.



The timeline gives you the ability to go to any point in time. All the information that you see (e.g. component details, metric streams, etc.) depends on the time that is currently selected. Normally, StackState is in the live mode, meaning StackState will fully automatically display the latest state of the stack.


Component / relation details

To see the details of a component or a relation you can click on it. Click on “Show component properties” to see all the details of a component.

Component details

Metric inspector

Both components and relations can have one or multiple telemetry streams. The most common type is a metric stream also known as time series. If you click on a metric stream you can see the metric stream in a popup.

Metric inspector

If you click on a event stream you can see the event/log stream in a popup. Again, there are a number of drill-down capabilities available on the left side of the popup.

Event inspector

Problem pane

To quickly find the cause of any unhealthy component you can click on the problem icon on the right side bar. The problem pane will show you the causes of problems in your view. This summary is based on the components impacted in your current view combined with all (potential) causes. Problems are automatically clustered by their root cause.

Not all components displayed in the problem pane are necesarily also visible in the current topology view. To make the root cause of a problem visible right click on the component and select show -> root cause from the menu.

Component details

Events pane

To show all activity/events for the selected components in the current view you can click on the event pane button in the right side bar. Some important events that may appear here are health state changes and changes to the components themselves, like version changes. With view event handlers you can configure StackState to react to any kind of events, for example, by automatically creating a ticket or triggering some type of automation.