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.
Next:
Select "Gremlin Search" in step 1 of the Report Builder.
Choose the workspace(s) you wish to query.
Write your Gremlin query.
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:
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".
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".
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: