StackState version 4.5
StackPacks
Static Health
StackState Self-hosted v4.5.x
Overview
The Static Health integration is used to visualize static health information in StackState by reading from CSV files. The health consists of check states.
Setup
Prerequisites
To set up the Static Health integration you will need to have:
Configure
To configure the StackState Agent to read CSV health files:
- 1.Edit the Agent integration configuration file
/etc/stackstate-agent/conf.d/static_health.d/conf.yamlto include the following details:- type - set to
csvfor 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.1init_config:23instances:4- type: csv5health_file: /path/to/health.csv6delimiter: ';'Copied!
- 2.
- 3.Once the Agent has restarted, wait for the Agent to collect data from the specified health CSV file and send it to StackState.
The configured
collection_interval will be used as the repeat_interval for the health synchronization. Make sure that the value set for the the collection_interval matches the time that the check will take to run.CSV file format
Fields
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.
Field name
Mandatory
Description
check_state_id
yes
Identification for the check state within the health stream.
name
yes
The display name of the check state.
health
yes
The health state of the check state. Can be clear, deviating or critical.
topology_element_identifier
yes
Identifier of the component or relation the check state will be attached to.
message
no
Additional descriptive message of the check state.
Example health CSV file
1
check_state_id,name,health,topology_element_identifier,message
2
check_1,Example check,critical,urn:component/some_component,Something went wrong
3
check_2,Another example check,clear,urn:component/some_component,This is going well
Copied!
Delimiter
The delimiter used in the CSV file can be specified when you configure the Static Health check on the StackState Agent.
See also
Last modified 20d ago