The Static Health integration is used to visualize static health information in StackState by reading from CSV files. The health consists of check states.
To set up the Static Health integration you will need to have:
StackState Agent V2 installed on a machine that can connect to StackState.
To configure the StackState Agent to read CSV health files:
Edit the Agent integration configuration file
/etc/stackstate-agent/conf.d/static_health.d/conf.yaml to include the following details:
type - set to
csv for parsing CSV typed files.
health_file - the absolute path to the CSV file containing health state information.
delimiter - the delimiter used in the CSV file.
init_config:instances:- type: csvhealth_file: /path/to/health.csvdelimiter: ';'
Restart the StackState Agent(s) to apply the configuration changes.
Once the Agent has restarted, wait for the Agent to collect data from the specified health CSV file and send it to StackState.
Static health is read from a CSV file with a header row, that specifies the fields that are included in the file. The available fields are listed in the table below.
Identification for the check state within the health stream.
The display name of the check state.
The health state of the check state. Can be clear, deviating or critical.
Identifier of the component or relation the check state will be attached to.
Additional descriptive message of the check state.
check_state_id,name,health,topology_element_identifier,messagecheck_1,Example check,critical,urn:component/some_component,Something went wrongcheck_2,Another example check,clear,urn:component/some_component,This is going well
The delimiter used in the CSV file can be specified when you configure the Static Health check on the StackState Agent.