Learn how to monitor Wavefront proxies.

The Wavefront Usage integration includes a Wavefront Service and Proxy Data dashboard that includes several sections with dashboards for examining proxy health.

proxy health

Monitoring Proxy Health with the Usage Dashboard

Wavefront proxies emit metrics that you can use to check if your Wavefront proxy is behaving as expected.

The Proxy Health section of the System Usage dashboard includes commonly used internal metrics, such as the ~proxy.points counter metrics, which measure the data traffic on each port of the proxy. These metrics show the rate at which each proxy receives points, the rate at which the proxy sends points to the Wavefront service, and any queued or blocked points. Here’s an overview of metrics on this dashboard:

  • ~proxy.points.*.received - Counter showing the total points the proxy receives, as a per-second rate. To look at the overall rate of points received across all the ports, you can sum up these series and look at the aggregate rate for a proxy. You can also look at the overall rate across all proxies by summing this up further.

  • ~proxy.points.*.queued - Counter showing the number of points being queued to be sent to Wavefront from the proxy, as a per-second rate. Queueing usually happens for one of the following reasons:

    • The total point rate being collected at Wavefront has reached the maximum capacity. The Wavefront service is pushing back, causing data to buffer at the proxy and causing the proxy to queue points.

    • The proxy has reached the threshold of number of points it can process in each batch. The maximum number of points that a proxy can process and push to Wavefront is determined by these factors:

      • Number of cores on the machine on which the proxy is running
      • pushFlushMaxPoints - batch size the proxy sends every second. This value is configurable.

      The maximum points a proxy can push each second without queueing is:

      number of cores * pushFlushMaxPoints

      The default setting for pushFlushMaxPoints is 40,000. If you are running the proxy on a 4-core machine, the maximum number of points the proxy can send is 160k per second.

  • ~proxy.buffer.task-count - Gauge of the amount of data that the proxy currently has queued.
  • ~proxy.buffer.points-count - Gauge of the number of points currently in the queue.
  • ~proxy.points.*.blocked - Counter of the points being blocked at the proxy, as a per-second rate. If this rate is above 0, you can look at the charts in the Proxy Troubleshooting section of this dashboard to determine if the metrics contain invalid characters or bad timestamps, or if they are failing configurable regular expressions. A small sample of blocked points – up to pushBlockedSamples – and a complete list of blocked points is written to the proxy log file. See the /var/log/wavefront/wavefront-blocked-points.log file for a complete list. See /etc/wavefront/wavefront-proxy/log4j2.xml for configuring for details on enabling and configuring the proxy log file.


These ~proxy metrics describe behavior at the Wavefront proxy:

  • ~proxy.buffer.fill-rate - Rate at which the proxy buffer is filling up in bytes/min.
  • ~proxy.points.*.received - Rate at which points are being received at the proxy.
  • ~proxy.buffer.bytes-left - Available space (in bytes) on the proxy.
  • ~proxy.build.version - Current version number of the proxy.

These metrics are displayed in a tabular chart:


Proxy Troubleshooting

You can also investigate second-level metrics that give you insight into questions, for example:

  • Why are some points blocked?
  • What’s the file descriptor usage on the proxy JVM?
  • How long does it take for points to be pushed from the proxy to the Wavefront service?

The metrics used in this section are:

  • ~proxy.limiter.permits-denied - Counter that shows how many points have been queued due to local proxy settings in wavefront.conf, i.e. the proxy rate limiting itself, not the Wavefront service pushing back.
  • ~proxy.point.badchars - Count of points blocked because of an illegal character.
  • ~proxy.point.badtime - Count of points blocked because of the timestamp (e.g. older than 1 year).
  • ~proxy.validationRegex.*.points-rejected - The points rejected based on the allow list/block list validation (using regex) at the Wavefront proxy.
  • ~proxy.jvm.fd_usage - % of file descriptors in use per proxy. If this metric reaches close to 100% of the allowed usage for the proxy, increase the uLimit on your system.
  • ~proxy.jvm.garbage-collectors.*.time - Garbage collection (GC) activity on the proxy JVM. Anything larger than 200ms is a GC issue, anything near 1s indicates continuous full GCs in the proxy.
  • ~proxy.jvm.memory.heapMax/heapUsed - Memory usage by the proxy process.
  • ~proxy.push.*.duration.duration.median - Duration taken by points pushed from the proxy to reach the Wavefront service. Can help identify network latency issues. You can graph other percentiles.
  • ~proxy.points.*.received.lag.p99 - p99 difference between the timestamp on a point and the time that the proxy received it. High numbers can indicate back-filling old data, or clock drift in sending systems.
  • ~proxy.buffer.queue-time.* - Latency introduced by queueing.

For example, this row from that section shows latency metrics using ~proxy.push.*.duration.duration.median:

proxy troubleshooting

Learn More!