Overview
The Agent’s KyotoTycoon check tracks get, set, and delete operations, and lets you monitor replication lag.
Minimum Agent version: 6.0.0
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.