Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
7 changes: 7 additions & 0 deletions asciidoc/courses/aura-dashboards/ad.adoc
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
:page-ad-icon: mortarboard
:page-ad-title: Building Dashboards in Neo4j
:page-ad-description: Enroll for free to learn how to create interactive dashboards and visualize graph data in Neo4j using AI and Cypher.
:page-ad-link: https://graphacademy.neo4j.com/courses/aura-dashboards/?ref=docs-ad-aura-dashboards
:page-ad-underline-role: button
:page-ad-underline: Enroll now

29 changes: 18 additions & 11 deletions asciidoc/courses/aura-dashboards/course.adoc
Original file line number Diff line number Diff line change
@@ -1,30 +1,37 @@
= Building Dashboards in Neo4j Aura
= Building Dashboards in Neo4j
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Should this be Building Dashboards with Neo4j rather than in Neo4j?

:categories: administrator:1, beginners:5, foundation:1, aura:1
:status: draft
:duration: 2 hours
:caption: Learn about data visualisation in Neo4j Aura.
:key-points: Aura dashboards, exploratory data analysis, data import and visualization, exploring relationships in data.
:caption: Learn about data visualization using Neo4j Dashboards.
:key-points: Neo4j dashboards, exploratory data analysis, data import and visualization, exploring relationships in data.

In this course you will learn about Aura Dashboards, a feature for visualising and exploring graph data directly within the Aura environment.
You will learn how to access Aura Dashboards, import and visualize data, create interactive dashboards using AI and Cypher queries, and share dashboards with others.
In this course you will learn about Neo4j Dashboards, a feature for visualizing and exploring graph data directly within Neo4j.
You will learn how to access Dashboards, import and visualize data, create interactive dashboards using AI and Cypher queries, and share dashboards with others.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

maybe bullet point this list to make it easier to read


You will explore the Aura Dashboards interface, learn about different visualization options for data representation, and discover the built-in tools for data exploration and visualization.
You will explore the Dashboards interface, learn about different visualization options for data representation, and discover the built-in tools for data exploration and visualization.

This course will prepare you to visualize and understand the Neo4j databases in the cloud with confidence.
This course will prepare you to visualize and understand Neo4j databases with confidence. While the examples use Neo4j Aura for ease of access, the same features are available in Neo4j Enterprise Edition on-premises.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

... understand Neo4j databases with confidence? I'm not sure what that means

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Are all the same features available with Neo4j enterprise edition?


== Duration

{duration}

== Prerequisites

Before starting this course, you should have a basic understanding of graph databases and basic knowledge on Neo4j. If you are new to Neo4j, you can familiarize yourself with the database with the link:/courses/neo4j-fundamentals/[Neo4j Fundamentals course^], the link:/courses/aura-fundamentals/[Aura Fundamentals course^] and the link:/courses/cypher-fundamentals/[Cypher Fundamentals course^].
Before starting this course, you should have:

* A basic understanding of graph databases and Neo4j
* Access to a Neo4j database - either:
** Neo4j Aura (free tier available) - recommended for new users
** Neo4j Enterprise Edition on-premises with Dashboards enabled
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

maybe link out to the docs where they can find how to enable dashboards on enterprise


If you are new to Neo4j, you can familiarize yourself with the database using the link:/courses/neo4j-fundamentals/[Neo4j Fundamentals course^], the link:/courses/aura-fundamentals/[Aura Fundamentals course^] and the link:/courses/cypher-fundamentals/[Cypher Fundamentals course^].
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Maybe bullet point this and provide the course caption so people know what the courses are.

* link:/courses/neo4j-fundamentals/[Neo4j Fundamentals course^] - Learn about Graph databases and get started with Neo4j


== What you will learn

* How to create dashboards in Neo4j Aura
* Understand how to structure Cypher queries to visualize graph data to explore relationships between data points
* How to make dashboards interactive
* How to create dashboards in Neo4j
* How to structure Cypher queries to visualize graph data and explore relationships
* How to make dashboards interactive with filters and parameters
* How to share dashboards with others

[.includes]
Expand Down
Original file line number Diff line number Diff line change
@@ -1,26 +1,31 @@
= Understanding Aura Dashboards
= Understanding Neo4j Dashboards
:type: lesson
:order: 1

// TODO: Consider restructuring this lesson to focus only on what dashboards are and when to use them.
// Currently includes course overview (lines 7-21) and prerequisites (lines 28-46) that could be moved to course.adoc.
// This would make the lesson more focused and under 5 minutes to read.

