Configuration Files
Configuration is done through the BindPlane UI or can be done through configuration yaml files. The configuration yaml files are found under the config
folder in the install location of the UA. Any comments added to configuration files will be removed when configuration files are updated through BindPlane UI
Default Install Locations
Linux
/opt/bpagent
Windows
c:\bpagent
MacOS
/users/$USER/bpagent
OS
The os.yaml file controls the collection of OS metrics. If the os.yaml file is not present then UA will not collect OS metrics.
cpu:
collection_interval: 5s # Minimum 5s Maximum 1h Default 5s
enabled: true # Default: true
disk:
collection_interval: 1m0s # Minimum 1m Maximum 24h Default 1m
enabled: false # Default false
file_system:
collection_interval: 1m0s # Minimum 1m Maximum 24h Default 1m
enabled: false # Default false
load:
collection_interval: 1m0s # Minimum 5s Maximum 1h Default 1m
enabled: true # Default: true
memory:
collection_interval: 10s # Minimum 5s Maximum 1h Default 30s
enabled: true # Default: true
network:
collection_interval: 10s # Minimum 5s Maximum 1h Default 10s
enabled: true # Default: true
process:
collection_interval: 1m0s # Minimum 5s Maximum 24h Default 1m
enabled: false # Default false
Metrics Agent
Metrics configuration is located within the metrics/sources
and will be UUID .yaml file. Each source will have an associated file. This file configuration will differ for each type of source.
#Each source yaml file will contain the following properties.
#Name: Identifing name. This can be anything.
#Value Type: string
name: Source Name Example
#Type: This is the type of source. This must match the source type.
type: host
#Version: This is the version of the source
#Value Type: string
version: 3.0.0
Log Agent
The logging.yaml
file controls the level of detail and retention policy of the logs found in the install location under a log folder.
#Description: level sets the level of logging for universal agent.
#Value Type: string
#Default: INFO
#Value Options: DEBUG, INFO, WARN, ERROR, PANIC, FATAL
level: INFO
#Description: Maximum number of log files when before overwriting when rotating logs.
#Value Type: Int
#Default: 5
#Minimum: 1
max_backups: 1
#Description: Maximum size of log files when before overwriting when rotating logs.
#Value Type: Int
#Default: 1
#Minimum: 1
max_megabytes: 1
#Description: Maximum number of days to retain log files when before overwriting when rotating logs.
#Value Type: Int
#Default: 7
#Minimum: 1
max_days: 7
Remote
The remote.yaml file sets communication configuration with BindPlane. This file is configured automatically when installing via command provided through UI. If the remote.yaml file is not present it will not communicate with BindPlane.
#Agent_id: UUIDv4. This is required, but will be auto generated if missing when connecting to BindPlane
#Value Type: string
agent_id: b1ead1e1-7111-4177-861c-dfc71ff96d8a
#Secret_Key: UUIDv4. This is required. The secret key can be retrieved from the bindplane ui agent install command.
secret_key: b1ead1e1-7111-4177-861c-dfc71ff96d8a
Updated over 4 years ago