Adoptable Cookbooks List

Looking for a cookbook to adopt? You can now see a list of cookbooks available for adoption!
List of Adoptable Cookbooks

Supermarket Belongs to the Community

Supermarket belongs to the community. While Chef has the responsibility to keep it running and be stewards of its functionality, what it does and how it works is driven by the community. The chef/supermarket repository will continue to be where development of the Supermarket application takes place. Come be part of shaping the direction of Supermarket by opening issues and pull requests or by joining us on the Chef Mailing List.

Select Badges

Select Supported Platforms

Select Status


al_agents (22) Versions 1.0.3

Installs/Configures the Alert Logic Agent

cookbook 'al_agents', '= 1.0.3', :supermarket
cookbook 'al_agents', '= 1.0.3'
knife supermarket install al_agents
knife supermarket download al_agents
Quality 100%

Alert Logic Agent Cookbook

This cookbook is used to install and configure the Alert Logic agent.


The following platforms are tested directly under test kitchen.

  • ubuntu-12.04
  • ubuntu-14.04
  • centos-6.4
  • centos-7.0
  • debian-7.8
  • fedora-19
  • windows-2012r2

Cookbook Dependencies

  • rsyslog
  • line
  • selinux_policy


  • ['al_agents']['agent']['registration_key'] - your required registration key. String defaults to your_registration_key_here
  • ['al_agents']['agent']['for_autoscaling'] - The for_autoscaling attribute determines if your installation will be configured as a host or role server. By default for_autoscaling is set to false or in other words as a host install. If autoscaling is set to true then the install is configured as a role server. Boolean defaults to false
  • ['al_agents']['agent']['for_imaging'] - The for_imaging attribute determines if the install process will continue or stop prior to provisioning. If the for_imaging attribute is set to true then the install process perform an install only and stop before provisioning. This allows for instance snapshots to be saved and started for later use. With this attribute set to false then the provisioning process is performed during setup. Boolean defaults to false
  • ['al_agents']['agent']['egress_url'] - By default all traffic is sent to This attribute is useful if you have a machine that is responsible for outbound traffic (NAT box). If you specify your own URL ensure that it is a properly formatted URI. String defaults to



The default recipe will attempt to perform an install best suited for your environment. It will install the package for your system. The default attributes will install the agent in host mode (not for image capture).

On linux, the default recipe includes an attempt to detect your logging system and adds a configuration directive for that logging system. For more information see the al_agents::rsyslog and al_agents::syslog_ng recipes. This recipe also includes an attempt to detect if selinux is installed on the machine.

On both windows and linux the proper package is installed and the agent is started when the cookbook's defaults are used.


On linux, if you are using rsyslog and desire to skip an attempt at detection, you may run the al_agent::rsyslog recipe independently. Logging changes are added under the installation's subdirectory in a file named alertlogic.conf


On linux, if you are using syslog-ng and desire to skip an attempt at detection, you may run the al_agents::syslog_ng recipe independently. Logging changes are added under the installation's subdirectory in a file named alertlogic.conf


On linux, if you are using selinux and desire to skip an attempt at detection, you may run the al_agents::selinux recipe independently. This recipe will add a selinux policy to allow for logging to port 1514. This recipe does not enable nor disable selinux policy enforcement.


On linux, should you desire to install the package, configure and provision the machine you may run this recipe independently.


On linux, this recipe as stated starts the service.


install example
  "run_list": [
à la carte recipe example (linux only)
  "run_list": [
    "recipe[al_agents::rsyslog, al_agents::install]"


The attributes for_autoscaling and for_imaging determine your installation type. They are boolean values and by default both of those values are false. As boolean values, you can create a matrix of four possible configuration outcomes. It is worth mentioning those configurations.

  1. host (default) when for_autoscaling = false and for_imaging = false
  2. host for imaging when for_autoscaling = false and for_imaging = true
  3. role when for_autoscaling = true and for_imaging = false
  4. role for imaging when for_autoscaling = true and for_imaging = true

Performing an agent install using the cookbook's default attributes, will setup the agent as a host type and provision the instance immediately. see configuration #1 above. If you have properly set your registration key, your host should appear within Alert Logic's Console within 15 minutes.


In the root of the project:
* to execute rubocop: rubocop .
* to execute foodcritic: foodcritic .
* to execute chefspec: rspec spec
* to execute test kitchen: kitchen test


If the cookbook fails at the provisioning step, one cause is that the agent cannot connect to the egress_url. Ensure that the proper permissions are configured on the security groups and ACLs to allow for outbound access. Also check your egress_url attribute and ensure that it is a properly formatted URI.


  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 using Github

License and Authors

Authors: John Ramos (

Dependent cookbooks

selinux_policy >= 0.0.0
rsyslog >= 0.0.0
line >= 0.0.0

Contingent cookbooks

There are no cookbooks that are contingent upon this one.

al_agents CHANGELOG

This file is used to list changes made in each version of the al_agents cookbook.


  • John Ramos - changed the name of the cookbook from al_agent to al_agents


  • John Ramos - Fixed source and image urls


  • John Ramos - Initial release of al_agents

Check the Markdown Syntax Guide for help with Markdown.

The Github Flavored Markdown page describes the differences between markdown on github and standard markdown.

Foodcritic Metric

1.0.3 passed this metric