anchor.diff: -= ptrans
  += ptrans - An Hawkular Metrics proxy
   :type: article
   
  -= ptrans - hawkular-metrics restServlet proxy
  -
   This is a proxy server taking in metrics data in several common formats and emitting
  -them as rest-requests into hawkular-metrics backend for storage.
  -
  -You can configure ports to use in a `ptrans.properties` file, which you can pass on the
  -command line. Otherwise an internal default is used. See also below.
  +them as REST requests into Hawkular Metrics backend for storage.
   
   == Supported input formats
   
   === Syslog
   
   This module contains a simple proxy server that also listens on UDP port 5140
  -for syslog messages. If a message is of the format
  -
  -  type=metric thread.count=7 thread.active=5 heap.permgen.size=20000000
  -
  +for syslog messages. If a message is of the format:
  +----
  +type=metric thread.count=7 thread.active=5 heap.permgen.size=20000000
  +----
   Then it is taken and the individual key-value-pairs are broken apart and
   sent as individual metrics to a hawkular-metrics rest server. The timestamp
   is the current time on the proxy when the udp packet was received.
  
positive.code: For this to work, the packets from Ganglia need to have a large enough TTL to be seen on the host where you run pTrans.
  
  Excerpt from gmond.conf:
  
  ----
  udp_send_channel {
   mcast_join = 239.2.11.71
  
negative.code: 
  You need to configure syslog to forward you the messages.
  For this you need to edit `/ec/syslog.conf` and add a line like this:
  ----
  *.info          @127.0.0.1:5140
  ----
  
  (the facility and severity may vary depending on how your application is logging the metrics)
  
  ==== Manually testing
  
  On a *nix command line you can run:
  ----
  $ logger -p local3.info "type=metric thread.count=7 thread.active=5 heap.permgen.size=20000000"
  ----
  to add entries to syslog for testing purposes.
  
  === Graphite
  
  The converter also accepts Graphite plaintext format:
  ----
  path value timestamp_in_s
  ----
  
  Or with multiple entries per message:
  ----
  path1 value1 timestamp_in_s1
  path2 value2 timestamp_in_s2
  ----
  
  === Ganglia
  
  