====Querying ARDI Data====

To make Grafana charts using ARDI data, you'll need to choose your ARDI data source when setting up a Grafana channel.

{{:grafana:grafchannelbasic.png?600|}}

A query is made up of several options....

===Type===

There are a few different //types// of request. 

^Type Name^Effect^
|[[Current Point|Current Point]]|Shows the current/live values of a single asset, no matter what time range is chosen|
|[[Point|Point]]|Shows the values of measurements from a single asset|
|[[Profile|Profile]]|Shows the values of measurements across many assets, following relationships|
|[[Table|Table]]|//Experimental// For table-based Grafana visualisations of properties|

For examples of these, see [[Query Types]].

===Context===

The ARDI context you want to query from. You may choose between any of the configured ARDI contexts. Defaults to **Actual**.

===Asset===

The asset you want to base your query off. When you start typing, it will offer suggestions as to which asset you want. You can search for assets by name, ERN, or any property - just like searching for assets in ARDI itself.

===Property===

The name of the property you want to graph. Note that this will only display properties that are valid for the chosen asset.

There are two additional properties here that only function for **Point** and **Current Point** queries - the //All Discrete// and //All Analog// properties show multiple properties sourced from the one asset.

===Primary Axis (Profile Only)===

//Note that this only appears in [[Profile|Profile]]-type charts//

This chooses the relationship you want to display along your horizontal axis. In non-profile channels, this is always **time**, but when working with profiles, you can instead use your relationships instead.

Let's say for example that you have six pumps on your site, numbered #1 to #6. You can create a relationship called 'Order' that goes between them from 1-6.

If you then choose **Order** for your X-axis, it will generate a chart where the time axis is instead replaced with the distance of each item along the relationship. So you would see a chart from Pump #1 to Pump #6.

===Secondary Axis===

This is only set for [[Profile|Profile]]-type charts.

For many Grafana charts, your Secondary Axis property will be **None**.

However, you can create powerful heat maps by setting the Secondary Axis value to either the name of a relationship. or //Time//, which will show the profile results over time.

===Examples===

[[Example Queries]] are available.