Topology sources
Configure topology sources in StackState
Last updated
Configure topology sources in StackState
Last updated
This page describes StackState version 4.2.
The StackState 4.2 version range is End of Life (EOL) and no longer supported. We encourage customers still running the 4.2 version range to upgrade to a more recent release.
Topology sources are used to get data from the Kafka bus, which receives the data from the StackState topology API. They can be configured from the StackState UI page Settings > Topology Synchronization > Sts sources. Each configured topology data source is listed here, together with its connection status and settings. You can also edit, delete and export topology data sources from this list.
To add a new topology data source, click ADD STS DATA SOURCE from the screen Settings > Topology Synchronization > Sts sources and enter the required configuration.
The screen contains the following fields:
Snapshot mode
When topology data is sent in snapshot mode, it is not necessary to expire elements. Each snapshot represents a complete landscape instance and elements missing from the snapshot will be automatically deleted.
See the Topology JSON format description for details.
| Field | Description |
|---|---|
Name
The name of the data source.
Description
Optional. A description of the data source.
Use StackState's default Kafka
Select to use either the default Kafka bus on the StackState server or a separate Kafka instance.
Kafka host(s)
Required if StackState's default Kafka is not used.
Instance type
The integration type. Select from the dropdown list. This list is populated with the type passed in the instance field in the source JSON data.
Topic
The Kafka topic to retrieve data from. Select from the dropdown list. This list is populated based on the type and url passed in the instance field in the source topology JSON.
Maximum batch size
The maximum number of components from a JSON file that are processed in a single batch. Used for rate limiting.
Expire elements
When enabled, topology elements will be set to expired if they do not appear in this data source for a configured amount of time. Expired elements will be automatically removed.
Expire after (minutes)
When Expire elements is enabled, this is the timeout period after which elements should be expired.
Identifier
Optional. A valid URN.
