Monitoring Kyoto Tycoon

This article will help you get the Kyototycoon plugin for sd-agent configured and returning metrics

Installing the kyototycoon plugin package

Install the kyototycoon plugin on Debian/Ubuntu:

sudo apt-get install sd-agent-kyototycoon

Install the kyototycoon plugin on RHEL/CentOS:

sudo yum install sd-agent-kyototycoon

Read more about agent plugins.

Configuring the agent to monitor Kyoto Tycoon

1. Configure /etc/sd-agent/conf.d/kyototycoon.yaml

init_config:

instances:
- report_url: http://localhost:1978/rpc/report

2. Restart the agent

sudo /etc/init.d/sd-agent restart

or

sudo systemctl restart sd-agent

Verifying the configuration
Execute info to verify the configuration with the following:

sudo /etc/init.d/sd-agent info 

or

/usr/share/python/sd-agent/agent.py info

If the agent has been configured correctly you'll see an output such as:

kyototycoon
-----
  - instance #0 [OK]
  - Collected * metrics

You can also view the metrics returned with the following command:

sudo -u sd-agent /usr/share/python/sd-agent/agent.py check kyototycoon

Configuring graphs

Click the name of your server from the Devices list in your Server Density account then go to the Metrics tab. Click the + Graph button on the right then choose the kyototycoon metrics to display the graphs. The metrics will also be available to select when building dashboard graphs.

Monitored metrics

Metric	Values
kyototycoon.cnt_get Rate of get hits	hit / None Type: float
kyototycoon.cnt_get_misses Rate of get misses	miss / None Type: float
kyototycoon.cnt_remove Rate of deleted hits	hit / None Type: float
kyototycoon.cnt_remove_misses Rate of deleted misses	miss / None Type: float
kyototycoon.cnt_set Rate of set hits	hit / None Type: float
kyototycoon.cnt_set_misses Rate of set misses	miss / None Type: float
kyototycoon.count Total amount of records	record / None Type: float
kyototycoon.repl_delay Replication delay	millisecond / None Type: float
kyototycoon.serv_conn_count Total number of connections	connection / None Type: float
kyototycoon.serv_thread_count Total number of threads	thread / None Type: float
kyototycoon.size Current size of the kyoto tycoon DB	None / None Type: float