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 report. Navigate to the Home page and select "Create new > Report" at the top right corner of the screen.

ardoq creating a report

Next:

  1. Select "Gremlin Search" in step 1 of the Report Builder.

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

  3. Write your Gremlin query.

ardoq gremlin report builder

Create Queries

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

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

Our result appears in step 4 of the Report Builder:

ardoq report builder

To save the Gremlin query, click on "Save" at the top right corner of the screen. Your query will be saved as a report and you can find it by filtering the Home page by "Reports".

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 saved queries or reports, navigate to the Home page and filter by "Reports".

ardoq manage queries

In addition to this, you can load saved queries in a Dashboard for a simpler view of more queries at once. To find the Dashboards, navigate 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 graph queries 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:

Ardoq queries dashboard example
Did this answer your question?