diff options
| author | Paul Buetow <pbuetow@mimecast.com> | 2021-12-09 09:33:13 +0000 |
|---|---|---|
| committer | Paul Buetow <pbuetow@mimecast.com> | 2021-12-09 09:33:13 +0000 |
| commit | a8438bd6f04d7c99c8fd033d7161054a64c85473 (patch) | |
| tree | ae1bb7d927cd6169c6fa8174765424350fada9d5 /doc | |
| parent | 785d379ca02f4488d39e8952e9ae5bea673cd930 (diff) | |
| parent | 35583f55844f5738eb52c9363f7a7e091d455726 (diff) | |
Merge branch '4.0.0-RC' of https://codeberg.org/snonux/dtail into 4.0.0-RC
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/index.md | 14 | ||||
| -rw-r--r-- | doc/logformats.md | 4 | ||||
| -rw-r--r-- | doc/querylanguage.md | 18 |
3 files changed, 36 insertions, 0 deletions
diff --git a/doc/index.md b/doc/index.md new file mode 100644 index 0000000..2fc790e --- /dev/null +++ b/doc/index.md @@ -0,0 +1,14 @@ +DTail Documentation +=================== + +## Installation and Usage + +* To get a taste, please have a look at the [Usage Examples](./examples.md). +* Follow the [Quick Starting Guide](./quickstart.md) if you are looking into DTail your first time. +* For a more sustainable setup, please follow the [Installation Guide](./installation.md). + +## Advanced topics + +* The [DTail Query Language](./querylanguage.md) is the starting point to dig deeper into DTail's own SQL-like mapreduce language for extracting stats from log files. +* [Log Formats](./logformats.md) explains how to create your own custom log format for use with mapreduce queries. +* Check out the [Testing Guide](./testing.md) for unit and integration testing. diff --git a/doc/logformats.md b/doc/logformats.md new file mode 100644 index 0000000..a9f9865 --- /dev/null +++ b/doc/logformats.md @@ -0,0 +1,4 @@ +Log Formats +=========== + +TODO: document log formats. diff --git a/doc/querylanguage.md b/doc/querylanguage.md new file mode 100644 index 0000000..9f38f5e --- /dev/null +++ b/doc/querylanguage.md @@ -0,0 +1,18 @@ +DTail Query Language +==================== + +The query language allows you to run mapreduce queries on log files. This page intends to be a reference to the language. + +## Prerequisites + +For this to work, DTail needs to understand your log format. DTail already understands its own log format. You can have a look at all examples of the [examples](./examples.md) page using `-query` (these would be all examples of the `dmap` command, and some examples using the `dtail` command). + +DTail also ships with a generic log format, which only allows you to run very basic queries. Check out the [log formats](./logformats.md) documentation for this. + +To implement your own log format, please also check out the [log formats](./logformats.md) documentation. + +## The complete language + +``` +TODO: Add EBNF +``` |