Browse files

Merge pull request #225 from omniti-labs/multi-metric-README

Update README with more information about multi-metric packets.
  • Loading branch information...
2 parents fb2ed48 + 91131dc commit 86ad6edbe9129ddb7540a23169ace2cadd3fafef @mrtazz mrtazz committed Dec 25, 2012
Showing with 19 additions and 2 deletions.
  1. +19 −2
@@ -74,8 +74,25 @@ using a Set to store all occuring events.
-All metrics can also be batch send in a single UDP packet, separated by a
-newline character.
+Multi-Metric Packets
+StatsD supports receiving multiple metrics in a single packet by separating them
+with a newline.
+ gorets:1|c\nglork:320|ms\ngaugor:333|g\nuniques:765|s
+Be careful to keep the total length of the payload within your network's MTU. There
+is no single good value to use, but here are some guidelines for common network
+* Fast Ethernet (1432) - This is most likely for Intranets.
+* Gigabit Ethernet (8932) - Jumbo frames can make use of this feature much more
+ efficient.
+* Commodity Internet (512) - If you are routing over the internet a value in this
+ range will be reasonable. You might be able to go higher, but you are at the mercy
+ of all the hops in your route.
+*(These payload numbers take into account the maximum IP + UDP header sizes)*

0 comments on commit 86ad6ed

Please sign in to comment.