StackState Docs
v5.1
StackState.comDownloadSupportExplore playground
Search…
⌃K
Links

Advanced Agent configuration

StackState Self-hosted v5.1.x

Overview

A number of advanced configuration options are available for StackState Agent V2. These can be set either in the stackstate.yaml configuration file (Linux and Windows) or using environment variables (Docker, Kubernetes and OpenShift).

Reduce data production

The StackState Agent V2 collection interval can be configured. This will reduce the amount of data produced by the Agent.
Kubernetes, OpenShift
Docker
Linux
Windows
To configure the collection interval of the Kubernetes and system level integrations, create a values.yaml file with the below contents and specify this when you install/upgrade StackState Agent V2. In this values.yaml example, the min_collection_interval has been set to double the default setting. This should result in a noticeable drop in the amount of data produced. If required, you can increase the interval further, however, the aim should be to find a balance between the frequency of data collection and the amount of data received by StackState:
1
nodeAgent:
2
config:
3
override:
4
- name: conf.yaml
5
path: /etc/stackstate-agent/conf.d/kubelet.d
6
data: |
7
init_config:
8
instances:
9
- min_collection_interval: 60
10
- name: conf.yaml
11
path: /etc/stackstate-agent/conf.d/memory.d
12
data: |
13
init_config:
14
instances:
15
- min_collection_interval: 30
16
- name: conf.yaml
17
path: /etc/stackstate-agent/conf.d/cpu.d
18
data: |
19
init_config:
20
instances:
21
- min_collection_interval: 30
22
- name: conf.yaml
23
path: /etc/stackstate-agent/conf.d/disk.d
24
data: |
25
init_config:
26
instances:
27
- min_collection_interval: 30
28
use_mount: false
29
excluded_filesystems:
30
- tmpfs
31
- squashfs
32
- name: conf.yaml
33
path: /etc/stackstate-agent/conf.d/io.d
34
data: |
35
init_config:
36
instances:
37
- min_collection_interval: 30
38
- name: conf.yaml
39
path: /etc/stackstate-agent/conf.d/load.d
40
data: |
41
init_config:
42
instances:
43
- min_collection_interval: 30
44
- name: conf.yaml
45
path: /etc/stackstate-agent/conf.d/docker.d
46
data: |
47
init_config:
48
instances:
49
- min_collection_interval: 30
50
- name: conf.yaml
51
path: /etc/stackstate-agent/conf.d/file_handle.d
52
data: |
53
init_config:
54
instances:
55
- min_collection_interval: 30
56
- name: auto_conf.yaml
57
path: /etc/stackstate-agent/conf.d/kubernetes_state.d
58
data: |
59
- name: stackstate.yaml
60
path: /etc/stackstate-agent
61
data: |
62
## Provides autodetected defaults, for kubernetes environments,
63
## please see stackstate.yaml.example for all supported options
64
​
65
# Autodiscovery for Kubernetes
66
listeners:
67
- name: kubelet
68
config_providers:
69
- name: kubelet
70
polling: true
71
72
process_config:
73
intervals:
74
container: 40
75
process: 30
76
connections: 30
77
​
78
apm_config:
79
apm_non_local_traffic: true
80
max_memory: 0
81
max_cpu_percent: 0
82
​
83
# Use java container support
84
​
85
clusterAgent:
86
config:
87
override:
88
- name: conf.yaml
89
path: /etc/stackstate-agent/conf.d/kubernetes_state.d
90
data: |
91
cluster_check: true
92
init_config:
93
instances:
94
- kube_state_url: http://YOUR_KUBE_STATE_METRICS_SERVICE_NAME:8080/metrics
95
min_collection_interval: 60
Specify the values.yaml file during installation / upgrade of the StackState Agent with the --values argument:
helm upgrade --install \
--namespace stackstate \
--create-namespace \
--set-string 'stackstate.apiKey=<STACKSTATE_RECEIVER_API_KEY>' \
... (set all custom fields)
--values values.yaml
stackstate-agent stackstate/stackstate-agent
To reduce data production in StackState Agent running in a Docker container:
  1. 1.
    Configure the min_collection_interval for each of the following system integrations. The default setting is 15 seconds. Doubling this value should result in a noticeable drop in the amount of data produced. If required, you can increase the interval further, however, the aim should be to find a balance between the frequency of data collection and the amount of data received by StackState:
    • Memory - /etc/stackstate-agent/conf.d/memory.d/conf.yaml
    • CPU - /etc/stackstate-agent/conf.d/cpu.d/conf.yaml
    • Disk - /etc/stackstate-agent/conf.d/disk.d/conf.yaml
    • Load - /etc/stackstate-agent/conf.d/load.d/conf.yaml
    • File handle - /etc/stackstate-agent/conf.d/file_handle.d/conf.yaml
  2. 2.
    Set the intervals for process, container and connection gathering in /etc/stackstate-agent/stackstate.yaml:
    process_config:
    intervals:
    container: 40
    process: 30
    connections: 30
  3. 3.
    Mount the config files as a volume into the container running the Agent as described in Docker Agent integration configuration.
