You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@drill.apache.org by "David Severski (Jira)" <ji...@apache.org> on 2020/03/29 14:43:00 UTC
[jira] [Created] (DRILL-7676) Improve documentation for httpd
format plugin
David Severski created DRILL-7676:
-------------------------------------
Summary: Improve documentation for httpd format plugin
Key: DRILL-7676
URL: https://issues.apache.org/jira/browse/DRILL-7676
Project: Apache Drill
Issue Type: Improvement
Components: Documentation
Affects Versions: 1.17.0
Reporter: David Severski
The httpd format plugin documentation ([https://drill.apache.org/docs/httpd-format-plugin/)] speaks to the configuration required to setup the plugin, but has no information on the returned fields of the parser. As a casual drill user, after configuring the plugin, I was confused to receive over 100 fields in my first `SELECT * FROM` query, all of which had complex names and were opaque to understand.
Conversation on the drill slack led to the info that the underlying parser is [https://github.com/nielsbasjes/logparser] which eventually yields that the parser has a complicated name/type/dissector structure. The logparser project itself doesn't describe what the hierarchy looks like, which is unfortunate.
I'd really like a end-user understandable enhancement to the drill docs that try to walk users through what they will get back from this parser, touching on the various parts of the tree returned from this plugin. In particular, the inclusion of fields with `firstline` and `lastline` were of special confusion when I first encountered them
--
This message was sent by Atlassian Jira
(v8.3.4#803005)