# Analytics

{% hint style="info" %}
Please contact your First Resonance Customer Success partner or email <support@firstresonance.io> for details on activating ION Analytics.
{% endhint %}

{% hint style="info" %}
If your team already has Analytics enabled, but you see a blank white screen, you are missing the GenerateReadAnalyticsCredential permission. First Resonance is not able to update this on our end. Ask your team to enable it for you!
{% endhint %}

{% hint style="info" %}
In order to create new analytics dashboards or modify existing dashboards, you will also need the GenerateWriteAnalytics Credential permission. First Resonance is not able to update this on our end. Ask your team to enable it for you!
{% endhint %}

ION Analytics provides users access to their data, custom reporting, and out-of-the-box dashboards from directly within ION, no set-up needed!

{% embed url="<https://www.loom.com/share/f081dd0050c540e79317f790e734b168?sid=f8d976d3-e568-432b-9bae-fd2e68845e86>" %}
**ION Analytics Overview Video**
{% endembed %}

## Key Features

* [Access pre-built Standard Dashboards](#standard-dashboards)
* [Build and share Custom Dashboards within your organization](#build-and-share-custom-dashboards)
* [Manage read/write permissions to Analytics from within ION](#manage-permissions-within-ion)
* [Drill-down to underlying data and Export any element](#explore-and-export-data)
* [Scheduled Exports/Notifications](#scheduled-exports-notifications)

## ION Analytics Tool Set

#### Data Connector

For deep insights and ultimate flexibility, First Resonance offers a [Data Connector](https://manual.firstresonance.io/ion-analytics/data-connector) that can be integrated with any analytics tool of your choice. This unlocks the ability to write custom SQL, combine ION data with external datasets, and conduct advanced analyses with support from your business analysts, software, or manufacturing teams. With direct access to a replica of your data, you can drive the insights needed to accelerate your manufacturing operations.

#### In App Analytics

ION Analytics within the app provides access to customer data but comes with some limitations. It’s designed for simple dashboards with limited joins and does not support custom SQL queries. As such, it's best suited for answering straightforward questions and consuming curated [data products](https://manual.firstresonance.io/ion-analytics/data-products) from First Resonance. These products offer aggregated, persona-based datasets tailored to common use cases. Keep these intended use cases in mind when working within the in-app analytics platform.

## Quick Start Guide - In App Analytics

1. Navigate to ION Analytics via the "Analytics" side-bar item

   <figure><img src="https://3615148728-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LkRqYp6lJhwxjYdzYG8%2Fuploads%2FVR3uwmSO6rU7ZcgtFBji%2Fimage.png?alt=media&#x26;token=80d516e4-9d2c-4868-85ec-4421b27dd464" alt=""><figcaption></figcaption></figure>
2. Once within Analytics you'll be able to use the folder icon in the bottom left of the screen to navigate to other dashboards
   * **ION Analytics** - where all [Standard Dashboards](#standard-dashboards) are accessed
   * **First Resonance** - workspace w/ your organization name. This is where you will be able to [build and share dashboards](#build-and-share-custom-dashboards) within your organization&#x20;

     <figure><img src="https://3615148728-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LkRqYp6lJhwxjYdzYG8%2Fuploads%2F6rFFuFlmC7wupYYqDG3V%2Fimage.png?alt=media&#x26;token=de0393d6-66f3-47e2-9599-6a4e32fc00ce" alt=""><figcaption></figcaption></figure>
3. Explore any of the existing dashboards to better understand what's going on in your factory.
   * Utilize filters to get down to the data relevant to you

     <figure><img src="https://3615148728-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LkRqYp6lJhwxjYdzYG8%2Fuploads%2F7YNltSsuFnU4Tmaax83T%2Fimage.png?alt=media&#x26;token=390d3aec-d00b-4d82-a929-3947b7192e88" alt=""><figcaption><p>Filters options are dynamic based on other filter choices</p></figcaption></figure>
   * Export data (CSV, Excel, PNG, etc.)

     <figure><img src="https://3615148728-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LkRqYp6lJhwxjYdzYG8%2Fuploads%2FtSB5v4Kjm9Pn357Ndff5%2Fimage.png?alt=media&#x26;token=31410e03-692b-4ed1-bb93-42c6172d2f81" alt=""><figcaption><p>Click the "..." in the top right of the element</p></figcaption></figure>
   * Export entire dashboard as PDF

     <figure><img src="https://3615148728-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LkRqYp6lJhwxjYdzYG8%2Fuploads%2FUY12npoYKDWqN2TbJ3ic%2Fimage.png?alt=media&#x26;token=07283f30-c9aa-4cd8-bdae-6e6d497fcb52" alt=""><figcaption><p>Click the down arrow to the right of the name of the tab</p></figcaption></figure>
   * Customize a dashboard to meet your needs
     * Select the "Save As" button in the bottom right corner

       <figure><img src="https://3615148728-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LkRqYp6lJhwxjYdzYG8%2Fuploads%2FKp81grnkvGHujHIlxnwu%2Fimage.png?alt=media&#x26;token=957134dc-cba2-4a0f-a10c-c7da71e545b0" alt=""><figcaption><p>Name the new copy, choose a destination folder and click "Save"</p></figcaption></figure>
     * Now select "Edit" in the bottom right corner and select the element you want to edit

       <figure><img src="https://3615148728-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LkRqYp6lJhwxjYdzYG8%2Fuploads%2Fs5yrwzvQacAG2fcKyLgp%2Fimage.png?alt=media&#x26;token=e0794fda-8aa1-4ed5-b6ba-e1bead80dbc2" alt=""><figcaption><p>Once you are done editing select "Publish" to share </p></figcaption></figure>

## Standard Dashboards

With ION Analytics you will have access to a set of dashboards already built and ready for use within your organization! Over time these will continue to grow with input and feedback from our users.

All standard dashboards are available within the **ION Analytics** workspace.

<figure><img src="https://3615148728-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LkRqYp6lJhwxjYdzYG8%2Fuploads%2FtMfB38dvog1aWFawTTZu%2Fimage.png?alt=media&#x26;token=499431e7-ed5c-4dbf-9eef-ccee80d22970" alt=""><figcaption><p>Use the folder icon in the bottom left of the screen to navigate to other dashboards</p></figcaption></figure>

Below are the current standard dashboard offerings within the platform:

* **Production Reports -** Overview of run, procedure, and team performance to better understand your production floor&#x20;
* **Run Field Data -** Explore data inputs from your execution of procedures across runs, analyze, and understand outliers and trends.
* **Issues Overview -** Understand a holistic view of your issue landscape. Identify problem parts/processes to help burn-down issues and improve quality and output of your production.

{% embed url="<https://www.loom.com/share/23ff25d34adf46a5b1b101b35d46ad38?sid=1a526cbb-2544-4763-ab3b-ed166a6f8654>" %}
Issues Overview
{% endembed %}

* **Part Details -** See everything that you care about for a part or specific part inventory to understand current state of that it along with cost data.
  * **Inventory Level Tracking -** Manage and monitor inventory levels to better understand when to reorder

{% embed url="<https://www.loom.com/share/10bdd0a6f9e14ecd8475ff1a5cfae428?sid=ffdc60d7-dec8-4d7b-bd75-d15460ca0520>" %}
Invenotry Level Tracking
{% endembed %}

* **Supplier Dashboard -** Check your supplier health and their performance against open orders.
* **Costed mBOM -** Input a parent assembly to get multi-level mBOM with material cost for the assembly

{% embed url="<https://www.loom.com/share/82f4c861f8c74c6cb3ea2be87e1bbd8e?sid=6b9b8c98-f2a9-4367-a1d4-6afdd530d82f>" %}
Costed mBOM
{% endembed %}

* **Costed aBOM -** Input a parent Part, Rev and SN to get a full multi-level aBOM including Material and Hours worked to give a holistic view of ACTUAL assembly cost

## Build and Share Custom Dashboards

In addition to the standard dashboards provided, ION Analytics provides a platform to modify existing dashboards to your unique needs as well as build completely new dashboards to help drive your organization forward.

There are a couple different ways to customize and build within ION Analytics. Please reference [this documentation](https://help.sigmacomputing.com/docs/workbooks-overview) on how to build out dashboards and visualizations.

Here is an excellent quick start guide for how to work within the ION Analytics environment provided by our embedded partner.\
<https://quickstarts.sigmacomputing.com/?cat=fundamentals>

* **Customize and build on top of a standard dashboard** - if there is a dashboard that you want to customize for your needs you can simply make a copy an edit using the following steps:
  1. Select the "Save As" button in the bottom right corner

     <figure><img src="https://3615148728-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LkRqYp6lJhwxjYdzYG8%2Fuploads%2FKp81grnkvGHujHIlxnwu%2Fimage.png?alt=media&#x26;token=957134dc-cba2-4a0f-a10c-c7da71e545b0" alt=""><figcaption><p>"My Documents" folder won't be viewable to other users. but you can move to another folder once ready</p></figcaption></figure>
  2. Name the new copy, choose a destination folder and click "Save"
  3. Now select "Edit" in the bottom right corner and select the element you want to edit

     <figure><img src="https://3615148728-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LkRqYp6lJhwxjYdzYG8%2Fuploads%2Fs5yrwzvQacAG2fcKyLgp%2Fimage.png?alt=media&#x26;token=e0794fda-8aa1-4ed5-b6ba-e1bead80dbc2" alt=""><figcaption><p>The panel on the left can be used to make changes/updates to the element</p></figcaption></figure>
  4. Once you are done editing select "Publish" to share
* **Build a new dashboard from "scratch"** - to do this you will actually just follow the above steps but copy from the "Blank Template" within the "ION Analytics" folder

## Manage permissions within ION

User permissions to ION Analytics can be managed like any other permission within ION.

* **GenerateReadEmbeddedAnalytics** - ability to view existing dashboards and interact with filters, exports, etc.
* **GenerateWriteEmbeddedAnalytics** - ability to to edit and create new dashboards/visualizations in addition to the read access above

<figure><img src="https://3615148728-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LkRqYp6lJhwxjYdzYG8%2Fuploads%2FY0fu794dGYzu9FlJp2py%2Fimage.png?alt=media&#x26;token=b9a319b5-e4d5-4fc8-9d32-628f3087e638" alt=""><figcaption><p>Navigate to: Settings -> Members -> Roles</p></figcaption></figure>

## Explore and Export data

Data exploration and exports are built in and can be done from any element within a dashboard or for an entire dashboard.

#### Data/Element Exports

<figure><img src="https://3615148728-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LkRqYp6lJhwxjYdzYG8%2Fuploads%2FikkAKSObaISrKGv2CRtW%2Fimage.png?alt=media&#x26;token=cce08fe3-dab2-47af-affb-94c8230d9265" alt=""><figcaption><p>Select the "..." in the top right of any element</p></figcaption></figure>

<figure><img src="https://3615148728-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LkRqYp6lJhwxjYdzYG8%2Fuploads%2FsY12g6PtwCcfwFuzU4TB%2Fimage.png?alt=media&#x26;token=12511fc3-28cd-4956-b780-cbd758736f14" alt=""><figcaption><p>Select the format of the data you are wanting to export from the "Download" menu</p></figcaption></figure>

#### Export of entire Dashboard to PDF

<figure><img src="https://3615148728-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LkRqYp6lJhwxjYdzYG8%2Fuploads%2FpDWO2nrMVMFTrc5sxbAz%2Fimage.png?alt=media&#x26;token=9701c585-5448-4141-ae31-8634e7f7d4f5" alt=""><figcaption><p>Select the arrow next to the tab that you want to export then choose the orientation</p></figcaption></figure>

#### Maximize element to see in more detail

<figure><img src="https://3615148728-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LkRqYp6lJhwxjYdzYG8%2Fuploads%2FSIbe3kHCEuorBQK55nJF%2Fimage.png?alt=media&#x26;token=7b075481-4899-49b4-bd7b-723c217a7878" alt=""><figcaption><p>Click "Maximize" in the top right of the element</p></figcaption></figure>

<figure><img src="https://3615148728-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LkRqYp6lJhwxjYdzYG8%2Fuploads%2FmtjVnOBSX4M25qlFqSPX%2Fimage.png?alt=media&#x26;token=cb23ac0a-3c96-4c8d-8bdc-646c97481251" alt=""><figcaption></figcaption></figure>

## Scheduled Exports/Notifications

Users can set up scheduled exports to be emailed to themselves and/or other members of their organization by following the steps below:

1. **Select "Schedule Export" from the folder menu on the bottom left**

   <div align="center"><figure><img src="https://3615148728-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LkRqYp6lJhwxjYdzYG8%2Fuploads%2FeyFvsTJUOShI1o9OyqGe%2Fimage.png?alt=media&#x26;token=25b55211-dd72-4b90-b7b6-74b73490b467" alt=""><figcaption><p>Select "Scheduled Export" from the folder menu</p></figcaption></figure></div>
2. **Select "Add Schedule"**

   <figure><img src="https://3615148728-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LkRqYp6lJhwxjYdzYG8%2Fuploads%2Fo3IczKpXudSS3pkebKRe%2Fimage.png?alt=media&#x26;token=b9eea9a4-72df-474d-944e-869c1370d548" alt=""><figcaption><p>Select "Add Schedule" or Edit an Existing Schedule</p></figcaption></figure>
3. **Fill out the Schedule details**

   <figure><img src="https://3615148728-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LkRqYp6lJhwxjYdzYG8%2Fuploads%2FgBuUGDnpvAAHrcywrx2C%2Fimage.png?alt=media&#x26;token=ca2215c5-4547-41d4-85b1-aede5b485f7d" alt=""><figcaption><p>Destination: Email is the only option currently available</p></figcaption></figure>
4. **Add Attachments:** Exports can include attachments in the different formats and you can have multiple attachments per export.

   <figure><img src="https://3615148728-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LkRqYp6lJhwxjYdzYG8%2Fuploads%2Fcyje2Pe05FWvbNzYkNW6%2Fimage.png?alt=media&#x26;token=53508df8-535d-472f-bd3d-b55c3b108609" alt=""><figcaption></figcaption></figure>
5. **Determine Schedule**

   <figure><img src="https://3615148728-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LkRqYp6lJhwxjYdzYG8%2Fuploads%2FT5Md20Qp0yPEzZeF6Yn1%2Fimage.png?alt=media&#x26;token=a6faefea-ec44-4967-a252-1d8c4c14a6b9" alt=""><figcaption><p>Select the frequency and timing of your schedule</p></figcaption></figure>
6. **Set Controls (optional)**: filters on the data to be sent in this export

   <figure><img src="https://3615148728-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LkRqYp6lJhwxjYdzYG8%2Fuploads%2FuEYFMGNMvrnZij8ze772%2Fimage.png?alt=media&#x26;token=7f4d20bc-43b9-4fe6-9d12-a113d4e148ce" alt=""><figcaption></figcaption></figure>
7. **Add Send Condition (optional)**:

   * **Always** - Send at the scheduled time.
   * **If there is no data** - Send **IF** a selected element has **NO data**.
   * **If there is data** - Send **IF** a selected element **HAS data**.
   * **If a condition is met** - Send **IF** a specific column in a selected element meets a specific condition.

   <figure><img src="https://3615148728-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LkRqYp6lJhwxjYdzYG8%2Fuploads%2F1CBoXz4aAijYgPrsuDuH%2Fimage.png?alt=media&#x26;token=29f29e88-7052-4c6b-bb70-d01f1327ee18" alt=""><figcaption></figcaption></figure>
8. **Click "Create Schedule" to save**


---

# 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://manual.firstresonance.io/ion-analytics.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.