To reduce data production in StackState Agent running on Linux:
  1. 1.
    Configure the min_collection_interval for each of the following system integrations. The default setting is 15 seconds. Doubling this value should result in a noticeable drop in the amount of data produced. If required, you can increase the interval further, however, the aim should be to find a balance between the frequency of data collection and the amount of data received by StackState:
    • Memory - /etc/stackstate-agent/conf.d/memory.d/conf.yaml
    • CPU - /etc/stackstate-agent/conf.d/cpu.d/conf.yaml
    • Disk - /etc/stackstate-agent/conf.d/disk.d/conf.yaml
    • Load - /etc/stackstate-agent/conf.d/load.d/conf.yaml
    • File handle - /etc/stackstate-agent/conf.d/file_handle.d/conf.yaml
  2. 2.
    Set the intervals for process, container and connection gathering in /etc/stackstate-agent/stackstate.yaml:
    process_config:
    intervals:
    container: 40
    process: 30
    connections: 30
To reduce data production in StackState Agent running on Windows:
  1. 1.
    Configure the min_collection_interval for each of the following system integrations. The default setting is 15 seconds. Doubling this value should result in a noticeable drop in the amount of data produced. If required, you can increase the interval further, however, the aim should be to find a balance between the frequency of data collection and the amount of data received by StackState:
    • Memory - C:\ProgramData\StackState\conf.d\memory.d\conf.yaml
    • CPU - C:\ProgramData\StackState\conf.d\cpu.d\conf.yaml
    • Disk - C:\ProgramData\StackState\conf.d\disk.d\conf.yaml
    • Load - C:\ProgramData\StackState\conf.d\load.d\conf.yaml
    • File handle - C:\ProgramData\StackState\conf.d\file_handle.d\conf.yaml
  2. 2.
    Set the intervals for process, container and connection gathering in C:\ProgramData\StackState\stackstate.yaml:
    process_config:
    intervals:
    container: 40
    process: 30
    connections: 30

Use a proxy for HTTP/HTTPS

The Agent can be configured to use a proxy for HTTP and HTTPS requests. For details, see use an HTTP/HTTPS proxy.

Blacklist and inclusions

Processes reported by StackState Agent V2 can optionally be filtered using a blacklist. Using this in conjunction with inclusion rules will allow otherwise excluded processes to be included.
The blacklist is specified as a list of regex patterns. Inclusions override the blacklist patterns, these are used to include processes that consume a lot of resources. Each inclusion type specifies an amount of processes to report as the top resource using processes. For top_cpu and top_mem a threshold must first be met, meaning that a process needs to consume a higher percentage of resources than the specified threshold before it's reported.
Docker, Kubernetes, OpenShift
Linux, Windows
To specify a blacklist or inclusions, set the associated environment variables and restart StackState Agent V2.
Environment variable
Description
STS_PROCESS_BLACKLIST_PATTERNS
A list of regex patterns that will exclude a process if matched. Default patterns (github.com).
STS_PROCESS_BLACKLIST_INCLUSIONS_CPU_THRESHOLD
Threshold that enables the reporting of high CPU usage processes.
STS_PROCESS_BLACKLIST_INCLUSIONS_TOP_CPU
The number of processes to report that have a high CPU usage. Default 0.
STS_PROCESS_BLACKLIST_INCLUSIONS_TOP_IO_READ
The number of processes to report that have a high IO read usage. Default 0.
STS_PROCESS_BLACKLIST_INCLUSIONS_TOP_IO_WRITE
The number of processes to report that have a high IO write usage. Default 0.
STS_PROCESS_BLACKLIST_INCLUSIONS_MEM_THRESHOLD
Threshold that enables the reporting of high memory usage processes.
STS_PROCESS_BLACKLIST_INCLUSIONS_TOP_MEM
The number of processes to report that have a high memory usage. Default 0.
To specify a blacklist or inclusions, edit the below settings in the Agent configuration file stackstate.yaml and restart StackState Agent V2.
  • Linux - /etc/stackstate-agent/stackstate.yaml
  • Windows - C:\ProgramData\StackState\stackstate.yaml
