|
HTML rendering created 2024-06-26 by Michael Kerrisk, author of The Linux Programming Interface. For details of in-depth Linux/UNIX system programming training courses that I teach, look here. Hosting by jambit GmbH. |
|
|
NAME | DESCRIPTION | INSTALLATION | FILES | PCP ENVIRONMENT | SEE ALSO | COLOPHON |
|
|
|
PMDANGINX(1) General Commands Manual PMDANGINX(1)
pmdanginx - nginx performance metrics domain agent (PMDA)
pmdanginx is a Performance Metrics Domain Agent (PMDA) which
exports performance metrics from nginx(8) - an HTTP and reverse
proxy server, a mail proxy server, and a generic TCP proxy
server.
This PMDA requires that the nginx stub_status module is active
and available at http://localhost/nginx_status .
In order to enable this module, the "server" section of the
nginx.conf configuration file should contain the following.
location /nginx_status {
stub_status on;
access_log off;
allow 127.0.0.1;
allow ::1;
deny all;
}
Instrumentation availability can be verified using these commands
(compile-time then run-time checks):
# nginx -V 2>&1 | grep -o with-http_stub_status_module
# curl http://localhost/nginx_status
Install the nginx PMDA by using the Install script as root:
# cd $PCP_PMDAS_DIR/nginx
# ./Install
To uninstall, the following must be done as root:
# cd $PCP_PMDAS_DIR/nginx
# ./Remove
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.
$PCP_PMDAS_DIR/nginx/nginx.conf
optional configuration file for pmdanginx
$PCP_PMDAS_DIR/nginx/Install
installation script for the pmdanginx agent
$PCP_PMDAS_DIR/nginx/Remove
undo installation script for the pmdanginx agent
$PCP_LOG_DIR/pmcd/nginx.log
default log file for error messages from pmdanginx
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).
PCPIntro(1), pmcd(1) and nginx(8).
This page is part of the PCP (Performance Co-Pilot) project.
Information about the project can be found at
⟨http://www.pcp.io/⟩. If you have a bug report for this manual
page, send it to [email protected]. This page was obtained from the
project's upstream Git repository
⟨https://github.com/performancecopilot/pcp.git⟩ on 2024-06-14.
(At that time, the date of the most recent commit that was found
in the repository was 2024-06-14.) If you discover any rendering
problems in this HTML version of the page, or you believe there
is a better or more up-to-date source for the page, or you have
corrections or improvements to the information in this COLOPHON
(which is not part of the original manual page), send a mail to
[email protected]
Performance Co-Pilot PCP PMDANGINX(1)
|
HTML rendering created 2024-06-26 by Michael Kerrisk, author of The Linux Programming Interface. For details of in-depth Linux/UNIX system programming training courses that I teach, look here. Hosting by jambit GmbH. |
|