Skip to content

Commit

Permalink
Update structured-metadata docs (grafana#10698)
Browse files Browse the repository at this point in the history
OSS users tried to use the structured metadata feature and faced an
issue because they used previous schema versions (V11, V12) and they
were not aware that it was necessary to use V13 because the docs did not
cover it.

re: grafana#10683
  • Loading branch information
vlad-diachenko authored Sep 25, 2023
1 parent 1415a97 commit bd63f37
Showing 1 changed file with 4 additions and 0 deletions.
4 changes: 4 additions & 0 deletions docs/sources/get-started/labels/structured-metadata.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,6 +9,10 @@ description: Attaching metadata to logs.
Structured metadata is an experimental feature and is subject to change in future releases of Grafana Loki. This feature is not yet available for Cloud Logs users.
{{% /admonition %}}

{{% admonition type="warning" %}}
Structured metadata was added to chunk format V4 which is used if the schema version is greater or equal to `13`. (See [Schema Config]({{< relref "../../storage#schema-config" >}}) for more details about schema versions. )
{{% /admonition %}}

One of the powerful features of Loki is parsing logs at query time to extract metadata and build labels out of it.
However, the parsing of logs at query time comes with a cost which can be significantly high for, as an example,
large json blobs or a poorly written query using complex regex patterns.
Expand Down

0 comments on commit bd63f37

Please sign in to comment.