== Understanding Data Visualization

Welcome to the Visualizing Graph Data using Aura Dashboards Fundamentals course on GraphAcademy!
Welcome to the Building Dashboards in Neo4j course on GraphAcademy!

Ever wondered how movie recommendation systems work, or how studios track which genres are trending?

Representing data in a visual format can help uncover patterns that might be missed otherwise.
Representing data in a visual format can help uncover patterns that might be missed otherwise.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

You could lose otherwise - "otherwise what?"

Suggested change
Representing data in a visual format can help uncover patterns that might be missed otherwise.
Representing data in a visual format can help uncover patterns that might be missed.


* That's the power of graph databases and data visualization!
Data visualization transforms your graph into actionable insights that anyone can understand.

// Throughout this course, you will learn how to get started with Neo4j Aura Dashboards.
// TODO: These are course objectives, not lesson objectives. Consider adding lesson-specific objectives like:
// "In this lesson, you will learn: What Neo4j Dashboards are, When to use dashboards, How dashboards fit into your workflow"

By the end of this course, you will be confident in:
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

[personal preference & minor point]
I would use a more positive set of statement, you will be able to, you will understand, etc.


* What are Aura Dashboards and when to use them.
* Accessing Aura Dashboards by importing our sample data.
* Creating interactive dashboards using our GenAI assistant and natural language.
* Building dashboard cards with Cypher queries.
* Adding filters to make dashboards dynamic.
* What Neo4j Dashboards are and when to use them
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think this needs rephrasing

"you will be confident in 'What Neo4j Dashboards are and when to use them'"

* Accessing Dashboards by importing sample data
* Creating interactive dashboards using the AI assistant and natural language
* Building dashboard cards with Cypher queries
* Adding filters to make dashboards dynamic

// Aura provides a fully managed Neo4j database service, that allows you to run multiple instances in the cloud, while handling the underlying infrastructure, maintenance, and operations.
// You can deploy Neo4j instances in the cloud and scale them as needed without the hassle of managing servers, backups, or updates.
Expand All @@ -31,51 +36,54 @@ By the end of this course, you will be confident in:

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Should what you need to into the course overview?

To follow along with this course, you will need:
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
To follow along with this course, you will need:
To complete this course, you will need:


* A Neo4j Aura account. If you don't have one, you can follow the step-by-step guide presented in the next lesson to create your account.
* Access to a Neo4j Aura instance.
* Basic understanding of Aura, graph databases, importing data (optional), data modeling, and Cypher query language (optional).
* Access to a Neo4j database with Dashboards enabled:
** **Neo4j Aura** (recommended for this course) - Free tier available. If you don't have an account, the next lesson will guide you through creating one.
** **Neo4j Enterprise Edition on-premises** - If you already have access to an on-premises installation with Dashboards enabled
* Basic understanding of graph databases (optional but helpful)
* Basic knowledge of Cypher query language (optional but helpful)

Also, if you are new to Neo4j, you can familiarize yourself with the database with the link:/courses/neo4j-fundamentals/[Neo4j Fundamentals course^].
If you are new to Neo4j, you can familiarize yourself with the database using the link:/courses/neo4j-fundamentals/[Neo4j Fundamentals course^].

It would be recommended to also check out:
Recommended additional courses:

* link:/courses/aura-fundamentals/[Aura Fundamentals^]
* link:/courses/aura-fundamentals/[Aura Fundamentals^] - If using Neo4j Aura
* link:/courses/modeling-fundamentals/[Data Modeling Fundamentals^]
* link:/courses/importing-fundamentals/[Importing Fundamentals^]
* link:/courses/cypher-fundamentals/[Cypher Fundamentals^]

== Introducing Neo4j Aura Dashboards
== Introducing Neo4j Dashboards

Neo4j Dashboards is a visualization tool available in both Neo4j Aura and Neo4j Enterprise Edition on-premises.

Aura provides a fully managed Neo4j database service, which means you don't have to worry about the underlying infrastructure, maintenance, or operations.
// You can deploy Neo4j instances in the cloud and scale them as needed without the hassle of managing servers, backups, or updates.
Dashboards let you create interactive visualizations to explore your graph data and share insights with others.

In addition to the fully managed DBaaS (Database as a Service), you can also draw powerful dashboards to obtain insights from your graph data.
// TODO: Add informal spoken phrase here, e.g., "Think of it as a window into your graph - it turns nodes and relationships into charts anyone can understand."


