# Is LSCL documented?

**URL:** <https://discuss.elastic.co/t/is-lscl-documented/353178>\
**Category:** Logstash\
**Created:** [February 13, 2024, 2:16pm UTC](https://discuss.elastic.co/t/is-lscl-documented/353178 "2024-02-13T14:16:36Z")\
**Posts on this page:** 4\
**Page:** 1

<div class="post-metadata">

**Author:** ![joostdecock](https://sea2.discourse-cdn.com/elastic/user_avatar/discuss.elastic.co/joostdecock/32/77456_2.png) [@joostdecock](https://discuss.elastic.co/u/joostdecock)\
**Post date:** [February 13, 2024, 2:16pm UTC](https://discuss.elastic.co/t/is-lscl-documented/353178/1 "2024-02-13T14:16:36Z")

</div>

Hi all,  
I am looking for documentation on LSCL, the logstash configuration language. The one that inputs and pipelines are written in and looks like this:

```auto
input {
  kafka {
    id => "whatever"
  }
}

```

I'm in a situation where I want to auto-generate a configuration based on some inputs, and so I would like to make sure I have a good grasp on the syntax.

Unfortunately, I cannot find any documentation on this. Since starting to look for it, I've learned it's internally referred to as LSCL, it's some sort of DSL that uses Treetop. Yet while I've found all this, I have yet to find any documentation on it.

Is there documentation for this configuration format? Or are we supposed to figure it out by reading the compiler code? [logstash/logstash-core/lib/logstash/compiler/lscl at v6.1.3 · elastic/logstash · GitHub](https://github.com/elastic/logstash/tree/v6.1.3/logstash-core/lib/logstash/compiler/lscl)

tx  
joost

---

<div class="post-metadata">

**Author:** ![Badger](https://sea2.discourse-cdn.com/elastic/user_avatar/discuss.elastic.co/badger/32/25190_2.png) [@Badger](https://discuss.elastic.co/u/Badger)\
**Post date:** [February 13, 2024, 5:43pm UTC](https://discuss.elastic.co/t/is-lscl-documented/353178/2 "2024-02-13T17:43:13Z")

</div>

> [@joostdecock](#):
>
> are we supposed to figure it out by reading the compiler code?

I believe the answer to that is "yes".

---

<div class="post-metadata">

**Author:** ![joostdecock](https://sea2.discourse-cdn.com/elastic/user_avatar/discuss.elastic.co/joostdecock/32/77456_2.png) [@joostdecock](https://discuss.elastic.co/u/joostdecock)\
**Post date:** [February 15, 2024, 8:36am UTC](https://discuss.elastic.co/t/is-lscl-documented/353178/3 "2024-02-15T08:36:53Z")

</div>

Thanks you. That's not great, but at least it's clear I should waste no time looking for it.

---

<div class="post-metadata">

**Author:** ![system](https://us1.discourse-cdn.com/elastic/original/3X/1/a/1ac57faf039f6b580b3f104ef42a2a89e41014de.png) [@system](https://discuss.elastic.co/u/system)\
**Post date:** [March 14, 2024, 8:37am UTC](https://discuss.elastic.co/t/is-lscl-documented/353178/4 "2024-03-14T08:37:49Z")

</div>

Closed on March 14, 2024, 8:37am UTC

This topic was automatically closed 28 days after the last reply. New replies are no longer allowed.