Add page about Query Log Analyzer (#393)

Co-authored-by: David Johansson <[email protected]>
Co-authored-by: David Johansson <[email protected]>

modules/ROOT/content-nav.adoc

@@ -20,6 +20,7 @@ Generic Start
 * Logging
 ** xref:platform/logging/download-logs.adoc[]
 ** xref:platform/logging/log-forwarding.adoc[]
+// ** xref:platform/logging/query-log-analyzer.adoc[]
 
 * Neo4j connectors
 ** xref:platform/connectors/spark.adoc[]

modules/ROOT/pages/platform/logging/query-log-analyzer.adoc

@@ -0,0 +1,103 @@
+[[aura-monitoring]]
+= Query log analyzer
+
+label:AuraDB-Professional[]
+label:AuraDB-Enterprise[]
+
+Query log analyzer is a feature that provides a UI to review the queries executed on an Aura instance.
+
+To access *Query log analyzer*:
+
+. Navigate to the https://console.neo4j.io/?product=aura-db[Neo4j Aura Console] in your browser.
+. Select the instance you want to access.
+. Select the *Logs* tab.
+. Select the *Query log analyzer* button.
+
+Query log analyzer is split up in three parts:
+
+* *Query timeline* - Timeline showing metrics for number of queries, failed queries and query latency.
+* *Summary table* - An aggregated view of query logs, giving a high level overview over the selected time period.
+* *Details table* - A detailed view showing individual query executions in the selected time period. 
+
+To fetch logs, first choose a time range in the Query timeline. 
+With a time selection done, press the *Fetch logs* button. 
+You may optionally choose any filters or search text if required, then press *Go*.
+
+A summary of query executions is returned, showing aggregations per query.
+To see the individual query executions, click the right arrow at the end of the line to show details for that query.
+The details pane shows individual executions.
+
+== Timeline interactions
+
+When viewing the query timeline, you can select from the following time intervals:
+
+* 30 minutes
+* Last hour
+* Last 2 hours
+* Last 6 hours
+* Last 24 hours
+* Last 3 days
+* Last week
+
+The query timeline can be collapsed by clicking on the header. 
+
+=== Zoom
+
+To zoom in to a narrower time interval, select and drag inside the timeline to select your desired time interval.
+The data in the timeline will automatically update to match the increased resolution.
+To update the table, click the *Fetch logs* button.
+
+To reset zoom, double-click anywhere inside the timeline.
+
+=== Toggle data series
+
+To hide or show individual data series, select the corresponding data series in the legend below the timeline.
+
+
+== Fetch logs
+
+The *Fetch logs* button will open up a dialog where you can add filters and search before fetching the logs.
+The Query timeline determines the current time selection, which can be changed by closing the dialog and modifing the timeline. 
+To fetch the logs after selection of filters and search is done, click the *Go* button.
+
+=== Filters
+
+To filter, click the filter button.
+This will load the available filters over the selected time period. 
+Filters are available for the following fields:
+
+* Status
+* User
+* Driver
+* Application
+* Initiation type
+
+=== Search
+
+To search, click the search button. 
+Search can be specified for the *Query text* and the *Error text*.
+The fields are case insensitive and allows you to find specific queries or error that are interesting.  
+
+
+== Table interactions
+
+=== Sort table
+
+By default the table will be sorted on *Count* for *Summary* and *Status* for *Details*.
+To sort by a column (such as Max Time ms) click on the column heading.
+
+=== Modify columns
+
+The columns in the table can be modified by clicking the button to the right of the column row.
+Columns can be enabled or disabled, or the order changed using the grid icon at the top right of the table.
+
+=== Expand query
+
+In the table three rows of query text will be shown. 
+To see the whole query if the query is longer, press the *View more* button under the query text.
+
+== Limitations
+
+* Query logs are available for a period of 7 days, and each request can be for up to 24 hours of data.
+* The query timeline may show activity from internal meta queries, which are filtered in the table.  
+