Skip to main content

Community Plugins

[edit on GitHub]

This page lists plugins for Ohai plugins and Chef Infra Client handlers that are developed and maintained by the Chef community.

Ohai

Ohai is a tool that is used to collect system configuration data, which is provided to Chef Infra Client for use within cookbooks. Ohai is run by Chef Infra Client at the beginning of every Chef run to determine system state. Ohai includes many built-in plugins to detect common configuration details as well as a plugin model for writing custom plugins.

The types of attributes Ohai collects include but are not limited to:

  • Operating System
  • Network
  • Memory
  • Disk
  • CPU
  • Kernel
  • Host names
  • Fully qualified domain names
  • Virtualization
  • Cloud provider metadata

Attributes that are collected by Ohai are automatic level attributes, in that these attributes are used by Chef Infra Client to ensure that these attributes remain unchanged after Chef Infra Client is done configuring the node.

The following Ohai plugins are available from the open source community:

PluginDescription
dell.rbAdds some useful Dell server information to Ohai. For example: service tag, express service code, storage info, RAC info, and so on. To use this plugin, OMSA and SMBIOS applications need to be installed.
ipmi.rbAdds a MAC address and an IP address to Ohai, where available.
kvm_extensions.rbAdds extensions for virtualization attributes to provide additional host and guest information for KVM.
ladvd.rbAdds ladvd information to Ohai, when it exists.
lxc_virtualization.rbAdds extensions for virtualization attributes to provide host and guest information for Linux containers.
network_addr.rbAdds extensions for network attributes with additional ipaddrtype_iface attributes to make it semantically easier to retrieve addresses.
network_ports.rbAdds extensions for network attributes so that Ohai can detect to which interfaces TCP and UDP ports are bound.
parse_host_plugin.rbAdds the ability to parse a host name using three top-level attribute and five nested attributes.
r.rbAdds the ability to collect basic information about the R Project.
sysctl.rbAdds sysctl information to Ohai.
vserver.rbAdds extensions for virtualization attributes to allow a Linux virtual server host and guest information to be used by Ohai.
wtf.rbAdds the irreverent wtfismyip.com service so that Ohai can determine a machine's external IPv4 address and geographical location.
xenserver.rbAdds extensions for virtualization attributes to load up Citrix XenServer host and guest information.
win32_software.rbAdds the ability for Ohai to use Windows Management Instrumentation (WMI) to discover useful information about software that is installed on any node that is running Microsoft Windows.
win32_svc.rbAdds the ability for Ohai to query using Windows Management Instrumentation (WMI) to get information about all services that are registered on a node that is running Microsoft Windows.

Handlers

Use a handler to identify situations that arise during a Chef Infra Client run, and then tell Chef Infra Client how to handle these situations when they occur.

The following open source handlers are available from the Chef community:

HandlerDescription
AirbrakeA handler that sends exceptions (only) to Airbrake, an application that collects data and aggregates it for review.
Asynchronous ResourcesA handler that asynchronously pushes exception and report handler data to a STOMP queue, from which data can be processed into data storage.
CampfireA handler that collects exception and report handler data and reports it to Campfire, a web-based group chat tool.
DatadogA handler that collects Chef Infra Client stats and sends them into a Datadog newsfeed.
FlowdockA handler that collects exception and report handler data and sends it to users via the Flowdock API..
GraphiteA handler that collects exception and report handler data and reports it to Graphite, a graphic rendering application.
Graylog2 GELFA handler that provides exception and report handler status (including changes) to a Graylog2 server, so that the data can be viewed using Graylog Extended Log Format (GELF).
GrowlA handler that collects exception and report handler data and then sends it as a Growl notification.
HipChatA handler that collects exception handler data and sends it to HipChat, a hosted private chat service for companies and teams.
IRC SnitchA handler that notifies administrators (via Internet Relay Chat (IRC)) when a Chef Infra Client run fails.
JournaldA handler that logs an entry to the systemd journal with the Chef Infra Client run status, exception details, configurable priority, and custom details.
net/httpA handler that reports the status of a Chef run to any API via net/HTTP.
Simple EmailA handler that collects exception and report handler data and then uses pony to send email reports that are based on Erubis templates.
SendGrid Mail HandlerA chef handler that collects exception and report handler data and then uses SendGrid Ruby gem to send email reports that are based on Erubis templates.
SNSA handler that notifies exception and report handler data and sends it to a SNS topic.
SlackA handler to send Chef Infra Client run notifications to a Slack channel.
Splunk StormA handler that supports exceptions and reports for Splunk Storm.
SyslogA handler that logs basic essential information, such as about the success or failure of a Chef Infra Client run.
Updated ResourcesA handler that provides a simple way to display resources that were updated during a Chef Infra Client run.
ZooKeeperA Chef report handler to send Chef run notifications to ZooKeeper.