Topology - script API
Functions for accessing the topology.
This page describes StackState version 4.3.
The StackState 4.3 version range is End of Life (EOL) and no longer supported. We encourage customers still running the 4.3 version range to upgrade to a more recent release.
Query the topology at any point in time. Builder methods available for extracting components, relations and comparing topological queries.
Topology.query(query: String)
Args:
Returns:
AsyncScriptResult[TopologyScriptApiQueryResponse]Builder methods:
- Use an
instantto query for transactions that started at a specific timestamp including at any point in the past. - Use the
currentTimesliceto query for all transactions currently started or in progress.
diff(queryResult: TopologyScriptApiQueryResponse)- compares this query with another query. A query should be the result of a call to this function.diffWithPrev(queryResult: TopologyScriptApiQueryResponse)- compares this query with the last query in the chain. A query should be the result of a call to this function. This builder method is only available after thediffbuilder method was called.components()- returns a summary of the components. After this builder method no more builder methods can be called.fullComponents()- returns the component with all their data. After this builder method no more builder methods can be called.problems()- returns problems for a given query along with the root cause and its contributing problems.relations()- returns a summary of the relations. After this builder method no more builder methods can be called.fullRelations()- returns the relations with all their data. After this builder method no more builder methods can be called.
Examples:
- Get the test environment:Topology.query('environments in ("test")')
- Get the test environment yesterday:Topology.query('environments in ("test")').at('-1d')
- Get test environment one hour ago, two hours ago and three hours ago.Topology.query('environments in ("test")').at('-1h').repeatAt('-2h').repeatAt('-3h')
- Get the component that differ between the test and production environment:Topology.query('environments in ("test")').diff(Topology.query('environments in ("production")')).components()
- Get the difference between the test environment one week ago and now:def q = 'environments in ("test")'Topology.query(q).at('-1w').diff(Topology.query(q))
- Topology.query('environments in ("test")').components().thenCollect { it.name }
- Get the first root problem's first failing check - likely a major root cause of a problem in the queried topology:Topology.query('environments in ("test")').problems().then{ problems ->problems.isEmpty()? null : problems[0].failingCheckNames[0]}
Last modified 10mo ago