github.com/yankunsam/loki/v2@v2.6.3-0.20220817130409-389df5235c27/docs/sources/fundamentals/overview/_index.md (about)

     1  ---
     2  title: Overview
     3  weight: 100
     4  aliases:
     5      - /docs/loki/latest/overview/
     6  ---
     7  # Overview
     8  
     9  Grafana Loki is a log aggregation tool,
    10  and it is the core of a fully-featured logging stack.
    11  
    12  Loki is a datastore optimized for efficiently holding log data.
    13  The efficient indexing of log data
    14  distinguishes Loki from other logging systems.
    15  Unlike other logging systems, a Loki index is built from labels,
    16  leaving the original log message unindexed.
    17  
    18  ![Loki overview](loki-overview-1.png)
    19  
    20  An agent (also called a client) acquires logs,
    21  turns the logs into streams,
    22  and pushes the streams to Loki through an HTTP API.
    23  The Promtail agent is designed for Loki installations,
    24  but many other [Agents](../../clients/) seamlessly integrate with Loki.
    25  
    26  ![Loki agent interaction](loki-overview-2.png)
    27  
    28  Loki indexes streams.
    29  Each stream identifies a set of logs associated with a unique set of labels.
    30  A quality set of labels is key to the creation of an index that is both compact
    31  and allows for efficient query execution.
    32  
    33  [LogQL](../../logql) is the query language for Loki.
    34  
    35  ## Loki features
    36  
    37  -  **Efficient memory usage for indexing the logs**
    38  
    39      By indexing on a set of labels, the index can be significantly smaller
    40      than other log aggregation products.
    41      Less memory makes it less expensive to operate.
    42  
    43  -  **Multi-tenancy**
    44  
    45      Loki allows multiple tenants to utilize a single Loki instance.
    46      The data of distinct tenants is completely isolated from other tenants.
    47      Multi-tenancy is configured by assigning a tenant ID in the agent.
    48  
    49  -  **LogQL, Loki's query language**
    50  
    51      Users of the Prometheus query language, PromQL, will find LogQL familiar
    52      and flexible for generating queries against the logs.
    53      The language also facilitates the generation of metrics from log data,
    54      a powerful feature that goes well beyond log aggregation.
    55  
    56  -  **Scalability**
    57  
    58      Loki can be run as a single binary;
    59      all the components run in one process.
    60  
    61      Loki is designed for scalability,
    62      as each of Loki's components can be run as microservices.
    63      Configuration permits scaling the microservices individually,
    64      permitting flexible large-scale installations.
    65  
    66  -  **Flexibility**
    67  
    68      Many agents (clients) have plugin support.
    69      This allows a current observability structure
    70      to add Loki as their log aggregation tool without needing
    71      to switch existing portions of the observability stack.
    72  
    73  -  **Grafana integration**
    74  
    75      Loki seamlessly integrates with Grafana,
    76      providing a complete observability stack.
    77