Plugin:cURL-JSON

From collectd Wiki
Revision as of 01:50, 12 March 2020 by Efoley (talk | contribs)

(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search
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

Curl json cherokee io cache.png

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

Usage examples

Dependencies

See also