Configuration item
Description
process_blacklist.patterns
A list of regex patterns that will exclude a process if matched. Default patterns (github.com).
process_blacklist.inclusions.cpu_pct_usage_threshold
Threshold that enables the reporting of high CPU usage processes.
process_blacklist.inclusions.amount_top_cpu_pct_usage
The number of processes to report that have a high CPU usage. Default 0.
process_blacklist.inclusions.amount_top_io_read_usage
The number of processes to report that have a high IO read usage. Default 0.
process_blacklist.inclusions.amount_top_io_write_usage
The number of processes to report that have a high IO write usage. Default 0.
process_blacklist.inclusions.mem_usage_threshold
Threshold that enables the reporting of high memory usage processes.
process_blacklist.inclusions.amount_top_mem_usage
The number of processes to report that have a high memory usage. Default 0.

Enable traces

The trace Agent will be enabled by default when StackState Agent is installed. It's required to receive traces in StackState. In case it has been disabled, you can enable it again using the instructions below.
Docker
Linux
Windows
To enable tracing on StackState Agent running on Docker, edd the following parameters to your docker run command:
  • -e STS_APM_URL="https://stackstate-ip:receiver-port/stsAgent"
    • The default StackState Receiver port is 7077.
  • -e STS_APM_ENABLED="true"
    • Allows the StackState Trace Agent to capture traces.
To enable tracing on StackState Agent running on Linux, edit the configuration file /etc/stackstate-agent/stackstate.yamland set the following variables:
  • apm_sts_url="https://stackstate-ip:receiver-port/stsAgent"
    • The default StackState Receiver port is 7077.
  • enabled="true"
    • Can be found under apm_config.enabled.
    • Allows the StackState Trace Agent to capture traces.
To enable tracing on StackState Agent running on Windows, edit the configuration file C:\ProgramData\StackState\stackstate.yaml and change the following variables:
  • apm_sts_url="https://stackstate-ip:receiver-port/stsAgent"
    • The default StackState Receiver port is 7077.
  • enabled="true"
    • Can be found under apm_config.enabled.
    • Allows the StackState Trace Agent to capture traces.

Disable Agent features

Certain features of the Agent can optionally be turned off if they aren't needed.
Docker, Kubernetes, OpenShift
Linux, Windows
To disable a feature, set the associated environment variable and restart StackState Agent V2.
Environment variable
Description
STS_PROCESS_AGENT_ENABLED
Default true (collects containers and processes). Set to false to collect only containers, or disabled to disable the process Agent.
STS_APM_ENABLED
Default true. Set to "false" to disable the APM Agent.
STS_NETWORK_TRACING_ENABLED
Default true. Set to false to disable the network tracer.
To disable a feature, edit the below settings in the Agent configuration file stackstate.yaml and restart StackState Agent V2.
  • Linux - /etc/stackstate-agent/stackstate.yaml
  • Windows - C:\ProgramData\StackState\stackstate.yaml
Configuration item
Description
process_config.enabled
Default true (collects containers and processes). Set to false to collect only containers, or disabled to disable the process Agent.
apm_config.enabled
Default true. Set to "false" to disable the APM Agent.
network_tracer_config.network_tracing_enabled
Default true. Set to false to disable the network tracer.
Previous
Windows
Next
Use an HTTP/HTTPS proxy
Last modified 1mo ago