STAP-EXPORTER(8)            System Manager's Manual           STAP-EXPORTER(8)

<?><?><?> (NAME)
       stap-exporter - <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?> systemtap <?> prometheus

<?><?><?><?><?> <?><?><?><?><?> (SYNOPSIS)
       stap-exporter [ <?><?><?><?><?><?><?><?> ]

<?><?><?><?><?><?><?> (DESCRIPTION)
       <?><?><?><?><?> stap-exporter <?><?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?><?><?> systemtap <?><?> <?><?><?><?>
       <?><?><?><?> <?> <?><?><?><?><?><?><?><?><?> procfs <?><?><?><?><?>
       <?><?> <?><?> <?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?> <?><?><?> HTTP <?><?><?><?><?>
       <?><?><?><?><?><?>. <?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?> systemtap <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?> prometheus <?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?>. <?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?> <?><?>
       <?><?><?><?> tapset <?><?> <?><?><?> prometheus.stpm <?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?>.

<?><?><?><?><?><?><?><?> (OPTIONS)
       <?><?><?><?><?><?> stap-exporter <?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?>:

       -p --port PORT
              <?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?> (<?><?><?><?>)
              <?><?><?><?><?><?><?><?> TCP <?><?><?><?> <?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?><?> HTTP. <?><?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?><?><?><?>.

       -k --keepalive KEEPALIVE
              <?><?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?> <?><?>
              <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?>
              <?><?><?> <?><?> KEEPALIVE <?><?><?><?><?> <?><?><?><?>
              <?><?><?><?> <?><?><?><?><?> <?> <?><?><?><?><?>
              <?><?><?><?><?><?><?>. <?><?><?><?><?><?> <?><?><?><?><?><?><?>
              <?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> (timeout)
              <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?>
              <?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?>.

       -s --scripts SCRIPTS
              <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> SCRIPTS
              <?><?><?><?> <?><?><?><?><?><?><?><?> *.stp <?><?><?>
              <?><?><?><?> <?> <?><?><?><?><?>. <?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?><?>
              stappaths(7) <?><?><?><?> <?><?><?>.

       -h --help
              <?><?><?> <?><?><?><?> <?><?><?><?><?><?>.

<?><?><?><?> <?><?><?><?><?><?> (OPERATION)
       <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?> stap-exporter
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?> -s <?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?> *.stp <?><?><?><?><?>
       <?><?><?><?><?><?>. <?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?> (URL) <?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?> HTTP GET <?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>. <?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?><?>
       HTTP <?><?><?><?><?><?><?> /foo.stp <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?> <?> <?><?><?><?><?><?><?> foo.stp (<?><?><?><?>
       <?><?><?><?><?><?> / <?><?><?><?><?><?><?> <?><?>)
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> stap <?><?><?><?>
       <?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?>
       <?><?><?><?> <?><?><?><?><?><?>. <?><?><?> <?><?><?> <?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?> stap-exporter
       <?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?> procfs
       <?><?><?><?> <?><?> <?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?>
       <?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?><?> HTTP
       <?><?><?><?><?><?><?> <?><?><?>.

       <?><?> <?><?> <?><?><?><?> <?><?><?> <?><?> <?><?><?><?> <?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> (<?><?><?><?><?> -k
       <?><?> --keepalive)<?> <?><?><?><?><?><?><?> systemtap <?><?><?><?><?>
       <?><?><?><?><?><?>. <?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>.

       <?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> autostart
       <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?>
       <?><?><?><?><?><?><?> (<?> <?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?>) <?> <?><?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?>. <?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?> keepalive
       <?><?><?><?><?><?> <?><?><?><?><?>.
       <?><?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?>.

