Phusion Passenger

Overview

Gather Phusion Passenger metrics using the passenger-status command line utility.

Series Cardinality Warning

Depending on your environment, this passenger_process measurement of this plugin can quickly create a high number of series which, when unchecked, can cause high load. You can use the following techniques to manage your series cardinality:

  • Use the measurement filtering options to exclude unneeded tags. In some environments, you may wish to use tagexclude to remove the pid and process_group_id tags.
  • Add __rollup:false tag to limit cardinality and manage retention.

Configuration

# Read metrics of passenger using passenger-status
[[inputs.passenger]]
  ## Path of passenger-status.
  ##
  ## Plugin gather metric via parsing XML output of passenger-status
  ## More information about the tool:
  ##   https://www.phusionpassenger.com/library/admin/apache/overall_status_report.html
  ##
  ## If no path is specified, then the plugin simply execute passenger-status
  ## hopefully it can be found in your PATH
  command = "passenger-status -v --show=xml"

Permissions:

Agent must have permission to execute the passenger-status command. On most systems, agent runs as the cua user.