Envoy Proxy Integration

Envoy Proxy Integration

Envoy Proxy is a modern, high performance service proxy. It adds resilience and observability to your services. By setting up this integration, you can send Envoy metrics into Wavefront.

1. Envoy Proxy: This integration installs and configures Telegraf to send Envoy Proxy metrics into Wavefront. Telegraf is a light-weight server process capable of collecting, processing, aggregating, and sending metrics to a Wavefront proxy.
2. Envoy Proxy on Kubernetes: This explains the configuration of Wavefront Collector for Kubernetes to scrape Envoy metrics using auto-discovery and annotation based discovery.

In addition to setting up the metrics flow, this integration also installs dashboards:

• Envoy Proxy
• Envoy Proxy on Kubernetes

Here’s a screenshot of Envoy Proxy dashboard:

To see a list of the metrics for this integration, select the integration from https://github.com/influxdata/telegraf/tree/master/plugins/inputs.

Envoy Proxy Setup

This integration uses Telegraf’s Prometheus input plugin to fetch the metrics from Envoy Proxy and push them to Wavefront. If you’ve already installed Telegraf on your server, you can skip to Step 2.

Step 1: Install the Telegraf Agent

Log in to your Wavefront instance and follow the instructions in the Setup tab to install Telegraf and a Wavefront proxy in your environment. If a proxy is already running in your environment, you can select that proxy and the Telegraf install command connects with that proxy. Sign up for a free trial to check it out!

Step 2: Enable the Prometheus Input Plugin

Create a file called envoy.conf in /etc/telegraf/telegraf.d and enter the following snippet:

    # Read metrics exposed by Envoy Proxy
    [[inputs.prometheus]]
      urls = ["http://<envoy_proxy_admin_server_url>/stats?format=prometheus"]

Step 3: Restart Telegraf

Run sudo service telegraf restart to restart your Telegraf agent.

Envoy Proxy on Kubernetes

This integration uses the annotation based discovery feature in Wavefront Collector to monitor Envoy proxy on Kubernetes. If you do not have the Wavefront Collector for Kubernetes installed, follow these instructions to add it to your cluster by using Helm or performing Manual Installation. You can check the status of the Wavefront Collector and Proxy if you are already monitoring the Kubernetes cluster on the Setup tab of the Kubernetes integration.

Steps to Annotate Envoy Proxy Deployment

1. Make sure that auto discovery enableDiscovery: true and annotation based discovery discovery.disable_annotation_discovery: false are enabled in the Wavefront Collector ConfigMap. They should be enabled by default. NOTE: The Wavefront Collector scrapes all the pods that have Prometheus annotation enabled.
2. Annotate the Envoy pods so that they can be discovered by Wavefront Collector. Assuming that the admin port_value in Envoy ConfigMap is 9901, run:

   kubectl annotate pods <pod-name> prometheus.io/scrape=true prometheus.io/port=9901 prometheus.io/path=/stats/prometheus
   

Refer here to see a sample Envoy Proxy Deployment and ConfigMap.

Metrics