al_agents cookbook

Installs and configures Log and Threat Manager agents.

Log Manager collects and normalizes log data from your entire infrastructure.
Threat Manager’s managed intrusion detection and vulnerability scanning services
provide ongoing insights into the threats and vulnerabilities affecting your
environment.

1. Requirements
2. Chef recipes
3. CloudInit
4. Contributing
5. License

Requirements

• Os: Ubuntu server 12.04, 13.10, Debian Squeeze or CentOS 6.5
• Arch: x86_64, i386.
• System logging: rsyslog, syslog-ng.

Recipes

al_agents::agent

All the attributes are accessible under node['alertlogic']['agent']
section.

Example:
json
{
"alertlogic": {
"agent": {
"provision_key": "0123456789abcdefghijklmnopqrstuvwxyz0123456789abcd"
}
},
"run_list": [
"recipe[al_agents::agent]"
]
}


al_agents::log_agent (DEPRECATED)

All the attributes are accessible under node['alertlogic']['log-agent']
section.

Example:
json
{
"alertlogic": {
"log-agent": {
"provision_key": "0123456789abcdefghijklmnopqrstuvwxyz0123456789abcd"
}
},
"run_list": [
"recipe[al_agents::log_agent]"
]
}


al_agents::threat_host (DEPRECATED)

All the attributes are accessible under node['alertlogic']['threat-host']
section.

Example:
json
{
"alertlogic": {
"threat-host": {
"provision_key": "0123456789abcdefghijklmnopqrstuvwxyz0123456789abcd"
}
},
"run_list": [
"recipe[al_agents::threat_host]"
]
}


CloudInit

CloudInit is the way to install something
onto cloud instances (i.e. amazon ec2).
You may find useful examples under [cloud-init](cloud-init/) directory.
In case of amazon ec2 just pass this .yml file as user-data, do not forget
to change provision_key.
This will install chef-client to your instance, download this cookbook and
run chef-solo.

Note that in case of amazon ec2 user-data will be accessible to any
user from within this instance.

Contributing

1. Fork the repository on Github
2. Create a named feature branch (like add_component_x)
3. Write your change
4. Write tests for your change (if applicable)
5. Run the tests, ensuring they all pass
6. Submit a Pull Request to master branch using Github

License

Distributed under the Apache 2.0 license.