writing report specifications: field name=? (was: Re: Field definition)

[Joost van Baal]

Hi Cedric,

On Wed, Jan 30, 2002 at 01:44:43PM +0100, gross, cedric wrote:
> De : Joost van Baal [mailto:joostvb at logreport.org]
> > On Wed, Jan 30, 2002 at 12:09:52PM +0100, gross, cedric wrote:
> > > I don't reach to find where are field name definition for logreport.
> > > Is there somewhere a doc with all field available ?
> > 
> > The names of fields are defined per superservice, in files like
> > service/email/email.xml and service/ftp/ftp.xml (these are the
> > locations in our CVS).
> 
> Thanks I found it
> > 
> > > (I have
> > > a beautiful log file for it)
> > > 
> > > <?xml version="1.0" encoding="ISO-8859-1"?>
> > > <!DOCTYPE lire:report-spec PUBLIC
> > >   "-//LogReport.ORG//DTD Lire Report Specification Markup Language
> > > V1.0//EN"
> > >   "http://www.logreport.org/LRSML/1.0/lrsml.dtd">
> > > <lire:report-spec xmlns:lire="http://www.logreport.org/LRSML/"
> > >  superservice="ftp" id="bytes-by-user-by-period">
> > 
> > I assume you are writing a report for the ftp superservice.  Valid
> > fieldnames for this superservice are "time", "transfer_time",
> > "remote_host", "file_size", "filename", "transfer_type",
> > "special_action_flag", "direction", "access_mode", "username",
> > "service_name", "auth_method", "auth_user_id".
> > 
> > >  <lire:title>Bytes by User by Period FTP Report</lire:title>
> > >  <lire:description>
> > >   <para>This report shows the bytes transferred by user by period.
> > >   </para>
> > >  </lire:description>
> > > 
> > >  <lire:param-spec>
> > >   <lire:param name="period" type="duration" default="1d">
> > >    <lire:description>
> > >     <para>This parameter controls the time period which is used to
> > >      aggregate the records.
> > >     </para>
> > >    </lire:description>
> > >   </lire:param>
> > 
> > I don't really understand what you would like to get displayed in your
> > report.  Changing 'period' to 'transfer_time' might give you what you
> > want.  I hope this helps you; if not, please let me know.
> In fact I'm trying to specify a report like:
> User1
> 	12-01-2002........150k
> 	13-01-2002.........64k
> User2
> 	12-01-2002........256k
> 	14-01-2002........10k
> Etc..

A, I see.  That would be a very nice report indeed.

You'd have to combine the ideas in other nested reports like e.g.
www/reports/top-urls-by-client_host.xml with ideas in a by-period
report, like e.g. www/reports/requests-by-period.xml .  You'll need
lire:timegroup and lire:group.  Some notes about these elements are in
all/lib/xml/dtd/lrsml.dtd .  Studying the existing report specifications
is the best way to learn how to write your own, unfortunately.  The
coming Lire release will offer better developer documentation.

> > BTW, I am very pleased to see you working on writing your own report
> > specifications.  Once your specification is stable, we would be very
> > happy to distribute it with our next Lire release.  Please let us know
> > wether you're interested in this.
> 
> It will be a pleasure to share my small work.

Excellent!

BTW, feel free to join the #logreport irc channel to discuss further.
See http://logreport.org/contact/ .

Bye,

Joost

-- 
Joost van Baal              . .           http://www.logreport.org/
                           .   .
/^LogReport$/               . .               joostvb at logreport.org

-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 189 bytes
Desc: not available
Url : http://lists.logreport.org/pipermail/development/attachments/20020130/6aaa141a/attachment.bin