summaryrefslogtreecommitdiffstats
path: root/iredis/data/commands/latency-doctor.md
diff options
context:
space:
mode:
Diffstat (limited to 'iredis/data/commands/latency-doctor.md')
-rw-r--r--iredis/data/commands/latency-doctor.md47
1 files changed, 47 insertions, 0 deletions
diff --git a/iredis/data/commands/latency-doctor.md b/iredis/data/commands/latency-doctor.md
new file mode 100644
index 0000000..e089abb
--- /dev/null
+++ b/iredis/data/commands/latency-doctor.md
@@ -0,0 +1,47 @@
+The `LATENCY DOCTOR` command reports about different latency-related issues and
+advises about possible remedies.
+
+This command is the most powerful analysis tool in the latency monitoring
+framework, and is able to provide additional statistical data like the average
+period between latency spikes, the median deviation, and a human-readable
+analysis of the event. For certain events, like `fork`, additional information
+is provided, like the rate at which the system forks processes.
+
+This is the output you should post in the Redis mailing list if you are looking
+for help about Latency related issues.
+
+@example
+
+```
+127.0.0.1:6379> latency doctor
+
+Dave, I have observed latency spikes in this Redis instance.
+You don't mind talking about it, do you Dave?
+
+1. command: 5 latency spikes (average 300ms, mean deviation 120ms,
+ period 73.40 sec). Worst all time event 500ms.
+
+I have a few advices for you:
+
+- Your current Slow Log configuration only logs events that are
+ slower than your configured latency monitor threshold. Please
+ use 'CONFIG SET slowlog-log-slower-than 1000'.
+- Check your Slow Log to understand what are the commands you are
+ running which are too slow to execute. Please check
+ http://redis.io/commands/slowlog for more information.
+- Deleting, expiring or evicting (because of maxmemory policy)
+ large objects is a blocking operation. If you have very large
+ objects that are often deleted, expired, or evicted, try to
+ fragment those objects into multiple smaller objects.
+```
+
+**Note:** the doctor has erratic psychological behaviors, so we recommend
+interacting with it carefully.
+
+For more information refer to the [Latency Monitoring Framework page][lm].
+
+[lm]: /topics/latency-monitor
+
+@return
+
+@bulk-string-reply