HOW TO
- Access Custom Metrics and Metric Builder for Microsoft Azure
- Use the Metric Builder for Microsoft Azure
- Create a Custom Microsoft Azure Metric [Example]
- Add a Custom Microsoft Azure Metric to a Databoard
- Additional Information
How to access Custom Metric and Metric Builder for Microsoft Azure
Navigate to Metrics > Custom Metrics. Click the green + Create Custom Metric button and select your connected Microsoft Azure Data Source from the Data Source drop-down list.
- The ability to connect Microsoft Azure and access Metric Builder is available on the Professional and higher plans. Request a free trial of Microsoft Azure by following
How to use the Metric Builder for Microsoft Azure
A) Custom Metric Name: Enter a name for your Custom Metric. This Custom Metric name will be available in the Designer after saving.
B) SQL: Construct query strings to access data from your Database using Structured Query Language (SQL).
Learn more about SQL here.
C) Data Type: Selecting the appropriate Data Type ensures that your Custom Metrics will be synced correctly in Databox.
- Daily Values: This Data Type should be selected when your Metric reflects the most up-to-date Daily Value for the Metric. In Databox, the latest daily entry will be displayed for the Custom Metric.
- Total Values: This Data Type should be selected when your Metric reflects the current total Value for the Metric. In Databox, the latest entry will be displayed for the Custom Metric.
For longer Date Ranges, data will be not aggregated and the most recent Value will be displayed for the selected Date Range. This is the main difference between "Total Values" and "Daily Values." - Event Values: This Data Type should be selected when your Metric Value selection reflects individual Value(s) for the Metric at the specified Date/ Timestamp. This Data Type is the default selection because it is appropriate for the majority of use cases.
For longer Date Ranges, individual Metric Values will be aggregated for the entire Date Range and the aggregated Value will be displayed for the Custom Metric.
How to create a Custom Microsoft Azure Metric [Example]
The Metric Builder for Microsoft Azure is designed, so you can directly enter SQL queries. For our example, we will create a Custom Metric that returns a list of Product Names and their associated Order Quantities.
- Navigate to Metrics > Custom Metrics
- Click the green + Create Custom Metric button
- Select the appropriate Microsoft Azure Data Source
- In order to accurately explain what this Custom Metric is reporting on, we'll name the Custom Metric "Customers by Balance"
- In the SQL field, we will enter the query below. A semicolon at the end of the query is not necessary
SELECT TOP 20 p.ModifiedDate AS date, p.Name, sd.OrderQty
FROM SalesLT.SalesOrderDetail sd
INNER JOIN SalesLT.Product p ON sd.ProductID = p.ProductID
ORDER BY sd.OrderQty DESC
6. We will select Total Values as the Data Type. This selection is based on the way data is stored and updated in our database
7. Click Preview data to generate a Data Preview of the Custom Metric
If you don’t see any data, double-check your SQL query and try it directly in your Database. If no results are displayed there, an error exists in your query. You should also check to confirm that the Snowflake user has the necessary permissions to access the Database from Databox's public IP.
8. Once we confirm that these are the results we're looking for, we'll click Save to save the Custom Metric
How to add a Custom Microsoft Azure Metric to a Databoard
Learn how to add a Custom Metric to a Databoard here.
Additional Information
- Query results are limited to 10 MB. If more than 10 MB of data is returned in a response to a query, an error message will be displayed in Databox. Please edit your query to successfully sync the data.
- The query must contain a column named "Date." If you need to, use AS in your SELECT statement to satisfy this requirement
- One column should always contain the Metric Value
- "Null" values will not be recognized. Use a COALESCE function when needed. Learn more here.