CouchDB - Monitoring Extension

By:
Barbara.Snyder
AppDynamics supported
Updated July 12, 2016, 12:40 a.m.

CouchDB Monitoring Extension

This extension works only with the standalone machine agent.

Use Case

Apache CouchDB, commonly referred to as CouchDB, is an open source database that focuses on ease of use and on being "a database that completely embraces the web." It is a NoSQL database that uses JSON to store data, uses JavaScript as its query language using MapReduce, and uses HTTP for an API. The CouchDB monitoring extension gathers metrics for the specified hosts that have couchDB installed.

Installation

Download and unzip the CouchDBMonitor zip file into the <machineagent install dir>/monitors directory.

(OPTIONAL) Open <machineagent install dir>/monitors/CouchDBMonitor/monitor.xml and configure the couchDB parameters.

    <argument name="hosts-config-path" is-required="true" default-value="monitors/CouchDBMonitor/conf/HostsConfig.xml" />

Open <machineagent install dir>/monitors/CouchDBMonitor/conf/HostsConfig.xml and configure the CouchDB hosts.
The host id, port, username, and password need to be configured for each host. Here is a sample configuration for one host:
```
    <Host id="localhost" port="5984" username="username" password="password"/>          
```
Restart the machine agent.
In the AppDynamics Metric Browser, look for: Application Infrastructure Performance | <Tier> | Custom Metrics | CouchDB

Metrics

Metric Category: couchdb

Metric Name	Description
database_writes	Number of times a database was changed
database_reads	Number of times a document was read from a database
open_databases	Number of open databases
open_os_files	Number of file descriptors CouchDB has open
request_time	Length of a request (ms) inside CouchDB

Metric Category: httpd

Metric Name	Description
bulk_requests	Number of bulk requests
requests	Number of HTTP requests
temporary_view_reads	Number of temporary view reads
view_reads	Number of view reads

Metric Category: httpd_request_methods

Metric Name	Description
COPY	Number of HTTP COPY requests
DELETE	Number of HTTP DELETE requests
GET	Number of HTTP GET requests
HEAD	Number of HTTP HEAD requests
MOVE	Number of HTTP MOVE requests
POST	Number of HTTP POST requests
PUT	Number of HTTP PUT requests

Metric Category: httpd_status_codes

Metric Name	Description
201	Number of HTTP 200 OK responses
201	Number of HTTP 201 Created responses
202	Number of HTTP 202 Accepted responses
301	Number of HTTP 301 Moved Permanently responses
304	Number of HTTP 304 Not Modified responses
400	Number of HTTP 400 Bad Request responses
401	Number of HTTP 401 Unauthorized responses
403	Number of HTTP 403 Forbidden responses
404	Number of HTTP 404 Not Found responses
405	Number of HTTP 405 Method Not Allowed responses
409	Number of HTTP 409 Conflict responses
412	Number of HTTP 412 Precondition Failed responses
500	Number of HTTP 500 Internal Server Error responses

Custom Dashboard

Contributing

Always feel free to fork and contribute any changes directly via GitHub.

Support

For any support questions, please contact help@appdynamics.com.

Version:	1.0
Compatibility:	3.7
Last Update:	08/06/2014
CouchDB Versions Tested on:	1.6.0

Release Notes:

1.0.1 Fixed code for Basic Authentication and Mavenized the extension

Attachments:

CouchDBMonitor-1.0.1.zip