For example, if you are running a streaming service, you might want to track metrics such as ratings per country, genre, and actors to understand user engagement and preferences:
For example, if you are running a streaming service, you might want to track metrics such as ratings per country, genre, and actors to understand user engagement and preferences.

The picture below shows a sample dashboard that visualizes movie data from the popular movie graph dataset, sorted by decade, represented as a line chart:

The picture below shows a sample dashboard that visualizes movie data from the popular movie graph dataset, sorted by decade, represented as a line chart:
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think this can be simplified. Learners can see its an image, can it be described as popular?

Suggested change
The picture below shows a sample dashboard that visualizes movie data from the popular movie graph dataset, sorted by decade, represented as a line chart:
The sample dashboard below visualizes movie data from the movie graph dataset, sorted by decade, represented as a line chart:


image::images/movies-by-decade.png[Movies by Decade Dashboard,width=600,align=center]



To do this, you can use natural language to ask questions about your data, and Aura Dashboards will generate the necessary visualisations for you.
Writing Cypher queries is not required, although you can use them if you prefer.
To do this, you can use natural language to ask questions about your data, and Neo4j Dashboards will generate the necessary visualizations for you.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

To do this, You can use the Ask With AI feature to ask questions about your data and generate complete dashboard visualisations

Writing Cypher queries is not required, although you can use them if you prefer for more advanced customizations.



Use dashboards when you need:

* Visual representation of patterns and trends.
* Real-time data monitoring vs. static reports comparisons.
* Different stakeholders perspectives on the same data.
* Easy sharing of insights across teams.
* Interactive exploration of data without writing code.
* Visual representation of patterns and trends
* Real-time data monitoring vs. static reports comparisons
* Different stakeholders' perspectives on the same data
* Easy sharing of insights across teams
* Interactive exploration of data without writing code

You do not need to set up any additional infrastructure or tools, as Aura Dashboards are built on top of the Neo4j database service.
// TODO: Add concrete example from course context. E.g., "For example, in the movie dataset you'll work with,
// you might create a dashboard showing: top-rated films by decade (line chart), genre distribution (pie chart),
// and actor collaboration networks (graph visualization)."

You do not need to set up any additional infrastructure or tools, as Dashboards are integrated directly into Neo4j.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
You do not need to set up any additional infrastructure or tools, as Dashboards are integrated directly into Neo4j.
[NOTE]
.Simple setup
You do not need to set up any additional infrastructure or tools, as Dashboards are integrated directly into Neo4j.



In this course, you will learn how to build dashboards similar to the one below:
Expand All @@ -97,6 +105,7 @@ include::questions/1-purpose.adoc[leveloffset=+1]

[.summary]
== Summary
In this lesson, you learned what are the Neo4j Aura Dashboards and the benefits of using them for data visualisation and exploration.

In the next lesson, you will learn how to access Aura Dashboards, including creating an Aura account, selecting the appropriate tier, and navigating the Dashboards UI.
In this lesson, you learned what Neo4j Dashboards are and the benefits of using them for data visualization and exploration.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
In this lesson, you learned what Neo4j Dashboards are and the benefits of using them for data visualization and exploration.
In this lesson, you learned about Neo4j Dashboards and the benefits of using them for data visualization and exploration.


In the next lesson, you will learn how to access Dashboards. If you're using Neo4j Aura, you'll learn how to create an account and navigate the interface. If you're using on-premises Neo4j, you'll learn how to access the Dashboards feature.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggest moving the section out to a note so it is more prevalent.

Suggested change
In the next lesson, you will learn how to access Dashboards. If you're using Neo4j Aura, you'll learn how to create an account and navigate the interface. If you're using on-premises Neo4j, you'll learn how to access the Dashboards feature.
In the next lesson, you will learn how to access Dashboards.
[NOTE]
.Access
If you're using Neo4j Aura, you'll learn how to create an account and navigate the interface. If you're using on-premises Neo4j, you'll learn how to access the Dashboards feature.

Original file line number Diff line number Diff line change
@@ -1,11 +1,11 @@
[.question]
= Purpose of Aura Dashboards
= Purpose of Neo4j Dashboards

Which of the following statements best describes the purpose of Aura's integrated dashboard tool?
Which of the following statements best describes the purpose of Neo4j's integrated dashboard tool?
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

"integrated dashboard tool" is stated in the statement and the responses. It feels repetitive and difficult to read.

you could do this

