61be19b1f0
Many of the examples provided within documentation are using a single dash for the command line arguments, but the telegraf executable explicitly has two dashes. There are also some inconsistencies with the ordering of the command line argument examples. I've ordered them so that the examples will show: config, config-directory, input-filter, test
139 lines
3.8 KiB
Markdown
139 lines
3.8 KiB
Markdown
# Telegraf plugin: passenger
|
|
|
|
Get phusion passenger stat using their command line utility
|
|
`passenger-status`
|
|
|
|
# Measurements
|
|
|
|
Meta:
|
|
|
|
- tags:
|
|
|
|
* name
|
|
* passenger_version
|
|
* pid
|
|
* code_revision
|
|
|
|
Measurement names:
|
|
|
|
- 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
|
|
|
|
* Field:
|
|
|
|
- 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
|
|
|
|
Using this configuration:
|
|
|
|
```
|
|
[[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"
|
|
```
|
|
|
|
When run with:
|
|
|
|
```
|
|
./telegraf --config telegraf.conf --input-filter passenger --test
|
|
```
|
|
|
|
It produces:
|
|
|
|
```
|
|
> 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
|
|
```
|
|
|
|
# Note
|
|
|
|
You have to ensure that you can run the `passenger-status` command under
|
|
telegraf user. Depend on how you install and configure passenger, this
|
|
maybe an issue for you. If you are using passenger standlone, or compile
|
|
yourself, it is straight forward. However, if you are using gem and
|
|
`rvm`, it maybe harder to get this right.
|
|
|
|
Such as with `rvm`, you can use this command:
|
|
|
|
```
|
|
~/.rvm/bin/rvm default do passenger-status -v --show=xml
|
|
```
|
|
|
|
You can use `&` and `;` in the shell command to run comlicated shell command
|
|
in order to get the passenger-status such as load the rvm shell, source the
|
|
path
|
|
```
|
|
command = "source .rvm/scripts/rvm && passenger-status -v --show=xml"
|
|
```
|
|
|
|
Anyway, just ensure that you can run the command under `telegraf` user, and it
|
|
has to produce XML output.
|