diff options
Diffstat (limited to 'src/pmdas/nginx')
| -rw-r--r-- | src/pmdas/nginx/GNUmakefile | 55 | ||||
| -rwxr-xr-x | src/pmdas/nginx/Install | 33 | ||||
| -rwxr-xr-x | src/pmdas/nginx/Remove | 23 | ||||
| -rw-r--r-- | src/pmdas/nginx/nginx.conf | 2 | ||||
| -rwxr-xr-x | src/pmdas/nginx/pmdanginx.pl | 146 |
5 files changed, 259 insertions, 0 deletions
diff --git a/src/pmdas/nginx/GNUmakefile b/src/pmdas/nginx/GNUmakefile new file mode 100644 index 0000000..ddc5a5a --- /dev/null +++ b/src/pmdas/nginx/GNUmakefile @@ -0,0 +1,55 @@ +#!gmake +# +# Copyright (c) 2013 Ryan Doyle. +# +# This program is free software; you can redistribute it and/or modify it +# under the terms of the GNU General Public License as published by the +# Free Software Foundation; either version 2 of the License, or (at your +# option) any later version. +# +# This program is distributed in the hope that it will be useful, but +# WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY +# or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License +# for more details. +# +# You should have received a copy of the GNU General Public License along +# with this program; if not, write to the Free Software Foundation, Inc., +# 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA +# + +TOPDIR = ../../.. +include $(TOPDIR)/src/include/builddefs + +IAM = nginx +DOMAIN = NGINX +PMDADIR = $(PCP_PMDAS_DIR)/$(IAM) +LSRCFILES = Install Remove pmda$(IAM).pl $(IAM).conf + +ifneq ($(POD2MAN),) +MAN_SECTION = 1 +MAN_PAGES = pmda$(IAM).$(MAN_SECTION) +MAN_DEST = $(PCP_MAN_DIR)/man$(MAN_SECTION) +endif + +LDIRT = domain.h root pmns *.log $(MAN_PAGES) + +default: check_domain $(MAN_PAGES) + +pmda$(IAM).1: pmda$(IAM).pl + $(POD_MAKERULE) + +include $(BUILDRULES) + +install: default + $(INSTALL) -m 755 -d $(PMDADIR) + $(INSTALL) -m 755 Install Remove $(PMDADIR) + $(INSTALL) -m 644 pmda$(IAM).pl $(PMDADIR)/pmda$(IAM).pl + $(INSTALL) -m 644 $(IAM).conf $(PMDADIR)/$(IAM).conf + @$(INSTALL_MAN) + +default_pcp : default + +install_pcp : install + +check_domain: ../../pmns/stdpmid + $(DOMAIN_PERLRULE) diff --git a/src/pmdas/nginx/Install b/src/pmdas/nginx/Install new file mode 100755 index 0000000..8ad005c --- /dev/null +++ b/src/pmdas/nginx/Install @@ -0,0 +1,33 @@ +#!/bin/sh +# +# Copyright (c) 2013 Ryan Doyle. +# +# This program is free software; you can redistribute it and/or modify it +# under the terms of the GNU General Public License as published by the +# Free Software Foundation; either version 2 of the License, or (at your +# option) any later version. +# +# This program is distributed in the hope that it will be useful, but +# WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY +# or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License +# for more details. +# + +. $PCP_DIR/etc/pcp.env +. $PCP_SHARE_DIR/lib/pmdaproc.sh + +iam=nginx +perl_opt=true +daemon_opt=false +forced_restart=false + +perl -e "use LWP::UserAgent" 2>/dev/null +if test $? -ne 0 +then + echo "LWP::UserAgent perl module is not installed" + exit 1 +fi + +pmdaSetup +pmdaInstall +exit 0 diff --git a/src/pmdas/nginx/Remove b/src/pmdas/nginx/Remove new file mode 100755 index 0000000..a5705a3 --- /dev/null +++ b/src/pmdas/nginx/Remove @@ -0,0 +1,23 @@ +#! /bin/sh +# +# Copyright (c) 2013 Ryan Doyle. +# +# This program is free software; you can redistribute it and/or modify it +# under the terms of the GNU General Public License as published by the +# Free Software Foundation; either version 2 of the License, or (at your +# option) any later version. +# +# This program is distributed in the hope that it will be useful, but +# WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY +# or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License +# for more details. +# + +. $PCP_DIR/etc/pcp.env +. $PCP_SHARE_DIR/lib/pmdaproc.sh + +iam=nginx + +pmdaSetup +pmdaRemove +exit 0 diff --git a/src/pmdas/nginx/nginx.conf b/src/pmdas/nginx/nginx.conf new file mode 100644 index 0000000..3a4f664 --- /dev/null +++ b/src/pmdas/nginx/nginx.conf @@ -0,0 +1,2 @@ +#$nginx_status_url = "http://localhost/nginx_status"; +#$nginx_fetch_timeout = 1; diff --git a/src/pmdas/nginx/pmdanginx.pl b/src/pmdas/nginx/pmdanginx.pl new file mode 100755 index 0000000..3ec8b65 --- /dev/null +++ b/src/pmdas/nginx/pmdanginx.pl @@ -0,0 +1,146 @@ +# +# Copyright (c) 2013 Ryan Doyle. +# +# This program is free software; you can redistribute it and/or modify it +# under the terms of the GNU General Public License as published by the +# Free Software Foundation; either version 2 of the License, or (at your +# option) any later version. +# +# This program is distributed in the hope that it will be useful, but +# WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY +# or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License +# for more details. +# + +use strict; +use warnings; +use PCP::PMDA; +use LWP::UserAgent; + +my @nginx_status = (); +my $nginx_status_url = "http://localhost/nginx_status"; +my $nginx_fetch_timeout = 1; +my $http_client = LWP::UserAgent->new; + +# Configuration files for overriding the above settings +for my $file (pmda_config('PCP_PMDAS_DIR') . '/nginx/nginx.conf', 'nginx.conf') { + eval `cat $file` unless ! -f $file; +} + +$http_client->agent('pmdanginx'); +$http_client->timeout($nginx_fetch_timeout); + +sub update_nginx_status +{ + my $response = $http_client->get($nginx_status_url); + if ($response->is_success) { + # All the content on the status page are digits. Map the array + # index to the metric item ID. + @nginx_status = ($response->decoded_content =~ m/(\d+)/gm); + } else { + @nginx_status = undef; + } +} + +sub nginx_fetch_callback +{ + my ($cluster, $item, $inst) = @_; + if ($cluster == 0 && defined($nginx_status[$item])){ + return ($nginx_status[$item], 1); + } + return (PM_ERR_PMID, 0); +} + +my $pmda = PCP::PMDA->new('nginx', 117); + +$pmda->add_metric(pmda_pmid(0,0), PM_TYPE_U32, PM_INDOM_NULL, + PM_SEM_INSTANT, pmda_units(0,0,0,0,0,0), + 'nginx.active', + 'Number of active connections', ''); +$pmda->add_metric(pmda_pmid(0,1), PM_TYPE_U64, PM_INDOM_NULL, + PM_SEM_COUNTER, pmda_units(0,0,1,0,0,PM_COUNT_ONE), + 'nginx.accepts_count', + 'Total number of accepted connections', ''); +$pmda->add_metric(pmda_pmid(0,2), PM_TYPE_U64, PM_INDOM_NULL, + PM_SEM_COUNTER, pmda_units(0,0,1,0,0,PM_COUNT_ONE), + 'nginx.handled_count', + 'Total number of handled connections', ''); +$pmda->add_metric(pmda_pmid(0,3), PM_TYPE_U64, PM_INDOM_NULL, + PM_SEM_COUNTER, pmda_units(0,0,1,0,0,PM_COUNT_ONE), + 'nginx.requests_count', + 'Total number of requests', ''); +$pmda->add_metric(pmda_pmid(0,4), PM_TYPE_U32, PM_INDOM_NULL, + PM_SEM_INSTANT, pmda_units(0,0,0,0,0,0), + 'nginx.reading', + 'Reading the request header', ''); +$pmda->add_metric(pmda_pmid(0,5), PM_TYPE_U32, PM_INDOM_NULL, + PM_SEM_INSTANT, pmda_units(0,0,0,0,0,0), + 'nginx.writing', + 'Reading the request body, processing the request or writing response', ''); +$pmda->add_metric(pmda_pmid(0,6), PM_TYPE_U32, PM_INDOM_NULL, + PM_SEM_INSTANT, pmda_units(0,0,0,0,0,0), + 'nginx.waiting', + 'Keepalive connections', ''); + +$pmda->set_fetch_callback(\&nginx_fetch_callback); +$pmda->set_refresh(\&update_nginx_status); +$pmda->set_user('pcp'); +$pmda->run; + +=pod + +=head1 NAME + +pmdanginx - nginx performance metrics domain agent (PMDA) + +=head1 DESCRIPTION + +B<pmdanginx> is a Performance Metrics Domain Agent (PMDA) which exports +metric values from nginx. + + +=head1 INSTALLATION + +This PMDA requires that the nginx stub_status module is active and +available at http://localhost/nginx_status + + +Install the nginx PMDA by using the B<Install> script as root: + + # cd $PCP_PMDAS_DIR/nginx + # ./Install + +To uninstall, do the following as root: + + # cd $PCP_PMDAS_DIR/nginx + # ./Remove + +B<pmdanginx> is launched by pmcd(1) and should never be executed +directly. The Install and Remove scripts notify pmcd(1) when +the agent is installed or removed. + +=head1 FILES + +=over + +=item $PCP_PMDAS_DIR/nginx/nginx.conf + +optional configuration file for B<pmdanginx> + +=item $PCP_PMDAS_DIR/nginx/Install + +installation script for the B<pmdanginx> agent + +=item $PCP_PMDAS_DIR/nginx/Remove + +undo installation script for the B<pmdanginx> agent + +=item $PCP_LOG_DIR/pmcd/nginx.log + +default log file for error messages from B<pmdanginx> + +=back + +=head1 SEE ALSO + +pmcd(1). |