Suggested change
Which of the following statements best describes the purpose of Neo4j's integrated dashboard tool?
Which of the following statements best describes the purpose of Neo4j dashboards?

or remove the "integrated dashboard tool" from the answers.


* [x] The integrated dashboard tool aims to provide a visual interface for exploring data insights directly within the Neo4j Aura environment without having to write Cypher queries.
* [x] The integrated dashboard tool provides a visual interface for exploring data insights directly within Neo4j without having to write Cypher queries.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Is this correct? You still have to write Cypher queries to get the most out of the dashboards.

* [ ] The integrated dashboard tool is designed for database administrators to manage user roles and permissions.
* [ ] The integrated dashboard tool is primarily used for importing large datasets into the Neo4j Aura database.
* [ ] The integrated dashboard tool is primarily used for importing large datasets into Neo4j.


[TIP,role=hint]
Expand All @@ -17,5 +17,7 @@ Think about the main goal of dashboards in data visualization and exploration.
[TIP,role=solution]
.Solution
====
The integrated dashboard tool aims to provide a visual interface for exploring data insights directly within the Neo4j Aura environment without having to write Cypher queries.
**The integrated dashboard tool provides a visual interface for exploring data insights directly within Neo4j without having to write Cypher queries.**

This is the primary purpose - dashboards help you visualize and explore data without needing to write Cypher queries, though you can use Cypher for more advanced visualizations if needed.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

simplify

Suggested change
This is the primary purpose - dashboards help you visualize and explore data without needing to write Cypher queries, though you can use Cypher for more advanced visualizations if needed.
Dashboards primary purpose is to help you visualize and explore data without needing to write Cypher queries, though you can use Cypher for more advanced visualizations if needed.

====
Original file line number Diff line number Diff line change
@@ -1,21 +1,29 @@
= Accessing Aura Dashboards
= Accessing Neo4j Dashboards
:type: lesson
:order: 2


== Lesson Overview
In the previous lesson, you learned about the purpose of Neo4j Aura Dashboards and the benefits of using them for data visualization.

In this lesson, you will learn how to access Aura Dashboards, including creating an Aura account, selecting the appropriate tier, and navigating the Dashboards UI.
In the previous lesson, you learned about the purpose of Neo4j Dashboards and the benefits of using them for data visualization.

In this lesson, you will learn how to access Dashboards. For ease of access in this course, we'll use Neo4j Aura. If you already have access to an on-premises Neo4j Enterprise Edition installation with Dashboards enabled, you can skip to **Step 4** and connect to your database.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I dont understand the "we'll use Aura" - we aren't using anything. The instructions work for both Aura and Enterprise Edition?

Suggested change
In this lesson, you will learn how to access Dashboards. For ease of access in this course, we'll use Neo4j Aura. If you already have access to an on-premises Neo4j Enterprise Edition installation with Dashboards enabled, you can skip to **Step 4** and connect to your database.
In this lesson, you will learn how to access Dashboards.
[NOTE]
.Setup Aura Instance
Instructions are provided to setup a Neo4j Aura instance.
If you already have access to an on-premises Neo4j Enterprise Edition installation with Dashboards enabled, you can skip to **Step 4** and connect to your database.



== Getting Access to Aura Dashboards
== Getting Access to Dashboards

To follow along with this course, you have two options:

To explore the Dashboards UI, you need an Aura account, and an instance to connect to.
* **Neo4j Aura** (recommended for this course) - Free tier available, quick setup
* **Neo4j Enterprise Edition on-premises** - If you already have access

Create an account and an instance by following these instructions:
The rest of this lesson focuses on setting up Neo4j Aura. If you're using on-premises, skip to **Step 4** to learn how to connect.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

If you're using a Self-Managed version of Neo4j


If you already have an Aura account and an instance, you can skip to **Step 4.**
[NOTE]
.Skip if you already have an account
====
If you already have a Neo4j Aura account and instance, you can skip to **Step 4.**
====

== Step 1: Visit the Neo4j Aura Website

Expand Down Expand Up @@ -51,54 +59,67 @@ image::images/4-sign-up-email.png[Sign up page prompting to create a password]
(Optional) Once you have an account, *create a new Aura instance* by selecting the desired tier (Free, Professional, Business Critical, or Virtual Dedicated Cloud) based on your requirements.


In this course, you will only need the **Free tier** to explore and learn about Aura Dashboards.
In this course, you will only need the **Free tier** to explore and learn about Neo4j Dashboards.

