Hiveary Agent by Hiveary, Inc. info@hiveary.com https://github.com/hiveary/hiveary-agent Version 1.4.0

Hiveary is an intelligent server monitoring solution that automatically finds anomalies.

Download the source code and run python setup.py install.

1. First ensure you have signed up for an account at https://hiveary.com.
2. Grab your existing access token or generate a new one at https://hiveary.com/tokens
3. Set up /etc/hiveary.conf with a json object containing your username, access_token, and the enabled monitors. You can copy /etc/hiveary.conf.example as a template.
4. And thats it! All setup.

The recommended way to run on Windows is to use a prebuilt installer, available from https://hiveary.com/agent/install Otherwise follow these instructions to install from source.

1. Install http://sourceforge.net/projects/pywin32/files/pywin32/
2. Ensure you have signed up for an account at hiveary.com.
3. Grab your existing access token or generate a new one at https://hiveary.com/tokens
4. Create a Hiveary subfolder in the CommonAppDataFolder. On XP this should be C:\Documents and Settings\All Users\Application Data\Hiveary, and on Vista or higher it is C:\ProgramData\Hiveary.
5. Set up hiveary.conf in the new subfolder with a json object containing your username, access_token, and the enabled monitors. You can copy /etc/hiveary.conf.example as a template.
6. And thats it! All setup.

The agent is designed to run in the background as a daemon; however, running it with no arguments will cause it to run in the foreground. There are a number of flags to overide default behavior.

usage: hiveary-agent [-h] [-t ACCESS_TOKEN] [-s SERVER] [-c CONFIG_FILE] [-u]
                     [-d] [--disable_ssl_verify] [--amqp_server AMQP_SERVER]
                     [--ca_bundle CA_BUNDLE] [--username USERNAME]
                     [{start,stop,restart,status}]

positional arguments:
  {start,stop,restart,status}

optional arguments:
  -h, --help            show this help message and exit
  -t ACCESS_TOKEN, --access_token ACCESS_TOKEN
                        OAuth access token generated by the server.
  -s SERVER, --server SERVER
  -c CONFIG_FILE, --config_file CONFIG_FILE
                        Location of config file. (default: config.json)
  -u, --update          Store the passed values in the configuration file
  -d, --debug           Enable debug mode
  --disable_ssl_verify  Disable SSL certificate verification
  --amqp_server AMQP_SERVER
                        Address of the AMQP server. Defaults to the subdomain
                        "amqp" of the server address (ie amqp.hiveary.com).
  --ca_bundle CA_BUNDLE
                        Location of the CA bundle for SSL verification. Has no
                        effect when combined with --disable_ssl_verify.
  --username USERNAME

On Windows, the agent logs are located under the CommonAppDataFolder. For XP, the folder is C:\Documents and Settings\All Users\Application Data\Hiveary\logs, For Vista and higher, the folder is C:\ProgramData\Hiveary\logs On OS X and Linux, the agent logs are located in /var/log/hiveary.