Sections in this category

03/10 Navigate the Graph

  • Updated

JupiterOne is built on a data-driven graph platform. For the story that inspired us to build it, check out this blog.

JupiterOne query language (J1QL) is designed to traverse this graph and return a sub-graph -- or data from the nodes (i.e. entities) and edges (i.e. relationships) of a sub-graph. You can view and interact with the sub-graph from any J1QL query result.

This guide focuses on interacting with the graph component. For more details on J1QL, check out the J1QL tutorial and technical doc.

This screenshot below shows an example result graph from a query in the Landing app:

The first set of controls on the upper right corner does the following:

Control Function
Switch views between Table, Graph, Raw JSON, and Pretty JSON.
Share the query – shows a modal popup with the weblink to copy and share.
Save the query – shows a modal popup where you can provide a title, description, and optionally some tags to save it to your own query library.
Remove the result for this particular query/question from the page view.

Selecting any node (i.e. entity) on the graph will bring up a set of controls right on top of it that allows you to interact with the node. They serve the following functions:

Control Function
Open side panel to show the detailed properties, tags and metadata of the selected entity.
Note that you can select an edge and see its properties in the side panel as well.
Load neighbors – bring in additional nodes directly connected to the selected node that are not yet loaded into the graph.
Hide selected node from graph to reduce clutter. You can unhide all hidden nodes from the bottom left control.
Expand grouped nodes of the same type that have the same parent nodes. This option may not be always available depending on the data in the graph.
Collapse nodes of the same type that have the same parent nodes into a group. This option may not be always available depending on the data in the graph.

The last set of controls are at the bottom left corner of the graph, and they do the following:

Control Function
Maximize graph in full screen mode.
Restore graph in query result component.
Open filter panel to let you filter (show/hide) nodes on the graph by Account and/or Type.
Unhide hidden nodes. This control icon will only show up when there are hidden nodes on the graph.

Here's a screenshot of a graph with the property panel and filter panel open:

Zoom and Move

Control Function
Scroll using your mouse/touchpad to zoom in/out on the graph
Click and Drag on a blank spot on the graph using your mouse/touchpad to move the graph. Click and Drag on a selected node to move that particular node.

The stand-alone Galaxy / Graph Viewer app uses the same sets of controls.

That's it! Now go explore! Check out the J1QL tutorial if you haven't yet.


Was this article helpful?

0 out of 0 found this helpful