Skip to content
Florian Forster edited this page Nov 21, 2023 · 1 revision
Name: cURL-JSON plugin
Type: read
Callbacks: config, read
Status: supported
FirstVersion: 4.8
Copyright: 2009 Doug MacEachern, 2006–2009 Florian octo Forster
License: GPLv2
Manpage: collectd.conf(5)
See also: 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
   <nowiki><URL "http://localhost:5984/_stats"></nowiki>
     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:
   <nowiki><URL "http://example.com:5984/_all_dbs"></nowiki>
     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

Usage examples

Dependencies

See also

Clone this wiki locally