.. _envoy_v3_api_file_envoy/extensions/filters/network/local_ratelimit/v3/local_rate_limit.proto: Local rate limit ================ This documentation is for the Envoy v3 API. As of Envoy v1.18 the v2 API has been removed and is no longer supported. If you are upgrading from v2 API config you may wish to view the v2 API documentation: :ref:`config/filter/network/local_rate_limit/v2alpha/local_rate_limit.proto ` .. _extension_envoy.filters.network.local_ratelimit: This extension may be referenced by the qualified name ``envoy.filters.network.local_ratelimit`` .. note:: This extension is intended to be robust against untrusted downstream traffic. It assumes that the upstream is trusted. .. tip:: This extension extends and can be used with the following extension category: - :ref:`envoy.filters.network ` Local rate limit :ref:`configuration overview `. .. _envoy_v3_api_msg_extensions.filters.network.local_ratelimit.v3.LocalRateLimit: extensions.filters.network.local_ratelimit.v3.LocalRateLimit ------------------------------------------------------------ :repo:`[extensions.filters.network.local_ratelimit.v3.LocalRateLimit proto] ` .. code-block:: json { "stat_prefix": "...", "token_bucket": "{...}", "runtime_enabled": "{...}" } .. _envoy_v3_api_field_extensions.filters.network.local_ratelimit.v3.LocalRateLimit.stat_prefix: stat_prefix (`string `_, *REQUIRED*) The prefix to use when emitting :ref:`statistics `. .. _envoy_v3_api_field_extensions.filters.network.local_ratelimit.v3.LocalRateLimit.token_bucket: token_bucket (:ref:`type.v3.TokenBucket `, *REQUIRED*) The token bucket configuration to use for rate limiting connections that are processed by the filter's filter chain. Each incoming connection processed by the filter consumes a single token. If the token is available, the connection will be allowed. If no tokens are available, the connection will be immediately closed. .. note:: In the current implementation each filter and filter chain has an independent rate limit. .. note:: In the current implementation the token bucket's :ref:`fill_interval ` must be >= 50ms to avoid too aggressive refills. .. _envoy_v3_api_field_extensions.filters.network.local_ratelimit.v3.LocalRateLimit.runtime_enabled: runtime_enabled (:ref:`config.core.v3.RuntimeFeatureFlag `) Runtime flag that controls whether the filter is enabled or not. If not specified, defaults to enabled.