telegraf/plugins/inputs/passenger
Cameron Sparr 9c0d14bb60 Create public models for telegraf metrics, accumlator, plugins
This will basically make the root directory a place for storing the
major telegraf interfaces, which will make telegraf's godoc looks quite
a bit nicer. And make it easier for contributors to lookup the few data
types that they actually care about.

closes #564
2016-01-27 15:42:50 -07:00
..
README.md Add phusion Passenger plugin 2016-01-18 11:14:04 -07:00
passenger.go Create public models for telegraf metrics, accumlator, plugins 2016-01-27 15:42:50 -07:00
passenger_test.go Fix issue 524 2016-01-20 10:57:35 -08:00

README.md

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 -test -input-filter passenger

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.