How nutanix/envoyproxy-envoy works
Envoy is a cloud-native edge, middle, and service proxy. Its main product workflow is to accept downstream network traffic, process HTTP streams through connection management and filters, then use upstream cluster and endpoint state to reach services. The repository also defines configuration APIs and supports dynamic xDS updates, observability, and mobile clients. The map emphasizes these documented product stages and sampled implementation links; many runtime relationships are not evidenced by the excerpts, so they are left unconnected.
Main entry points: conn_manager_impl.cc HTTP connection manager · cluster_manager_impl.cc Cluster manager · xds_manager_impl.cc xDS management · bootstrap.proto Bootstrap config
Components 34
Configuration and discovery
- Bootstrap config
api/envoy/config/bootstrap/v3/bootstrap.proto - xDS management
source/common/config/xds_manager_impl.cc - Discovery APIs
api/envoy/api/v2/discovery.proto - Listener config
api/envoy/config/listener/v3/listener.proto
Proxy traffic
- Listener manager
envoy/server/listener_manager.h - Network connections
envoy/network/connection.h - HTTP manager API
api/envoy/extensions/filters/network/http_connection_manager/v3/http_connection_manager.proto - HTTP connection manager
source/common/http/conn_manager_impl.cc - HTTP filter APIs
api/envoy/extensions/filters/http/router/v3/router.proto - HTTP router
envoy/router/router.h - Buffer interface
envoy/buffer/buffer.h - Event dispatcher
envoy/event/dispatcher.h - Network filter API
envoy/network/filter.h - Listener API
envoy/network/listener.h - Network utilities
source/common/network/utility.h
Upstream connectivity
- Cluster manager
source/common/upstream/cluster_manager_impl.cc - Cluster APIs
api/envoy/config/cluster/v3/cluster.proto - Endpoint config
api/envoy/config/endpoint/v3/endpoint.proto - Upstream services
- Upstream interface
envoy/upstream/upstream.h
Security and observability
- TLS contexts
envoy/ssl/context_manager.h - Stats scopes
envoy/stats/scope.h - Admin APIs
api/envoy/admin/v3/config_dump.proto - Access logging
api/envoy/config/accesslog/v3/accesslog.proto - Tracing APIs
envoy/tracing/tracer_manager.h - Runtime interface
envoy/runtime/runtime.h - Stream information
envoy/stream_info/stream_info.h - Common utilities
source/common/common/utility.h - Assertions
source/common/common/assert.h - Formatting
source/common/common/fmt.h
Mobile client
- Engine builder
mobile/library/cc/engine_builder.cc - Internal engine
mobile/library/common/internal_engine.cc - Mobile APIs
mobile/library/objective-c/EnvoyEngine.h
Other components
- Proxy operator
Connections 20
- Proxy operator → Bootstrap config: configures
README.md - Bootstrap config → xDS management: configures
- Discovery APIs → xDS management: defines resources
- Listener config → Listener manager: configures
- Listener manager → Network connections: accepts traffic
- Network connections → HTTP connection manager: dispatches HTTP
- HTTP manager API → HTTP connection manager: configures
- HTTP connection manager → HTTP router: uses
source/common/http/conn_manager_impl.cc - HTTP filter APIs → HTTP connection manager: configures filters
- HTTP connection manager → Access logging: logs streams
source/common/http/conn_manager_impl.cc - Cluster manager → xDS management: initializes
source/common/upstream/cluster_manager_impl.cc - Cluster APIs → Cluster manager: configures
- Endpoint config → Cluster manager: supplies endpoints
- HTTP router → Cluster manager: selects upstream
- Cluster manager → Upstream services: connects upstream
- Engine builder → Internal engine: builds
mobile/library/cc/engine_builder.cc - Internal engine → HTTP connection manager: starts streams
- Mobile APIs → Engine builder: configures engine
- HTTP connection manager → Stream information: updates stream state
source/common/http/conn_manager_impl.cc - Cluster manager → Upstream interface: implements
source/common/upstream/cluster_manager_impl.cc