Skip to content

Infrastructure Integration ¶

Configuration¶

Configure the agent by editing /etc/nutanix/epoch-dd-agent/conf.d/couch.yamlin the collectors.

Example:

    init_config:
    instances:
      # The `db_whitelist` should contain the names of the databases meant to be checked.
      # If no whitelist is specified, all databases will be checked.
      #
      # The `db_blacklist` should contain the names of any databases meant to be excluded
      # from being checked. If a database is listed in both the blacklist and whitelist,
      # the blacklist will take precedence.
      #
      # You should also notice that no more than 50 databases will be checked, if you have
      # whitelisted more than 50 or if you have more than 50 databases and no whitelist,
      # only the first 50 databases will be checked.
      #
      - server: http://localhost:5984
        # user: username                # optional
        # password: password            # optional
        # timeout: 5                    # in seconds
        # db_whitelist:
        #  - db1
        #  - db2
        #  - db3
        # db_blacklist:
        #  - db1
        #  - db2
        #  - db3

Check and make sure that all yaml files are valid with following command:
```
/etc/init.d/epoch-collectors configcheck
```
Restart the Agent using the following command:
```
/etc/init.d/epoch-collectors restart
```
Execute the info command to verify that the integration check has passed:
```
/etc/init.d/epoch-collectors info
```

The output of the info command should contain a section similar to the following:

    Checks
    ======
      [...]
      couch
      ----------
          - instance #0 [OK]
          - Collected 8 metrics & 0 events

Infrastructure Datasources¶

Datasource	Available Aggregations	Unit	Description
couchdb.by_db.disk_size	`avg` `max` `min` `sum`	byte	Disk size per database
couchdb.by_db.doc_count	`avg` `max` `min` `sum`	document	Document count per database
couchdb.httpd.requests	`avg` `max` `min` `sum`	request	Number of HTTP requests
couchdb.httpd.view_reads	`avg` `max` `min` `sum`	read	Number of view reads
couchdb.couchdb.auth_cache_hits	`avg` `max` `min` `sum`	hit	Number of authentication cache hits
couchdb.couchdb.auth_cache_misses	`avg` `max` `min` `sum`	miss	Number of authentication cache misses
couchdb.couchdb.database_reads	`avg` `max` `min` `sum`	read	Number of times a document was read from a database
couchdb.couchdb.database_writes	`avg` `max` `min` `sum`	write	Number of times a document was changed
couchdb.couchdb.open_databases	`avg` `max` `min` `sum`	item	Number of open databases
couchdb.couchdb.open_os_files	`avg` `max` `min` `sum`	file	Number of file descriptors CouchDB has open
couchdb.couchdb.request_time	`avg` `max` `min` `sum`	second	Length of a request inside CouchDB without MochiWeb
couchdb.httpd.bulk_requests	`avg` `max` `min` `sum`	request	Number of bulk requests
couchdb.httpd.clients_requesting_changes	`avg` `max` `min` `sum`	connection	Number of clients requesting a change
couchdb.httpd_request_methods.DELETE	`avg` `max` `min` `sum`	request	Number of HTTP DELETE requests
couchdb.httpd_request_methods.GET	`avg` `max` `min` `sum`	request	Number of HTTP GET requests
couchdb.httpd_request_methods.HEAD	`avg` `max` `min` `sum`	request	Number of HTTP HEAD requests
couchdb.httpd_request_methods.POST	`avg` `max` `min` `sum`	request	Number of HTTP POST requests
couchdb.httpd_request_methods.PUT	`avg` `max` `min` `sum`	request	Number of HTTP PUT requests
couchdb.httpd_status_codes.200	`avg` `max` `min` `sum`	request	Number of HTTP 200 OK responses
couchdb.httpd_status_codes.201	`avg` `max` `min` `sum`	request	Number of HTTP 201 Created responses
couchdb.httpd_status_codes.202	`avg` `max` `min` `sum`	request	Number of HTTP 202 Accepted responses
couchdb.httpd_status_codes.301	`avg` `max` `min` `sum`	request	Number of HTTP 301 Moved Permanently responses
couchdb.httpd_status_codes.304	`avg` `max` `min` `sum`	request	Number of HTTP 304 Not Modified responses
couchdb.httpd_status_codes.400	`avg` `max` `min` `sum`	request	Number of HTTP 400 Bad Request responses
couchdb.httpd_status_codes.401	`avg` `max` `min` `sum`	request	Number of HTTP 401 Unauthorized responses
couchdb.httpd_status_codes.403	`avg` `max` `min` `sum`	request	Number of HTTP 403 Forbidden responses
couchdb.httpd_status_codes.404	`avg` `max` `min` `sum`	request	Number of HTTP 404 Not Found responses
couchdb.httpd_status_codes.405	`avg` `max` `min` `sum`	request	Number of HTTP 405 Method Not Allowed responses
couchdb.httpd_status_codes.409	`avg` `max` `min` `sum`	request	Number of HTTP 409 Conflict responses
couchdb.httpd_status_codes.412	`avg` `max` `min` `sum`	request	Number of HTTP 412 Precondition Failed responses
couchdb.httpd_status_codes.500	`avg` `max` `min` `sum`	request	Number of HTTP 500 Internal Server Error responses