Kyoto Tycoon

Supported OS Linux Mac OS Windows

Integration version4.0.0

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:
```
logs_enabled: true
```
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.