<?><?><?><?><?><?><?> (EXAMPLES)
       <?><?><?> <?><?><?><?> <?><?><?><?><?><?> example.stp <?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?> <?><?><?><?>. <?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?> read <?><?> <?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?> (thread) <?> <?><?> <?><?><?><?><?><?><?><?> (cpu)
       <?><?><?><?><?> <?><?><?><?><?><?>.
              global arr%

              probe syscall.read {
                  arr[tid(), cpu()]++
              }

              probe prometheus {
                  @prometheus_dump_array2(arr, "count", "tid", "cpu")
              }

       <?><?><?><?><?><?><?><?> prometheus_dump_array <?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?>
       <?><?> <?><?><?> <?><?><?><?><?><?><?>.  <?><?><?><?><?> Systemtap
       <?><?><?><?><?><?><?><?> prometheus_dump_arrayN <?><?> <?><?>
       <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> N <?><?> <?> <?><?> <?>
       <?><?><?><?><?> <?><?><?><?><?><?>. <?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?> N-<?><?><?><?><?>
       <?><?><?>. <?><?><?><?><?><?><?> <?><?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?>.
       <?><?><?><?><?><?><?><?><?><?> N <?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?>.

       <?><?><?><?><?> <?><?><?><?><?><?><?><?> stap-exporter <?><?> <?><?>
       <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> (root) <?><?> <?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?> stapdev <?><?><?><?>
       <?><?><?><?> <?><?><?> <?><?> <?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?><?> <?><?><?>
       <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?>:
              # stap-exporter -p 9999 -k 60 -c . &

              $ curl http://localhost:9999/example.stp
              Refresh page to access metrics.  [...]

              $ curl http://localhost:9999/example.stp
              count{tid="12614",cpu="0"} 9
              count{tid="12170",cpu="3"} 107
              count{tid="1802",cpu="0"} 33687
              count{tid="12617",cpu="1"} 99
              [...]

       <?><?><?><?> <?><?><?><?><?> URL <?><?> <?><?><?><?><?><?><?> <?><?>
       <?><?><?> scrape_config <?><?> <?><?><?><?> Prometheus <?><?>
       <?><?><?><?><?><?><?><?><?> config.d <?><?><?><?><?> <?><?>
       pmdaprometheus <?><?> Performance Co-Pilot <?><?><?><?><?> <?><?>
       <?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?>.

<?><?><?><?><?> <?> <?><?><?><?><?> (SAFETY AND SECURITY)
       <?><?><?><?> stap-exporter <?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?>. <?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?>
       <?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?>:

       <?><?><?><?><?><?> <?><?><?><?><?><?><?> (script selection)
              <?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?><?><?>
              systemtap <?><?><?> <?><?><?><?><?><?><?><?> <?>
              <?><?><?><?><?><?><?> <?><?><?><?><?><?> stap-exporter
              (<?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?>
              root) <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?> <?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?>
              <?><?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?>
              <?><?><?>. <?><?><?> <?><?> <?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?>.
              <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
              <?><?> <?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?>.

       <?><?><?><?><?><?> <?><?><?> TCP/IP (<?><?><?><?><?><?><?>)
              <?><?> <?><?><?><?> <?><?> stap-exporter <?><?><?><?>
              <?><?><?><?><?><?><?> TCP/HTTP <?><?> <?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?>
              <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>
              <?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?>
              (firewall) <?><?><?><?><?> <?><?><?><?>. <?><?><?><?> <?><?><?>
              <?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?>
              <?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>
              <?><?><?><?>.

       <?><?><?><?><?><?> HTTP (<?><?><?><?><?> <?><?><?><?>)
              <?><?> <?><?><?><?> <?><?> stap-exporter
              <?><?><?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?><?><?> systemtap <?><?>
              <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?> HTTP <?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?> <?><?>
              <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?> <?><?><?> <?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?>
              <?><?><?><?><?> <?><?><?><?>. <?><?><?><?><?><?><?> <?><?>
              <?><?> <?><?><?><?><?><?> HTTP <?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?>
              <?><?><?><?><?> <?><?><?><?><?><?><?><?> (URL)<?>
              <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?>
              <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?>.

       <?><?><?><?><?><?> HTTPS
              <?><?> <?><?><?><?> <?><?> stap-exporter <?><?><?><?><?> <?><?>
              <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> HTTP
              <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?><?>
              <?><?><?><?><?> HTTP <?><?><?><?> <?><?><?><?><?><?><?><?>
              <?><?> <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> HTTPS
              <?><?><?><?> <?><?><?><?>.

<?><?><?><?><?><?> <?><?><?><?><?><?> (SEE ALSO)
       stap(1)<?> stapprobes(3stap)<?> stappaths(7)<?> tapset::prometheus(7)

<?><?><?><?><?><?><?> (BUGS)
       <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?><?><?> <?><?><?><?>.  http://sourceware.org/systemtap<?>
       <systemtap@sourceware.org>.

       error::reporting(7stap)<?>
       https://sourceware.org/systemtap/wiki/HowToReportBugs

                                                              STAP-EXPORTER(8)