************************ passenger_exporter_nginx ------------------------ This is a Prometheus exporter for passenger with nginx integration. https://www.phusionpassenger.com/ ********************* Building the Exporter --------------------- The default Makefile target creates a statically linked binary for Linux. A Dockerfile and Makefile target are also supplied: make build-docker ******************** Running the Exporter -------------------- Usage of passenger_exporter_nginx: -log.format value If set use a syslog logger or JSON logging. Example: logger:syslog?appname=bob&local=7 or logger:stdout?json=true. Defaults to stderr. -log.level value Only log messages with the given severity or above. Valid levels: [debug, info, warn, error, fatal]. (default info) -passenger.command string Passenger command for querying passenger status. (default "passenger-status --show=xml") -passenger.pid-file string Optional path to a file containing the passenger/nginx PID for additional metrics. -passenger.command.timeout duration Timeout for passenger.command. (default 500ms) -web.listen-address string Address to listen on for web interface and telemetry. (default ":9149") -web.telemetry-path string Path under which to expose metrics. (default "/metrics") To run the Docker image: docker run -p 9106:9106 -v $PATH_TO_PASSENGER_STATUS:/bin \ passenger_exporter_nginx:latest /passenger_exporter_nginx Notes for running the Docker container: - You must mount the passenger-status binary within the container to have access. - You must expose the -web.listen-address port on the container to be scraped. ********** Collectors ---------- An example of the metrics exported can be seen in testdata/scrape_output.txt ************* Running Tests ------------- Tests can be run with: go test . Additionally, the testdata/scrape_output.txt can be regenerated by passing the --golden flag: go test -v . --golden