noble (3) Net::Prometheus::ProcessCollector::linux.3pm.gz

NAME

       "Net::Prometheus::ProcessCollector::linux" - Process Collector for linux OS

SYNOPSIS

          use Net::Prometheus;
          use Net::Prometheus::ProcessCollector::linux;

          my $prometheus = Net::Prometheus->new;

          $prometheus->register( Net::Prometheus::ProcessCollector::linux->new );

DESCRIPTION

       This class provides a Net::Prometheus collector instance to provide process-wide metrics for a process
       running on the linux operating system.

       At collection time, if the requested process does not exist, no metrics are returned.

   Other Process Collection
       The "pid" argument allows the collector to collect from processes other than the one actually running the
       code.

       Note also that scraping processes owned by other users may not be possible for non-root users. In
       particular, most systems do not let non-root users see the "proc/self/fd" directory of processes they
       don't own. In this case, the "process_open_fds" metric will not be returned.

CONSTRUCTOR

   new
          $collector = Net::Prometheus::ProcessCollector::linux->new( %args )

       As well as the default arguments supported by Net::Prometheus::ProcessCollector, the following extra
       named arguments are recognised:

       pid => STR
           The numerical PID to collect information about; defaults to the string "self" allowing the exporter
           to collect information about itself, even over fork calls.

           If the collector is collecting from "self" or from a numerical PID that matches its own PID, then it
           will subtract 1 from the count of open file handles, to account for the readdir() handle being used
           to collect that count. If it is collecting a different process, it will not.

AUTHOR

       Paul Evans <leonerd@leonerd.org.uk>