Static Topology
StackState Self-hosted v5.1.x
Last updated
StackState Self-hosted v5.1.x
Last updated
The Static Topology StackPack reads topology information from an and synchronizes the data with StackState.
Static Topology is a .
To set up the StackState Static Topology integration, you need to have:
A correctly formatted and .
installed on a machine that can connect to StackState.
Install the Static Topology StackPack from the StackState UI StackPacks > Integrations screen. You will need to enter the following details:
Path to component CSV file - the CSV file to read component data from.
Path to relation CSV file - the CSV file to read relation data from.
The CSV files should follow the and be available in a location where StackState Agent can read them, for example /etc/stackstate-agent/conf.d/
. StackState Agent V3 runs as system user/group stackstate-agent
.
To enable the Static Topology check and begin collecting topology data from the configured CSV files, add the following configuration to StackState Agent V3:
Copy the example Agent configuration file mv /etc/stackstate-agent/conf.d/static_topology.d/conf.yaml.example /etc/stackstate-agent/conf.d/static_topology.d/conf.yaml
.
Edit the copied Agent configuration file /etc/stackstate-agent/conf.d/static_topology.d/conf.yaml
to add details of the CSV files:
type - Set to csv
for parsing CSV files.
delimiter - The delimiter used in the CSV files.
You can also add optional configuration:
tags - Tags to add to the imported topology elements.
Verify that the files could be read successfully using the command:
Execute the info command and verify that the integration check has passed. The output of the command should contain a section similar to the following:
Static topology is read from two CSV files:
A CSV file containing components
A CSV file containing relations
Both CSV files are read to form a topology. The CSV file for components and relations have different requirements, these are described on this page. Both files require a CSV header.
The component CSV file has details of components. The file should contain a header with the following fields:
id
- The component's unique identifier.
name
- The component's name.
type
- The component type. For example, VM, datastore or rack.
domain
(Optional) - The StackState domain where the component should be visualized.
layer
(Optional) - The StackState layer in where the component should be visualized.
environment
(Optional) - The StackState environment in where the component should be visualized.
All other fields will be added as metadata on the component
The relation CSV file has details of relations between components. The file should contain a header with the following fields:
sourceid
- The identifier of the component to create a relation from. This must match the component id
in the component CSV file.
targetid
- The identifier of the component to create a relation to. This must identifier has to match the component id
in the component CSV file.
type
- The type of a relation. For example, 'uses' or 'depends on'.
StaticTopology StackPack v2.3.2 (2021-05-12)
Bugfix: Use the domain, layer, environment and type coming from data in component template
Example Agent configuration file for Static Topology:
components_file - Path to the to read component data from. The same as entered when the StackPack was installed.
relations_file - Path to the to read relation data from. The same as entered when the StackPack was installed.
5. to apply the configuration changes. 6.Once the Agent has restarted, wait for the Agent to collect data from the CSV files and send it to StackState.