image::images/4-free-instance-select.png[Create Aura instance page showing the different tiers available]


== Dashboard allocation per tier
In Aura Dashboards, you have access to different types of layouts to visualize your graph data effectively. The main types of layouts available are:
In Aura Dashboards, you have access to different types of layouts to visualise your graph data effectively. The main types of layouts available are:
== Dashboard page limits

* Free tier: 3 dashboard pages available. If you have already created a free tier instance, you can access upgrade at any time to access more dashboards.
The number of dashboard pages you can create depends on your platform:
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We call these tiers, don't we?


image::images/free-tier-dashboards.png[Free tier dashboards,width=600,align=center]
**For Neo4j Aura users:**

* Professional, Enterprise and Visual Dedicated Cloud: 25 dashboard pages available.
* **Free tier:** 3 dashboard pages available. You can upgrade at any time to access more dashboards.

image::images/free-tier-dashboards.png[Free tier dashboards,width=600,align=center]

* **Professional, Business Critical, and Virtual Dedicated Cloud:** 25 dashboard pages available.

image::images/ee-dashboards.png[Enterprise tier dashboards,width=600,align=center]

**For on-premises Enterprise Edition users:**
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Self-Managed


* Dashboard page limits depend on your license agreement. Consult your Neo4j representative for details.

== Step 4: Connect to an instance

. *Log in* to your Aura instance, and go to the *Dashboards* menu. From there, you can create new dashboards, access existing ones, and manage your dashboard settings.
. *Connect to your instance* by selecting it from the list of available instances. You can either connect to an Aura instance, or to a local Neo4j database if you have one, by entering the connection details. For more information, see link:https://neo4j.com/docs/aura//connecting-applications/overview/[Connecting Applications documentation^].
. *Connect to your instance* by selecting it from the list of available instances. You can either connect to an Aura instance, or to a local Neo4j database if you have one, by entering the connection details. For more information, see link:https://neo4j.com/docs/aura/classic/auradb/connecting-applications/overview/[Connecting Applications documentation^].
== Step 4: Connect to Dashboards

=== For Neo4j Aura users:

. *Log in* to your Aura account and go to the *Dashboards* menu. From there, you can create new dashboards, access existing ones, and manage your dashboard settings.
. *Connect to your instance* by selecting it from the list of available instances.

image::images/dashboards-ui.png[Dashboards UI,width=600,align=center]

After you click on **Connect to instance**, you will be prompted to enter the connection details, for either Aura or a Self managed database. In this course, you will connect to your Aura instance for simplicity:
After you click on **Connect to instance**, you will be prompted to enter the connection details:

image::images/connect-from-dashboards.png[Connect to instance dialog,width=600,align=center]

You can find your Aura instance connection details by clicking the **...** menu next to your instance name and selecting **Inspect**, or by using the downloaded connection details file.

For more information, see link:https://neo4j.com/docs/aura/auradb/[AuraDB documentation^].

=== For on-premises users:

You can find the connection details of your Aura instance by clicking on the **...** menu next to your instance name, and selecting **Inspect**, or by using the downloaded connection details file.
. Access Dashboards through your Neo4j Enterprise Edition installation
. Navigate to the Dashboards interface
. Connect using your local database credentials

The Dashboards interface and features work identically in both Aura and on-premises installations.




[.quiz]
== Check your understanding

include::questions/1-choosing.adoc[leveloffset=+1]

include::questions/2-empty-dashboards-canvas.adoc[leveloffset=+1]


[.summary]
== Summary
In this lesson, you learned how to access Aura Dashboards, including creating an Aura account, selecting the appropriate tier, and navigating the Dashboards UI.

In the next lesson, you will learn how to load data into your Aura instance and generate a demo dashboard using AI.
In this lesson, you learned how to access Neo4j Dashboards. For Aura users, you learned how to create an account, select a tier, and navigate the interface. For on-premises users, you learned how to access Dashboards through your Enterprise Edition installation.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

"For on-premises users, you learned how to access Dashboards through your Enterprise Edition installation." - did they? The instructions aren't specific.

Suggested change
In this lesson, you learned how to access Neo4j Dashboards. For Aura users, you learned how to create an account, select a tier, and navigate the interface. For on-premises users, you learned how to access Dashboards through your Enterprise Edition installation.
In this lesson, you setup an Aura instance (if required), and accessed Neo4j Dashboards.


In the next lesson, you will learn how to load data into your Neo4j database and generate a demo dashboard using AI.
Loading