Topology sources
StackState Self-hosted v5.1.x
Last updated
StackState Self-hosted v5.1.x
Last updated
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 has the following fields:
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 isn't 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 don't 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.
Snapshot mode
When topology data is sent in snapshot mode, it isn't 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.
