Envoy Proxy

Envoy Proxy Statistics API

Statistics and metrics endpoints.

GitHub OpenAPI

Operations 4

GET /stats Envoy Proxy Get Statistics #
GET /stats/prometheus Envoy Proxy Get Statistics in Prometheus Format #
GET /stats/recentlookups Envoy Proxy Get Recent Stat Lookups #
POST /reset_counters Envoy Proxy Reset Counters #

Documentation

📖
Documentation
https://www.envoyproxy.io/docs/envoy/latest/operations/admin
📖
Documentation
https://www.envoyproxy.io/docs/envoy/latest/api-docs/xds_protocol

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/envoy-proxy/refs/heads/main/openapi/envoy-proxy-statistics-api-openapi.yml

SDKs

📦
GitHubRepository
https://github.com/envoyproxy/envoy

Other Resources

🔗
ChangeLog
https://github.com/envoyproxy/envoy/releases
🔗
Reference
https://www.envoyproxy.io/docs/envoy/latest/configuration/overview/xds_api

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/envoy-proxy-statistics-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

envoy-proxy-statistics-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Envoy Proxy Admin Statistics API
  description: The Envoy Proxy Administration Interface provides a local HTTP-based management API for querying and modifying various aspects of the Envoy server at runtime.
  version: 1.38.0
  contact:
    name: Envoy Proxy
    url: https://www.envoyproxy.io/
  license:
    name: Apache 2.0
    url: https://www.apache.org/licenses/LICENSE-2.0
servers:
- url: http://localhost:9901
  description: Default Envoy Admin Interface
tags:
- name: Statistics
  description: Statistics and metrics endpoints.
paths:
  /stats:
    get:
      operationId: getStats
      summary: Envoy Proxy Get Statistics
      description: Returns statistics that Envoy has collected, including counters, gauges, and histograms. Stats are provided as key-value pairs using a hierarchical dotted notation.
      parameters:
      - name: format
        in: query
        description: Output format for the statistics.
        schema:
          type: string
          enum:
          - json
          - prometheus
          - text
      - name: filter
        in: query
        description: Regular expression to filter the returned statistics by name.
        schema:
          type: string
      - name: usedonly
        in: query
        description: Only return statistics that have been written to by Envoy.
        schema:
          type: boolean
      - name: histogram_buckets
        in: query
        description: Control histogram output mode.
        schema:
          type: string
          enum:
          - cumulative
          - disjoint
          - none
      responses:
        '200':
          description: Successful response with statistics.
          content:
            text/plain:
              schema:
                type: string
            application/json:
              schema:
                type: object
      tags:
      - Statistics
  /stats/prometheus:
    get:
      operationId: getStatsPrometheus
      summary: Envoy Proxy Get Statistics in Prometheus Format
      description: Returns statistics in Prometheus exposition format suitable for scraping by a Prometheus server.
      parameters:
      - name: usedonly
        in: query
        description: Only return statistics that have been written to by Envoy.
        schema:
          type: boolean
      - name: text_readouts
        in: query
        description: Include text readout gauges in the output.
        schema:
          type: boolean
      - name: filter
        in: query
        description: Regular expression to filter the returned statistics by name.
        schema:
          type: string
      responses:
        '200':
          description: Successful response with Prometheus-formatted statistics.
          content:
            text/plain:
              schema:
                type: string
      tags:
      - Statistics
  /stats/recentlookups:
    get:
      operationId: getStatsRecentLookups
      summary: Envoy Proxy Get Recent Stat Lookups
      description: Returns a table of recently looked-up stat names.
      responses:
        '200':
          description: Successful response with recent stat lookups.
          content:
            text/plain:
              schema:
                type: string
      tags:
      - Statistics
  /reset_counters:
    post:
      operationId: postResetCounters
      summary: Envoy Proxy Reset Counters
      description: Resets all counters to zero. This is useful when used in conjunction with GET /stats during debugging sessions.
      responses:
        '200':
          description: Counters reset successfully.
          content:
            text/plain:
              schema:
                type: string
      tags:
      - Statistics