Plugin:cURL-JSON

cURL-JSON plugin
Type:	read
Callbacks:	config, read
Status:	supported
First version:	4.8
Copyright:	2009 Doug MacEachern 2006–2009 Florian octo Forster
License:	GPLv2
Manpage:	collectd.conf(5)
List of Plugins

The cURL-JSON plugin queries JavaScript Object Notation (JSON) data using the cURL library and parses it according to the user's configuration using Yet Another JSON Library (YAJL). This can be used to query statistics information from a CouchDB instance, for example. This plugin is a generic plugin, i.e. it cannot work without configuration, because there is no reasonable default behavior. Please read the Plugin curl_json section of the collectd.conf(5) manual page for an in-depth description of the plugin's configuration.

Synopsis

<Plugin curl_json>
# See: http://wiki.apache.org/couchdb/Runtime_Statistics
  <URL "http://localhost:5984/_stats">
    Host "my_host"
    Instance "httpd"
    <Key "httpd/requests/count">
      Type "http_requests"
    </Key>

    <Key "httpd_request_methods/*/count">
      Type "http_request_methods"
    </Key>

    <Key "httpd_status_codes/*/count">
      Type "http_response_codes"
    </Key>
  </URL>
# Database status metrics:
  <URL "http://example.com:5984/_all_dbs">
    Host "other_host"
    Instance "dbs"
    <Key "*/doc_count">
      Type "gauge"
    </Key>
    <Key "*/doc_del_count">
      Type "counter"
    </Key>
    <Key "*/disk_size">
      Type "bytes"
    </Key>
  </URL>
</Plugin>

Example graphs

• Example above from Baptiste Mille-Mathias <baptiste.millemathias@gmail.com> taken from the configuration example in Plugin:cURL-JSON/Cherokee

Usage examples

• Cherokee webserver
• Gathering php-fpm stats
• CouchDB statistics (this page)
• ArangoDB Nosql Database

Dependencies

• libcurl
• Yet Another JSON Library (yajl)

See also

• cURL plugin
• cURL-XML plugin