DataBot User Manual

From NovaOrdis Knowledge Base
Jump to navigation Jump to search

Internal

os-stats

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

https://github.com/NovaOrdis/os-stats/releases

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:

  1. Value of "OS_STATS_JAVA_HOME" environment variable, if set.
  2. Value of "JAVA_HOME" environment variable, if set.
  3. The "java" executable found in path.

Choose a directory to store the configuration file. If the configuration will be shared by multiple users, and 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. The location of the configuration file should be exposed as the value of the OS_STATS_CONF_DIR environment variable in the environment of the user to execute os-stats. If no OS_STATS_CONF_DIR is found, os-stats will default to ~/.os-stats and if the directory is not found, will complain and exit.


Complete any of target-specific configuration procedures, if they apply.

Target-Specific Configuration Procedures

JBoss

In-Line Help

os-stats --help

Configuration

TODO

Metric Reference

os-stats Metric Reference