ThirdEye Data Requirements

​

Data readiness and validation checklist

• Timestamp needs to be in epoch millis for ThirdEye to work efficiently. If there is a non-epoch millis column then convert it to epoch millis using the “derived column” and apply time range indexes based on time granularity used in ThirdEye (Daily, hourly, 15 mins, 1 min).
• Cannot have data gaps Link to completeness delay, definition, Link to external blog how to do DQ check using ThirdEye
• Based on Query patterns from ThirdEye to Pinot - apply those specific indexing.
• Joins are not supported in ThirdEye. Make sure derived columns pre-ingestion are created for those to support TE use cases.
• ThirdEye needs a denormalized schema for the following reasons:
  • TE can run any SQL query Pinot can support for just running alerts. We can do this with a custom template. Link to ThirdEye templates. One can clone this to create a custom template and update the dag in it (query against Pinot). However, all the templates need to be cloned to add this custom query)
  • The complexity is more on: how the metric is then defined, how people can choose different detection algorithms on it, how it is exposed in the UI, how that is shared in RCA, notifications, etc., alerts might work, but the entire experience is not great. RCA may break. If RCA top contributors, heatmap needs to provide accurate insights at a quicker speed then transformed data will be ideal.
• If there are too many dimensions in the table how to make RCA more performant? Ans: Number of dimensions in a schema - indexes on dimensions (too many dimensions will slow down RCA UI) - rcaExcludedDimensions Link to the doc

​

Timestamp

• One column, with type of ‘DateTime’
• When this column isn’t set, the timestamp is automatically set as the start time of each ingestion period
• A format that Pinot can use, see DateTime strings in Pinot for more information.

​

Metric

• One or more columns containing numeric or categorical values in the data feed. For each data feed, you can specify multiple metrics, but you must select at least one column as metrics.
• Directly configured during alert configuration and need not be a column in the dataset, such as events streams on which you can use count metric.

​

Dimension

• A combination of different values identifies a particular single-dimension time series, for example: country, language, tenant.
• You can select zero or more columns as dimensions.
• The dimension columns can be of any data type.

​

Further considerations

• Get event
• Write event
• Query historic events (requires at least 30 days’ worth of data)
• Run anomaly detector

• When data granularity is very high, you have more data, but it will become noisy
• As your data granularity goes down, it becomes tough to detect anomalies
• Pay attention to consistency, use the same granularity across data so you don’t have one source being recorded with a granularity of 1 minute and another with a granularity of 5 minutes.

​

Examples

​

Revenue metrics

• Metric is Revenue
• Dimensions are Category and Market
• Timeseries pattern is daily

​

Application errors

• Metric is Error count
• Dimensions are Application component and Region
• Timeseries pattern is Daily