Sortdb

Supported OS Linux Mac OS Windows

Integration version1.0.0

Sortdb Integration

Overview

Get metrics from Sortdb service in real time to:

  • Visualize and monitor Sortdb stats.
  • Be notified about Sortdb failovers.
  • Check health of and get stats from multiple instances

Setup

The Sortdb check is not included in the Datadog Agent package, so you need to install it.

Installation

For Agent v7.21+ / v6.21+, follow the instructions below to install the Sortdb check on your host. See Use Community Integrations to install with the Docker Agent or earlier versions of the Agent.

  1. Run the following command to install the Agent integration:

    datadog-agent integration install -t datadog-sortdb==<INTEGRATION_VERSION>
    
  2. Configure your integration similar to core integrations.

Configuration

  1. Edit the sortdb.d/conf.yaml file in the conf.d/ folder at the root of your Agent’s configuration directory to start collecting your Sortdb metrics. See the sample sortdb.d/conf.yaml for all available configuration options.

  2. Restart the Agent.

Validation

Run the Agent’s status subcommand and look for sortdb under the Checks section.

Compatibility

The SortDB check is compatible with all major platforms.

Data Collected

Metrics

sortdb.stats.total_requests
(gauge)
Total number of requests
Shown as task
sortdb.stats.total_seeks
(gauge)
Total number of seeks
Shown as task
sortdb.stats.get_requests
(gauge)
Total number of get requests
Shown as task
sortdb.stats.get_hits
(gauge)
Total number of get hits
Shown as task
sortdb.stats.get_misses
(gauge)
Total number of get misses
Shown as task
sortdb.stats.get_requests.avg
(gauge)
Average get requests received
Shown as microsecond
sortdb.stats.get_requests.95percentile
(gauge)
95th percentile of get requests received
Shown as microsecond
sortdb.stats.get_requests.99percentile
(gauge)
99th percentile of get requests
Shown as microsecond
sortdb.stats.mget_requests
(gauge)
Total number of mget requests
Shown as task
sortdb.stats.mget_hits
(gauge)
Total number of mget hits
Shown as task
sortdb.stats.mget_misses
(gauge)
Total number of mget misses
Shown as task
sortdb.stats.mget_requests.avg
(gauge)
Average mget requests
Shown as microsecond
sortdb.stats.mget_requests.95percentile
(gauge)
95th percentile of mget requests
Shown as microsecond
sortdb.stats.mget_requests.99percentile
(gauge)
99th percentile of mget requests
Shown as microsecond
sortdb.stats.fwmatch_requests
(gauge)
Total number of fwmatch requests
Shown as task
sortdb.stats.fwmatch_hits
(gauge)
Total number of fwmatch hits
Shown as task
sortdb.stats.fwmatch_misses
(gauge)
Total number of fwmatch misses
Shown as task
sortdb.stats.fwmatch_requests.avg
(gauge)
Average fwmatch requests
Shown as task
sortdb.stats.fwmatch_requests.95percentile
(gauge)
95th percentile of fwmatch requests
Shown as task
sortdb.stats.fwmatch_requests.99percentile
(gauge)
99th percentile of fwmatch requests
Shown as task
sortdb.stats.range_requests
(gauge)
Total number of range requests
Shown as task
sortdb.stats.range_hits
(gauge)
Total number of range hits
Shown as task
sortdb.stats.range_misses
(gauge)
Total number of range misses
Shown as task
sortdb.stats.range_requests.avg
(gauge)
Average range requests
Shown as microsecond
sortdb.stats.range_requests.95percentile
(gauge)
95th percentile of range requests
Shown as microsecond
sortdb.stats.range_requests.99percentile
(gauge)
99th percentile of range requests
Shown as microsecond
sortdb.stats.db_size.bytes
(gauge)
db size in bytes
Shown as byte
sortdb.stats.db_mtime
(gauge)
db up time in ms
Shown as time

Service Checks

sortdb.http.can_connect

Returns CRITICAL if the check cannot connect to Sortdb, returns OK otherwise.

Statuses: ok, critical

Troubleshooting

The SortDB check does not include any events.

PREVIEWING: may/embedded-workflows