DataBot User Manual: Difference between revisions
| Line 22: | Line 22: | ||
# The "java" executable found in path. | # The "java" executable found in path. | ||
Choose a directory to store the configuration file. If the configuration will be shared by multiple users | Choose a directory to store the configuration file. If the configuration will be shared by multiple users and there will be used by just one os-stats instance on the system, we recommend /etc/os-stats. Otherwise, each user could maintain an individual configuration file in ~/.os-stats (recommended) or a directory of their choosing. The location of the configuration file should be exposed as the value of the OS_STATS_CONF environment variable in the environment of the user who will execute os-stats. If no OS_STATS_CONF environment variable is defined, os-stats will attempt to read ~/.os-stats/os-stats.yaml. Regardless of how the configuration file is declared, os-stats will fail if the file is not found. | ||
Complete any of [[#Target-Specific_Configuration_Procedures|target-specific configuration procedures]], if they apply. | Complete any of [[#Target-Specific_Configuration_Procedures|target-specific configuration procedures]], if they apply. | ||
Revision as of 22:45, 12 May 2017
Internal
Overview
A low-overhead O/S level event collector that generates events-compatible events. It is designed to run in background, collect times events and channel them (to files, over the network, etc.) It is capable of collecting memory, CPU, etc. usage statistics, as well as WildFly management domain model and JMX metrics.
Installation
Download the stable release from
The release consists in a ZIP file with a name matching "os-stats-<version>.zip".
Unzip the release file in a conventional binary directory, such as /opt or /usr/local. An "os-stats-<version>" sub-directory will be created.
Add .../os-stats-<version>/bin to PATH.
os-stats needs a Java VM to run. It will attempt to locate one in this order:
- Value of "OS_STATS_JAVA_HOME" environment variable, if set.
- Value of "JAVA_HOME" environment variable, if set.
- The "java" executable found in path.
Choose a directory to store the configuration file. If the configuration will be shared by multiple users and there will be used by just one os-stats instance on the system, we recommend /etc/os-stats. Otherwise, each user could maintain an individual configuration file in ~/.os-stats (recommended) or a directory of their choosing. The location of the configuration file should be exposed as the value of the OS_STATS_CONF environment variable in the environment of the user who will execute os-stats. If no OS_STATS_CONF environment variable is defined, os-stats will attempt to read ~/.os-stats/os-stats.yaml. Regardless of how the configuration file is declared, os-stats will fail if the file is not found.
Complete any of target-specific configuration procedures, if they apply.
Target-Specific Configuration Procedures
JBoss
In-Line Help
os-stats --help
Configuration
TODO