Key/value file-based store storage plugin (proto)


[extensions.key_value.file_based.v3.FileBasedKeyValueStoreConfig proto]

This is configuration to flush a key value store out to disk.


This API feature is currently work-in-progress. API features marked as work-in-progress are not considered stable, are not covered by the threat model, are not supported by the security team, and are subject to breaking changes. Do not use this feature without understanding each of the previous points.

This extension has the qualified name envoy.key_value.file_based


This extension is functional but has not had substantial production burn time, use only with this caveat.

This extension does not operate on the data plane and hence is intended to be robust against untrusted traffic.


This extension extends and can be used with the following extension category:

This extension must be configured with one of the following type URLs:

  "filename": ...,
  "flush_interval": {...},
  "max_entries": {...}

(string, REQUIRED) The filename to read the keys and values from, and write the keys and values to.


(Duration) The interval at which the key value store should be flushed to the file.


(UInt32Value) The maximum number of entries to cache, or 0 to allow for unlimited entries. Defaults to 1000 if not present.