Gremlin Graph Search

Graph Search is a powerful way of analyzing your data and building up an Enterprise Intelligence Graph.

Kristine Marhilevica avatar
Written by Kristine Marhilevica
Updated over a week ago

When you are putting data into Ardoq you are essentially building up an Enterprise Intelligence Graph. This provides an always up-to-date Digital Twin of all data, processes, and their relationships, meaning you can ask the system about all parts of your documentation.

We use the graph traversal language Gremlin (external article) to write queries in Ardoq. This helps you navigate the vertices and edges of your Enterprise Intelligence Graph.

Tip: Use our selection of common queries as inspiration to build your own based on your data sets.

You can query your data by:

  • Creating a quick Gremlin search from the Analytics menu > Gremlin Graph Search. To save your query you will need to save it as a report.

  • Creating a Gremlin Graph Search report. To create a report, navigate to the Home page and select "Create new > Report" at the top right corner of the screen or navigate to the Analytics menu > Report Overview > Create new.

ardoq creating a report


  1. Select "Gremlin Graph Search" in the "Data selection" section of the Report Builder.

  2. Choose the workspace(s) you wish to query.

  3. Write your Gremlin query.

Create Queries

In the example below, we are asking what applications are affected if a certain server is crashing:

has("name", "mongodb-1").
both(). hasLabel('Application').

You can see the results in the "Preview search results" modal or in the "Data presentation" section of the Report Builder:

Save your report to save your query. You can then find it by filtering the Home page by "Reports" or in the "Reports overview" page.

Note that this can be a bit confusing if you are new to Gremlin, so please don't hesitate to reach out for more information and help with queries.

Manage Queries

To manage your reports, navigate to the Analytics menu > Report overview. Alternative, head to the Home page and filter by "Reports".

ardoq manage queries

In addition to this, you can load reports in a Dashboard for a simpler view of more reports at once. To find the Dashboards, navigate to the Analytics menu > Dashboard overview or to the Home page and filter by "Dashboards".

ardoq dashboards

Click edit dashboard or create a new one from the Home page > Create new > Dashboard, and add the reports you want to display. For now, you can choose between showing the number of results over time or the total number of results. Click on View details to see more:

Note: Only an admin user can create a gremlin query

Did this answer your question?