pmdauwsgi - Man Page

uwsgi performance metrics domain agent (PMDA)

Description

pmdauwsgi is a Performance Metrics Domain Agent (PMDA) which exports performance metrics from uwsgi. uWSGI is often used in conjunction with web servers such Nginx, which offer direct support for uWSGI's native uwsgi protocol, to serve Python web applications such as Django.

pmdauwsgi reads an optional ini-style configuration file:

$PCP_SYSCONF_DIR/uwsgi/uwsgi.conf

This file has a [pmda] section

[pmda]

host = (127.0.0.1)

Connect uwsgi stats server on the given hostname.

port = (9051)

Connect to the uwsgi stats server on the given port.

Installation

This PMDA requires that uwsgi is running on the local host with a uwsgi stats server running on TCP port 9051 (by default) and stats-http enabled.

Install the uwsgi PMDA by using the Install script as root:

      # cd $PCP_PMDAS_DIR/uwsgi
      # ./Install

To uninstall, do the following as root:

      # cd $PCP_PMDAS_DIR/uwsgi
      # ./Remove

pmdauwsgi 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.

Files

$PCP_PMDAS_DIR/uwsgi/Install

installation script for the pmdauwsgi agent

$PCP_PMDAS_DIR/uwsgi/Remove

undo installation script for the pmdauwsgi agent

$PCP_LOG_DIR/pmcd/uwsgi.log

default log file for error messages from pmdauwsgi

$PCP_SYSCONF_DIR/uwsgi/uwsgi.conf

optional configuration file for pmdauwsgi agent

PCP Environment

Environment variables with the prefix PCP_ are used to parameterize the file and directory names used by PCP. On each installation, the file /etc/pcp.conf contains the local values for these variables. The $PCP_CONF variable may be used to specify an alternative configuration file, as described in pcp.conf(5).

See Also

PCPIntro(1) and pmcd(1).

Info

PCP Performance Co-Pilot