.. _arch_overview_load_reporting_service:

Load Reporting Service (LRS)
============================

The Load Reporting Service provides a mechanism by which Envoy can emit Load Reports to a management
server at a regular cadence.

This will initiate a bi-directional stream with a management server. Upon connecting, the management
server can send a :ref:`LoadStatsResponse <envoy_v3_api_msg_service.load_stats.v3.LoadStatsResponse>`
to a node it is interested in getting the load reports for. Envoy in this node will start sending
:ref:`LoadStatsRequest <envoy_v3_api_msg_service.load_stats.v3.LoadStatsRequest>`. This is done periodically
based on the :ref:`load reporting interval <envoy_v3_api_field_service.load_stats.v3.LoadStatsResponse.load_reporting_interval>`

Envoy config with LRS can be found at :repo:`/examples/load-reporting-service/service-envoy-w-lrs.yaml`.