# [[Loki query frontend]] ![[Loki query frontend.svg]] The [[Grafana Loki|Loki]] query frontend is an *optional* [[Architecture of Loki|component]] that: - holds all the queries in a queue until the [[Loki querier|queriers]] can work on them - splits large and complex orders (the queries) into many smaller ones so that multiple queriers can work on them simultaneously later. - when all the smaller orders have been worked on, the query frontend stitches them all back together. - caches most recent queries for performance of repeated queries It is also [[Stateless]]. <iframe width="560" height="315" src="https://www.youtube.com/embed/_hv4i84Z68s?start=561" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe> ## Scaling query frontends > [!tip] Rule of thumb: how many query frontends should I have? > In a full [[How to deploy Grafana Loki|microservices deployment of Loki]], start with 2. The query frontend is technically an optional component. In the absence of a query frontend, the querier handles all queries. %% # Excalidraw Data ## Text Elements ## Embedded Files 8294d7181cb6b5970b6562e5747aa26c17adfeb3: [[icon-front-desk-pink-hair.svg]] 265f476df7cc710b1ad93d225be6b4659fe75249: [[flaticon-search-query.png]] f7140a7219d9b5270a6641235cd62da1390a5955: [[icon-component.svg]] df915bd51a106fc7bab96b3c4f53c2e8c9815927: [[icon-thought-cloud.svg]] ## Drawing ```compressed-json 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= ``` %%