Getting started with dashboards

Set up a working example of Neo4j dashboards.

Prerequisites

You need:

  1. A Neo4j Aura account

  2. A Neo4j Aura database instance

See Create an account and Create an instance for details.

Add a sample data set

Import the Northwind dataset to your instance:

  • In Aura, find the Learn button at the top right.

  • In the Beginner page, select the Learn the basics guide.

  • When prompted to Connect to instance, select the instance where you would like to import sample data.

  • In step 4 of 11 of the guide, import via Get the Northwind dataset.

  • Run the import from the Import page via Run import.

The examples on this page refer to the Northwind dataset.

Create a dashboard

Create a new dashboard:

  1. In the Dashboards page, create a new dashboard with Create dashboard at the top right.

  2. If prompted to Connect to instance, select your instance.

  3. The UI takes you directly to the new dashboard. To change the title, select the title text and edit it, then confirm.

  4. Your dashboard has a single page titled "Main page". To change the name, hover it and then use the three dots icon and Edit page name.

  5. Use Add card to create cards which represent visualizations.

Add a card with a bar chart

Create a bar chart which displays the number of orders per customer.

In the dashboard page tab:

  1. Use Add card at the bottom right of the page.

  2. Optionally change the title of the card by clicking and editing, then confirm.

  3. In the new card, use the three dots icon at the top right, then select Bar chart as the Chart type.

  4. Edit the Cypher query of the card and paste the following Cypher query to the input field, then Save:

    MATCH (c:Customer)-[:PURCHASED]->(o:Order)
    RETURN c.contactName AS Customer, count(o) AS Orders
    ORDER BY Orders DESC LIMIT 10

Your bar chart should look like this:

visualization bar chart
Figure 1. Example bar chart

Add a card with a line chart

Create a line chart which displays the number of products for each order ID.

In the dashboard page tab:

  1. Use Add card at the bottom right of the page.

  2. Optionally change the title of the card by clicking and editing, then confirm.

  3. In the new card, use the three dots icon at the top right, then select Line chart as the Chart type.

  4. Edit the Cypher query of the card and paste the following Cypher query to the input field, then Save:

    MATCH (o:Order)-[:ORDERS]->(p:Product)
    RETURN datetime(replace(o.orderDate, " ", "T")) AS Date,
           count(p) as Categories
    LIMIT 20

Your line chart should look like this:

visualization line chart
Figure 2. Example line chart

Next steps

See Managing dashboards for more dashboard options.

See Visualizations to learn about the different charts and visualizations of Neo4j dashboards.