From 1fa1f0329442c555635460221c809fecdaa977a7 Mon Sep 17 00:00:00 2001 From: Paul Buetow Date: Tue, 7 Dec 2021 09:23:00 +0000 Subject: initial logformats and querylanguage documentation --- doc/index.md | 14 ++++++++++++++ doc/logformats.md | 4 ++++ doc/querylanguage.md | 18 ++++++++++++++++++ 3 files changed, 36 insertions(+) create mode 100644 doc/index.md create mode 100644 doc/logformats.md create mode 100644 doc/querylanguage.md (limited to 'doc') diff --git a/doc/index.md b/doc/index.md new file mode 100644 index 0000000..9a5a42f --- /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 +``` -- cgit v1.2.3 From 35583f55844f5738eb52c9363f7a7e091d455726 Mon Sep 17 00:00:00 2001 From: Paul Buetow Date: Tue, 7 Dec 2021 09:23:48 +0000 Subject: fix hyperlink --- doc/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'doc') diff --git a/doc/index.md b/doc/index.md index 9a5a42f..2fc790e 100644 --- a/doc/index.md +++ b/doc/index.md @@ -9,6 +9,6 @@ DTail Documentation ## 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. +* 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. -- cgit v1.2.3