com.bigdata.bop.engine

Class QueryLog

java.lang.Object

com.bigdata.bop.engine.QueryLog

public class QueryLog
extends Object

Class defines the log on which summary operator execution statistics are written.

Author:

Bryan Thompson

Field Summary

Fields

Modifier and Type	Field and Description
protected static org.apache.log4j.Logger	log

Constructor Summary

Constructors

Constructor and Description
QueryLog()

Method Summary

Methods

Modifier and Type	Method and Description
static void	getTableHeaderXHTML(Writer w, boolean clusterStats, boolean detailedStats, boolean mutationStats)
static void	getTableRowsXHTML(String queryStr, IRunningQuery q, Writer w, Map<Integer,QueueStats> queueStats, int maxBopLength, boolean clusterStats, boolean detailedStats, boolean mutationStats) Write the table rows.
static void	getTableXHTML(String queryStr, IRunningQuery q, IRunningQuery[] children, Writer w, boolean summaryOnly, int maxBopLength, boolean clusterStats, boolean detailedStats, boolean mutationStats) Format the data as an (X)HTML table.
static void	log(IRunningQuery q) Log rule execution statistics @ INFO.
static void	logTableHeader()

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

log

protected static final transient org.apache.log4j.Logger log

Constructor Detail

QueryLog

public QueryLog()

Method Detail

logTableHeader

public static void logTableHeader()

log

public static void log(IRunningQuery q)

Log rule execution statistics @ INFO.

Parameters:

q - The running query.

getTableXHTML

public static void getTableXHTML(String queryStr,
                 IRunningQuery q,
                 IRunningQuery[] children,
                 Writer w,
                 boolean summaryOnly,
                 int maxBopLength,
                 boolean clusterStats,
                 boolean detailedStats,
                 boolean mutationStats)
                          throws IOException

Format the data as an (X)HTML table. The table will include a header which declares the columns, a detail row for each operator (optional), and a summary row for the query as a whole.

Parameters:

queryStr - The original text of the query (e.g., a SPARQL query) (optional).

q - The IRunningQuery.

children - The child query(s) -or- null if they are not to be displayed.

w - Where to write the table.

summaryOnly - When true only the summary row will be written.

maxBopLength - The maximum length to display from BOp.toString() and ZERO (0) to display everything. Data longer than this value will be accessible from a flyover, but not directly visible in the page.

clusterStats - When true, provides additional statistics that are specific to the scale-out cluster architecture.

detailedStats - When true, provides additional query statistics that are below the level of detail for most people.

mutationStats - When true, provides additional statistics about mutations (only report for inference rules at this time).

Throws:

IOException

getTableHeaderXHTML

public static void getTableHeaderXHTML(Writer w,
                       boolean clusterStats,
                       boolean detailedStats,
                       boolean mutationStats)
                                throws IOException

Throws:

IOException

getTableRowsXHTML

public static void getTableRowsXHTML(String queryStr,
                     IRunningQuery q,
                     Writer w,
                     Map<Integer,QueueStats> queueStats,
                     int maxBopLength,
                     boolean clusterStats,
                     boolean detailedStats,
                     boolean mutationStats)
                              throws IOException

Write the table rows.

Parameters:

queryStr - The query text (optional).

q - The IRunningQuery.

w - Where to write the rows.

maxBopLength - The maximum length to display from BOp.toString() and ZERO (0) to display everything. Data longer than this value will be accessible from a flyover, but not directly visible in the page.

clusterStats - When true, provides additional statistics that are specific to the scale-out cluster architecture.

detailedStats - When true, provides additional query statistics that are below the level of detail for most people.

mutationStats - When true, provides additional statistics about mutations (only report for inference rules at this time).

Throws:

IOException