Memory¶

admin.v3.Memory¶

Proto representation of the internal memory consumption of an Envoy instance. These represent values extracted from an internal TCMalloc instance. For more information, see the section of the docs entitled [“Generic Tcmalloc Status”](https://gperftools.github.io/gperftools/tcmalloc.html).

{
  "allocated": "...",
  "heap_size": "...",
  "pageheap_unmapped": "...",
  "pageheap_free": "...",
  "total_thread_cache": "...",
  "total_physical_bytes": "..."
}

allocated: (uint64) The number of bytes allocated by the heap for Envoy. This is an alias for generic.current_allocated_bytes.

heap_size: (uint64) The number of bytes reserved by the heap but not necessarily allocated. This is an alias for generic.heap_size.

pageheap_unmapped: (uint64) The number of bytes in free, unmapped pages in the page heap. These bytes always count towards virtual memory usage, and depending on the OS, typically do not count towards physical memory usage. This is an alias for tcmalloc.pageheap_unmapped_bytes.

pageheap_free: (uint64) The number of bytes in free, mapped pages in the page heap. These bytes always count towards virtual memory usage, and unless the underlying memory is swapped out by the OS, they also count towards physical memory usage. This is an alias for tcmalloc.pageheap_free_bytes.

total_thread_cache: (uint64) The amount of memory used by the TCMalloc thread caches (for small objects). This is an alias for tcmalloc.current_total_thread_cache_bytes.

total_physical_bytes: (uint64) The number of bytes of the physical memory usage by the allocator. This is an alias for generic.total_physical_bytes.