Infrastructure Integration

Configuration

  1. Configure the agent by editing /etc/netsil-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
  1. Check and make sure that all yaml files are valid with following command:

    /etc/init.d/netsil-collectors configcheck
    
  2. Restart the Agent using the following command:

    /etc/init.d/netsil-collectors restart
    
  3. Execute the info command to verify that the integration check has passed:

    /etc/init.d/netsil-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