Documentation Index
Fetch the complete documentation index at: https://docs.cognite.com/llms.txt
Use this file to discover all available pages before exploring further.
Before you begin
Create a dashboard and add the Cognite Data Source for Grafana as a data source.
Create a variable from a query
Use the $variable or [[variable]] syntax to create templates.
Open variables settings
Navigate to your dashboard’s settings, and select Variables from the left-hand side.
Configure the data source
Set Type to Query, and select your Cognite Data Source as the Data source.
Enter the query
In the Query field, enter the query to fetch and filter assets from Cognite Data Fusion (CDF).For example, this query requests assets with the parameter parentIds=[123] and filters the results by name that matches the test-.* regular expression:assets{parentIds=[123], name=~"test-.*"}
For a list of valid parameters, see the API documentation.See Filter time series in custom queries to learn how to filter the results.You can format variables to fit into the query, for instance, if you have a multi-value variable like ts{assetIds=[${variable:csv}]}.If you select several assets from the dropdown, the variable is serialized to comma-separated values. Learn more about the variable format options in the Grafana documentation. Save the variable
Select Update.
Use data models in variables
Use GraphQL queries against data models to populate variable values from CDF.
Open the Data models tab
In the variable query editor, select the Data models tab.
Select the data model and version
Choose the data model and version you want to query.
Write the GraphQL query and select a field
Enter a GraphQL query and select the field to use as the variable values. The selected field should be a scalar value such as an external ID or name. The value field list is populated from your query once it is valid.
If your query returns nested structures, select the field from the list items you want to use as variable values. You can also use GraphQL variable interpolation to reference existing Grafana variables in your query.
Nested (chained) variables
With nested variables, you can create a template to visualize time series related to a branch of the asset subtree and let users navigate the subtree.
Create nested variables
Create the necessary nested variables. Use the variable as a filter
Use the variable as the asset filter on the dashboard.Users can choose assets on each level of the hierarchy. 
