Difference between revisions of "Plugin:cURL-JSON"

Revision as of 16:19, 30 October 2015

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">
    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://localhost:5984/_all_dbs">
    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