sumologic-collector Cookbook

This cookbook installs the Sumo Logic collector on Linux using the shell script installer. Here are the steps it follows:

1. Sets up sumo.conf and sumo.json with standard Linux logs
2. Downloads latest installer
3. Runs installer
4. Starts collector and registers with the Sumo Logic service

The collector Requires outbound access to https://collectors.sumologic.com. Edit sumo.json to add/edit/remove sources. After installation you can test connectivity.

Installation

1. Create an Access Key
2. Install the cookbook in your Chef repo:

knife cookbook github install SumoLogic/sumo-collector-chef-cookbook

3. Specify data bag and item with your access credentials. The data item should contain attributes accessID and accessKey. The default data bag/item is ['sumo-creds']['api-creds']

4. Upload the cookbook to your Chef Server:

knife cookbook upload sumologic-collector

5. Add the sumologic-collector receipe to your node run lists. This step depends on your node configuration, so specifics will not be described in this README.md.

Attributes

['sumologic']['ephemeral']	Boolean	Sumo Logic Ephemeral Setting	Required
['sumologic']['sources']['default_timezone']	String	Timezone for source setup (defaults to UTC)	Required
['sumologic']['installDir']	String	Sumo Logic Install Directory	Required
['sumologic']['ephemeral']	Boolean	Sumo Logic Ephemeral Setting	Required
['sumologic']['sources']['default_timezone']	String	Timezone for source setup (defaults to UTC)	Required
['sumologic']['installDir']	String	Sumo Logic Install Directory	Required
['sumologic']['credentials']['bag_name']	String	Name of the data bag.	Required
['sumologic']['credentials']['item_name']	String	Name of the item within the data bag.	Required
['sumologic']['credentials']['secret_file']	String	Path to the local file containing the encryption secret key.	Optional

Contributing

This cookbook is meant to help customers use Chef to install Sumo Logic collectors, so please feel to fork this repository, and make whatever changes you need for your environment.

License and Authors

Authors: Ben Newton ([email protected])