Overview
The Agent’s KyotoTycoon check tracks get, set, and delete operations, and lets you monitor replication lag.
Setup
Installation
The KyotoTycoon check is included in the Datadog Agent package, so you don’t need to install anything else on your KyotoTycoon servers.
Configuration
Edit the kyototycoon.d/conf.yaml file, in the conf.d/ folder at the root of your Agent’s configuration directory. See the sample kyototycoon.d/conf.yaml for all available configuration options:
init_config:
instances:
## @param report_url - string - required
## The report URL should be a URL to the Kyoto Tycoon "report" RPC endpoint.
#
- report_url: http://localhost:1978/rpc/report
Restart the Agent.
Log collection
Collecting logs is disabled by default in the Datadog Agent, enable it in your datadog.yaml file:
Add this configuration block to your kyototycoon.d/conf.yaml file to start collecting Kyoto Tycoon logs:
logs:
- type: file
path: /var/data/ktserver.log
source: kyototycoon
Change the path parameter value based on your environment. See the sample kyototycoon.d/conf.yaml for all available configuration options.
Restart the Agent.
Validation
Run the Agent’s status subcommand and look for kyototycoon under the Checks section.
Data Collected
Metrics
kyototycoon.connections_per_s
(rate) | Total number of connections
Shown as connection |
kyototycoon.ops.get.hits_per_s
(rate) | Rate of get hits
Shown as hit |
kyototycoon.ops.get.misses_per_s
(rate) | Rate of get misses
Shown as hit |
kyototycoon.ops.get.total_per_s
(rate) | Rate of total get hits
Shown as hit |
kyototycoon.ops.set.hits_per_s
(rate) | Rate of set hits
Shown as hit |
kyototycoon.ops.set.total_per_s
(rate) | Rate of total set hits
Shown as hit |
kyototycoon.opts.del.hits_per_s
(rate) | Rate of deleted hits
Shown as hit |
kyototycoon.opts.del.misses_per_s
(rate) | Rate of deleted misses
Shown as miss |
kyototycoon.opts.del.total_per_s
(rate) | Rate of total deleted hits
Shown as hit |
kyototycoon.opts.set.misses_per_s
(rate) | Rate of set misses
Shown as miss |
kyototycoon.records
(gauge) | Total amount of records
Shown as record |
kyototycoon.replication.delay
(gauge) | Replication delay
Shown as millisecond |
kyototycoon.size
(gauge) | Current size of the kyoto tycoon DB |
kyototycoon.threads
(gauge) | Total number of threads
Shown as thread |
Events
The KyotoTycoon check does not include any events.
Service Checks
kyototycoon.can_connect
Returns CRITICAL if the Agent is unable to connect to the monitored KyotoTycoon instance. Returns OK otherwise.
Statuses: ok, critical
Troubleshooting
Need help? Contact Datadog support.
