Use Beaver to ship logs only when alternatives such as rsyslog , beats , nxlog or fluent-bit aren't available.
This usually is only the case with older platforms, which aren't supported by these agents.

To use Beaver, first verify your platform has Python version 2.6  or 2.7 .

Installation

It's best to install Beaver using pip , by running:

pip install beaver

If you can't use pip  (e.g. if you're not connected to the internet), create an offline installation tarball. Run the following on an internet-connected machine:

mkdir /tmp/beaver-deps
pip download beaver -d "/tmp/beaver-deps"
tar cvfz beaver-deps.tgz /tmp/beaver-deps

Copy the beaver-deps.tgz  file to the destination server, and run:

tar xvfz beaver-deps.tgz
cd beaver-deps
pip install Beaver-36.2.1-py2-none-any.whl -f ./ --no-index

Configuration

Next, create a configuration file. Create a file named beaver.ini  under /etc/conf and paste the following (making the required adjustments):

[beaver]
logstash_version: 0
; replace with the data-domain or IP of Sophie
tcp_host: <CUSTOMER_NAME>-data.loomsystems.com
; if Sophie is installed on-prem, replace with port configured in your data-input
tcp_port: 9999
format: json

[/path/to/*.log]
; use a descriptive type to these files
type: myType
; replace with descriptive tags
tags: tag1,tag2
; add descriptive fields
add_field: loomApplication,myApp,loomService,myService,loomSourceType,mySourceType,environment,prod

More configuration options can be found here.

Running Beaver

Save the file, then run Beaver:

beaver -c /etc/conf/beaver.ini -t tcp

If Beaver starts successfully, you can Daemonize it by adding the -D  argument.

That's it! once Beaver is running you should see logs appearing in Sophie.

Did this answer your question?