1PMDANVIDIA(1)               General Commands Manual              PMDANVIDIA(1)
2
3
4

NAME

6       pmdanvidia - nvidia gpu metrics domain agent (PMDA)
7

SYNOPSIS

9       $PCP_PMDAS_DIR/nvidia/pmdanvidia [-d domain] [-l logfile]
10

DESCRIPTION

12       pmdanvidia  is a Performance Metrics Domain Agent (PMDA) which extracts
13       performance metrics describing the  metrics  available  on  NVIDIA  GPU
14       cards via the NVML library.
15
16       The  nvidia PMDA exports metrics that measure gpu activity, memory uti‐
17       lization, fan speed, etc on NVIDIA Tesla and Quadro cards.  Metrics are
18       unlikely to be available for consumer class cards.
19
20       A brief description of the pmdanvidia command line options follows:
21
22       -d   It  is absolutely crucial that the performance metrics domain num‐
23            ber specified here is unique  and  consistent.   That  is,  domain
24            should  be  different for every PMDA on the one host, and the same
25            domain number should be used for the same PMDA on all hosts.
26
27       -l   Location of the log file.  By default, a log file named nvidia.log
28            is  written in the current directory of pmcd(1) when pmdanvidia is
29            started, i.e.  $PCP_LOG_DIR/pmcd.  If the log file cannot be  cre‐
30            ated  or  is not writable, output is written to the standard error
31            instead.
32

INSTALLATION

34       The nvidia PMDA is not installed and available by default.  If you want
35       to undo the installation, do the following as root:
36
37            # cd $PCP_PMDAS_DIR/nvidia
38            # ./Remove
39
40       If  you want to establish access to the names, help text and values for
41       the nvidia performance metrics once more, after removal, do the follow‐
42       ing as root:
43
44            # cd $PCP_PMDAS_DIR/nvidia
45            # ./Install
46
47       pmdanvidia  is  launched  by  pmcd(1)  and  should  never  be  executed
48       directly.  The Install and Remove scripts notify pmcd(1) when the agent
49       is installed or removed.
50

FILES

52       $PCP_PMCDCONF_PATH
53                 command line options used to launch pmdanvidia
54       $PCP_PMDAS_DIR/nvidia/help
55                 default help text file for the nvidia metrics
56       $PCP_PMDAS_DIR/nvidia/Install
57                 installation script for the pmdanvidia agent
58       $PCP_PMDAS_DIR/nvidia/Remove
59                 undo installation script for the pmdanvidia agent
60       $PCP_LOG_DIR/pmcd/nvidia.log
61                 default  log  file  for  error messages and other information
62                 from pmdanvidia
63

PCP ENVIRONMENT

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

SEE ALSO

72       PCPIntro(1), pmcd(1), pcp.conf(5) and pcp.env(5).
73
74
75
76Performance Co-Pilot                  PCP                        PMDANVIDIA(1)
Impressum