Merge pull request DataDog#180 from gservat/add_phpfpm_integration

Added PHP FPM integration

Author: truthbk

manifests/integrations/php_fpm.pp

@@ -0,0 +1,39 @@
+# Class: datadog_agent::integrations::php_fpm
+#
+# This class will set-up PHP FPM monitoring
+#
+# Parameters:
+#   $status_url
+#        URL to fetch FPM metrics. Default: http://localhost/status
+#
+#   $ping_url
+#        URL to get a reliable check of the FPM pool. Default: http://localhost/ping
+#
+#   $tags
+#        Optional array of tags
+#
+# Sample Usage:
+#
+#  class { 'datadog_agent::integrations::php_fpm' :
+#    status_url     => 'http://localhost/fpm_status',
+#    ping_url       => 'http://localhost/fpm_ping'
+#  }
+#
+
+class datadog_agent::integrations::php_fpm(
+  $status_url       = 'http://localhost/status',
+  $ping_url         = 'http://localhost/ping',
+  $tags             = []
+) inherits datadog_agent::params {
+  include datadog_agent
+
+  file { "${datadog_agent::params::conf_dir}/php_fpm.yaml":
+    ensure  => file,
+    owner   => $datadog_agent::params::dd_user,
+    group   => $datadog_agent::params::dd_group,
+    mode    => '0600',
+    content => template('datadog_agent/agent-conf.d/php_fpm.yaml.erb'),
+    require => Package[$datadog_agent::params::package_name],
+    notify  => Service[$datadog_agent::params::service_name]
+  }
+}

spec/classes/datadog_agent_integrations_php_fpm_spec.rb

@@ -0,0 +1,36 @@
+require 'spec_helper'
+
+describe 'datadog_agent::integrations::php_fpm' do
+  let(:facts) {{
+    operatingsystem: 'Ubuntu',
+  }}
+  let(:conf_dir) { '/etc/dd-agent/conf.d' }
+  let(:dd_user) { 'dd-agent' }
+  let(:dd_group) { 'root' }
+  let(:dd_package) { 'datadog-agent' }
+  let(:dd_service) { 'datadog-agent' }
+  let(:conf_file) { "#{conf_dir}/php_fpm.yaml" }
+
+  it { should compile.with_all_deps }
+  it { should contain_file(conf_file).with(
+    owner: dd_user,
+    group: dd_group,
+    mode: '0600',
+  )}
+  it { should contain_file(conf_file).that_requires("Package[#{dd_package}]") }
+  it { should contain_file(conf_file).that_notifies("Service[#{dd_service}]") }
+
+  context 'with default parameters' do
+    it { should contain_file(conf_file).with_content(/status_url: http:\/\/localhost\/status/) }
+    it { should contain_file(conf_file).with_content(/ping_url: http:\/\/localhost\/ping/) }
+  end
+
+  context 'with parameters set' do
+    let(:params) {{
+      status_url: 'http://localhost/fpm_status',
+      ping_url: 'http://localhost/fpm_ping',
+    }}
+    it { should contain_file(conf_file).with_content(/status_url: http:\/\/localhost\/fpm_status/) }
+    it { should contain_file(conf_file).with_content(/ping_url: http:\/\/localhost\/fpm_ping/) }
+  end
+end

templates/agent-conf.d/php_fpm.yaml.erb

@@ -0,0 +1,29 @@
+#
+# MANAGED BY PUPPET
+#
+init_config:
+
+instances:
+  - # Get metrics from your FPM pool with this URL
+    status_url: <%= @status_url %>
+    # Get a reliable service check of your FPM pool with that one
+    ping_url: <%= @ping_url %>
+    # Set the expected reply to the ping.
+    ping_reply: pong
+    # These 2 URLs should follow the options from your FPM pool
+    # See http://php.net/manual/en/install.fpm.configuration.php
+    #   * pm.status_path
+    #   * ping.path
+    # You should configure your fastcgi passthru (nginx/apache) to
+    # catch these URLs and redirect them through the FPM pool target
+    # you want to monitor (FPM `listen` directive in the config, usually
+    # a UNIX socket or TCP socket.
+    #
+<% if @tags and !@tags.empty? -%>
+    # Array of custom tags
+    # By default metrics and service check will be tagged by pool and host
+    tags:
+    <% @tags.each do |tag| -%>
+      - <%= tag %>
+    <% end -%>
+<% end -%>