Component actions
StackState Self-hosted v4.5.x
This page describes StackState v4.5.x. The StackState 4.5 version range is End of Life (EOL) and no longer supported. We encourage customers still running the 4.5 version range to upgrade to a more recent release.
Overview
This how to describes the steps to create a component action that is available for specific components. Component actions can be executed from the component context menu in the StackState Topology Perspective or the details pane on the right of the StackState UI.
Add or edit a component action
The component actions available in StackState can be managed in the StackState UI from the page Settings > Actions > Component Actions.
To add a new component action, click the ADD COMPONENT ACTION button.
To edit an existing component action, click on the ... menu to the right of its description and select Edit.
Each component action includes the following details:
Name - The name displayed to users in the StackState UI when the component action is available for a component. The component action name is case-sensitive.
Description - The text shown in the tooltip when a user hovers over the component action name in the StackState UI.
STQL Query - An advanced topology query that returns all components for which this component action should be available. For details, see the STQL Query section below.
Script - A script written in StackState Scripting Language that is run whenever the component action is executed in the StackState UI. For details, see the script section and the example scripts below.
Identifier - Optional. A unique identifier for the component action. For details, see the identifier section below.
STQL query
The STQL query specified in a component action determines which components of the topology will be able to use this component action. This should be an advanced topology query that returns all of the components that should have access to this specific component action. For example, to bind a component action to all components in the "Production" domain that are present in the "databases" layer, you would use the STQL query:
You can find more information about writing advanced topology queries in StackState on the page using STQL.
Script
The script determines behavior of the component action when it is executed by a user. YOu can use the StackState Scripting Language to script almost any action you need, such as redirecting a user to another view with a specific context, restarting remote components, or calling predictions for components. Some example scripts are available below to help you get started.
Component action scripts always have access to a component
variable, this represents the component for which the component action was invoked.
The properties in the table below can be accessed directly in the component action script:
Other component properties can also be accessed using the component script API.
Identifier
Providing an identifier is optional, but is necessary when you want to store your component action in a StackPack. A valid identifier for a component action is a URN that follows the convention:
Example scripts
Show a topology query
The component action script below will direct the StackState UI to open a new topology query:
Navigate the user to an external URL
The component action script below will direct the StackState UI to navigate to a specific URL:
Make HTTP requests
The component action script below will invoke an HTTP request to a remote URL. This call is made from the StackState server:
See also
Last updated