Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add page about Query Log Analyzer #382

Closed
wants to merge 11 commits into from
5 changes: 4 additions & 1 deletion modules/ROOT/content-nav.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -15,9 +15,12 @@ Generic Start

* xref:platform/user-management.adoc[]
* xref:platform/apoc.adoc[]
* xref:platform/logging.adoc[Logging]
* xref:platform/metrics-integration.adoc[Metrics Integration]

* Logging
** xref:platform/logging/download-logs.adoc[]
** xref:platform/logging/query-log-analyzer.adoc[]

* Neo4j connectors
** xref:platform/connectors/spark.adoc[]
** xref:platform/connectors/kafka.adoc[]
Expand Down
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
[[aura-query-logs]]
= Logs
= Request and download logs

Aura allows you to request and download security and query logs.

Expand Down
74 changes: 74 additions & 0 deletions modules/ROOT/pages/platform/logging/query-log-analyzer.adoc
Original file line number Diff line number Diff line change
@@ -0,0 +1,74 @@
[[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 two parts, a timeline and a table with two tabs:

* *Query timeline* - Timeline showing metrics for number of queries, failed queries and query latency.
* *Summary* - An aggregated view of query logs, giving a high level overview over the selected time period.
* *Details* - 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.

== Chart interactions
DavidJsson marked this conversation as resolved.
Show resolved Hide resolved

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

=== 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.

== 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.

Loading