---
title: ''
description: Telegraf plugin for collecting metrics from Passenger
url: https://docs.influxdata.com/telegraf/v1/input-plugins/passenger/
estimated_tokens: 1280
product: Telegraf Enterprise
version: v1
publisher: InfluxData
canonical: https://docs.influxdata.com/telegraf/v1/input-plugins/passenger/
date: '2026-05-21T20:10:18+02:00'
lastmod: '2026-05-21T20:10:18+02:00'
---

==========

* Telegraf v0.10.1+

[Plugin source](https://github.com/influxdata/telegraf/tree/v1.39.1/plugins/inputs/passenger/)[Download configuration](https://raw.githubusercontent.com/influxdata/telegraf/refs/tags/v1.39.1/plugins/inputs/passenger/sample.conf)

# Passenger Input Plugin

This plugin gathers metrics from the [Phusion Passenger](https://www.phusionpassenger.com/) service.

> [!Warning]
> Depending on your environment, this plugin can create a high number of series
> which can cause high load on your database. Please use[measurement filtering](/telegraf/v1/configuration/#metric-filtering) to manage your series cardinality!

The plugin uses the `passenger-status` command line tool.

> [!Note]
> This plugin requires the `passenger-status` binary to be installed on the
> system and to be executable by Telegraf.

**Introduced in:** Telegraf v0.10.1**Tags:** web**OS support:** all

## Global configuration options

Plugins support additional global and plugin configuration settings for tasks
such as modifying metrics, tags, and fields, creating aliases, and configuring
plugin ordering. See [CONFIGURATION.md](/telegraf/v1/configuration/#plugins) for more details.

## Configuration

```toml
# 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

Telegraf must have permission to execute the `passenger-status` command. On
most systems, Telegraf runs as the `telegraf` user.

### Series Cardinality

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 on your database. You can use the following techniques to
manage your series cardinality:

* Use the[measurement filtering](https://docs.influxdata.com/telegraf/latest/administration/configuration/#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.
* Write to a database with an appropriate[retention policy](https://docs.influxdata.com/influxdb/latest/guides/downsampling_and_retention/).
* Consider using the[Time Series Index](https://docs.influxdata.com/influxdb/latest/concepts/time-series-index/).
* Monitor your databases[series cardinality](https://docs.influxdata.com/influxdb/latest/query_language/spec/#show-cardinality).

## Metrics

* passenger

  * tags:
    * passenger\_version

  * fields:
    * process\_count
    * max
    * capacity\_used
    * get\_wait\_list\_size

* passenger\_supergroup

  * tags:
    * name

  * fields:
    * get\_wait\_list\_size
    * capacity\_used

* passenger\_group

  * tags:
    * name
    * app\_root
    * app\_type

  * fields:
    * get\_wait\_list\_size
    * capacity\_used
    * processes\_being\_spawned

* passenger\_process

  * tags:
    * group\_name
    * app\_root
    * supergroup\_name
    * pid
    * code\_revision
    * life\_status
    * process\_group\_id

  * fields:
    * concurrency
    * sessions
    * busyness
    * processed
    * spawner\_creation\_time
    * spawn\_start\_time
    * spawn\_end\_time
    * last\_used
    * uptime
    * cpu
    * rss
    * pss
    * private\_dirty
    * swap
    * real\_memory
    * vmsize

## Example Output

```text
passenger,passenger_version=5.0.17 capacity_used=23i,get_wait_list_size=0i,max=23i,process_count=23i 1452984112799414257
passenger_supergroup,name=/var/app/current/public capacity_used=23i,get_wait_list_size=0i 1452984112799496977
passenger_group,app_root=/var/app/current,app_type=rack,name=/var/app/current/public capacity_used=23i,get_wait_list_size=0i,processes_being_spawned=0i 1452984112799527021
passenger_process,app_root=/var/app/current,code_revision=899ac7f,group_name=/var/app/current/public,life_status=ALIVE,pid=11553,process_group_id=13608,supergroup_name=/var/app/current/public busyness=0i,concurrency=1i,cpu=58i,last_used=1452747071764940i,private_dirty=314900i,processed=951i,pss=319391i,real_memory=314900i,rss=418548i,sessions=0i,spawn_end_time=1452746845013365i,spawn_start_time=1452746844946982i,spawner_creation_time=1452746835922747i,swap=0i,uptime=226i,vmsize=1563580i 1452984112799571490
passenger_process,app_root=/var/app/current,code_revision=899ac7f,group_name=/var/app/current/public,life_status=ALIVE,pid=11563,process_group_id=13608,supergroup_name=/var/app/current/public busyness=2147483647i,concurrency=1i,cpu=47i,last_used=1452747071709179i,private_dirty=309240i,processed=756i,pss=314036i,real_memory=309240i,rss=418296i,sessions=1i,spawn_end_time=1452746845172460i,spawn_start_time=1452746845136882i,spawner_creation_time=1452746835922747i,swap=0i,uptime=226i,vmsize=1563608i 1452984112799638581
```