# Insight Analysis

<figure><img src="/files/zjRllK1DyyJj4KXhFuBY" alt=""><figcaption><p>Insights Analysis</p></figcaption></figure>

The [**Automated Insights**](/crystal-advisor/analyze-your-data/automated-insights.md) list is located on the Right Sidebar of the Advisor Workspace, and allows you to explore what happened in the data related to a specific Topic.

This information adds valuable insights, making it easier to understand answers to questions.

But this is not all: Crystal is able to dig even deeper!

You can **request an** **Insight Analysis** and get straight to the point of **why** and **how** the events described in the Automated Insight happened.

This in-depth exploration will help you understand your data better and make data-driven decisions **without losing sight of any piece of information**.

In particular, Insights Analysis is based on a Data Analysis technique called **Diagnostic Analytics**.

{% hint style="success" %} <mark style="color:green;">**Pills of Data Analysis**</mark>

Diagnostic Analytics are information that describe the **reasons** **why** an observed pattern or trend happened.

For example, they can describe **what went well**, **what went wrong**, and **what had the most significant influence**.
{% endhint %}

## Understand The Whys

This is how you can request and receive an Insight Analysis:

1. After asking a question, find the list of Automated Insights on the right-hand side.
2. You can see that *some* Insights include an "Analyze" option.

{% hint style="warning" %} <mark style="color:orange;">**Remember**</mark>

Right now, Insight Analysis can be requested for **all Topics** but it's only available for the **Top Contributor,** **Average and Variability** and **Extreme Value** Insights.
{% endhint %}

<figure><img src="/files/VTFHooJrkBsypsoeOAAq" alt="" width="359"><figcaption><p>Choose an Insight</p></figcaption></figure>

3. click on the “Analyze” icon for the Insight you're interested in.&#x20;
4. You will see a banner notifying you that the analysis has started, meaning Crystal is processing your analysis to uncover reasons behind the Insights.
5. This process may take several minutes, depending on the amount of data that needs to be processed.
6. You'll receive a notification once your analysis is complete.

<figure><img src="/files/dnqzTxjn6m2vpcstvbmX" alt="" width="329"><figcaption><p>Receive the Analysis</p></figcaption></figure>

7. Once you open the notification, you can access the result of the analysis in the intro message of the Topic.

<figure><img src="/files/pHp8a4mTrCyi91kjblr9" alt=""><figcaption><p>Read the Analysis</p></figcaption></figure>

## How Does It Work?

Once you pick an Insight, Crystal identifies the appropriate **Data Model** for analysis.

A Data Model is a consolidated view of data tailored for specific analytics. It is useful to find relationships between data.&#x20;

In this case, the Data Model is constructed by *linking the various data inputs* that led to the construction of the Topic. Crystal creates an *extended version* made by combining various data inputs used to create the original Topic.

Diagnostic Analytics will then use this extended Model, *excluding the columns not used in all the Topic Configurations within the specific project.*

This approach aims to highlight the **main Factors behind an Insight**, helping you understand the data better.

#### Rules

* Right now, Insight Analysis can be requested for **all Topics** but it's only available for the **Top Contributor,** **Average and Variability** and **Extreme Values** Insights.
* Insight Analysis is **only available on Insights generated from Configured Topics**, i.e. the ones that have been manually [created by the Admin](/crystal-console/topics-configuration.md), whereas[ auto-generated Topics](/crystal-advisor/talk-to-your-data/conversation/request-topics/entity-based-conversation.md) are not supported.
* To access the Diagnostic Analytics, you first need to access the Automated Insights
* The process of requesting and receiving an Analysis is **asynchronous:** the average waiting time is correlated to the **DB size.**
* For a small or medium-sized DB, you can expect a processing time of **around** **5 minutes.**
* You can request only **one Analysis at a time** for each Card that supports the Diagnostic Analytics.
* If you attempt to request an **analysis** that is already **in progress,** you will be informed that the analysis is still being processed and that you should wait for the dedicated notification.

#### Limitations

* You **can't receive the analysis** if the Topic from which the Insight was generated doesn't have a **real Extended Data Model** associated with it. This means that the original Joined Fact Table doesn’t contain any extra Entities other than the ones that are already available in the Topic.
* A Diagnostic Analysis **can’t be performed** if a Topic **only** has **categorical columns,** as could be the case for Lists and Descriptions. However, applicability may vary depending on the Topic's specific configuration.&#x20;
* A Diagnostic Analysis **can’t be performed** if a Topic has **at least one Custom Column.**
* If you don't have the **permissions** for certain underlying data, you will receive a **partial analysis** with that data hidden. The analysis will reveal information about the **Dynamic Filter Value** that drove the Insight, but inform you that more details aren't available due to **missing permissions.**
* There may be a **constraint** regarding the **number of rows** the Feature can handle, though it is estimated to be around hundreds of thousands, chosen from the most recent rows in the considered Data Model of the analyzed insight.

### Insight Analyses Catalog

The Diagnostic Analytics provide **different possible outcomes**, common to the Insights in focus.

In particular, Crystal can tell you:

<table><thead><tr><th width="73">N.</th><th>Insight Analysis</th></tr></thead><tbody><tr><td><strong>1</strong></td><td>Which <em>Entity</em> has <em>contributed the most</em> in achieving the result mentioned in the Insight (e.g. "Country").</td></tr><tr><td><strong>2</strong></td><td>Within the selected Entity, it can identify the one <em>specific Entity Value</em> that has <em>greatest impact</em> on the result mentioned in the Insight (e.g. "Italy").</td></tr><tr><td><strong>3</strong></td><td>H<em>ow</em> and <em>by how much</em> the result mentioned in the Insight would be <em>impacted if the Entity Value with greatest impact were to be excluded.</em></td></tr></tbody></table>

Keep analyzing your data!

***


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.igenius.ai/crystal-advisor/analyze-your-data/insight-analysis.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
