Config Analysis Dashboard Tool

Overview

The Config Analysis Dashboard tool helps Creators resolve complex issues that occur as they build in the Unqork Designer Platform. With this tool, Creators can submit a configuration report so Unqork can provide feedback on in-progress application builds.

Use the Config Analysis Dashboard tool to submit your configurations for review. The Unqork team runs multiple tests on each configuration, suggesting possible improvements. Unqork also sends a detailed report of the tests, so you avoid similar configuration issues in the future. Upload your report to the Config Analysis Dashboard tool to filter and organize your information with ease. The tool includes various charts as visualization aids and KPI widgets to print, export, and share test results.

Config Analysis requests are sent to an Unqork team that performs a detailed analysis of your configurations. This tool does not return the analysis in real time. Expect to receive the results in one to two days.

Discover how to access the UDLC Toolkit in our Introduction to the Unqork Development Life Cycle Toolkit article.

To learn more about the Config Analysis Dashboard tool, click on each tab below:

Submitting a Config Analysis Request

The first step is to submit a Config Analysis Request. After receiving your request, Unqork reviews your module or application configuration to ensure it meets Unqork's best practices.

To submit a module or application for analysis, click + Request New Analysis.

Next, you'll choose what you want to submit for review. Your options inlcude:

  • All Applications in the Environment: Choosing this option submits all applications in your current environment for review. It's important to note that this could potentially be a lot of data to analyze.

  • Specific Applications: Choosing this option displays the Applications drop-down menu. Use this drop-down to select specific applications in your environment. You can choose as many applications as needed.

  • Specific Modules: Choosing this option displays the Modules drop-down menu. Use this drop-down to select specific modules in your environment. You can choose as many modules as needed.

1. After you've made your selection(s), click Submit.
2. Click OK in the pop-up modal.

Another pop-up modal displays your Request Number. Use this number anytime to view the details and status of your request in the Config Analysis Dashboard.

A static image displaying the Config Analysis Dashboard

Filtering the Config Analysis Dashboard

The Config Analysis Dashboard is where you'll find all your requests. As you continue to build applications, the number of requests will increase. But only ten requests display per Dashboard page. Click the pagination buttons below the table to see more. Or, to make it easier, you can use the dashboard's filters to help you find a specific request. You can use any or all these filters, depending on how specific you want to be. As you enter text into the fields, the result displays automatically. To clear all fields, click the funnel icon to the far right.

A static image displaying the Config Analysis Dashboard filter.

Let’s take a look at the available filters:

Filter Description

Request #

This is the Request Number you receive after submitting your request. The typical format of the number is: DATA-####.

User

The person that submitted the request.

Date

The date the request was submitted.

Scope

Use this filter to find requests that analyze either:

  • Modules

  • Applications

Resources

The specific modules or applications added to the request.

Uploading Your Config Analysis Report

After submitting a request, you'll receive an email with an attached spreadsheet called Config Analysis {your-environment} {timestamp in UTC}.xlsx. This spreadsheet is your analysis report. You'll upload this spreadsheet to the Config Analysis Dashboard to organize the request information. Download and save this spreadsheet to your computer to make it easier to locate and upload.

To upload your spreadsheet file:

1. Access the Config Analysis Dashboard tool.
2. Use the Config Analysis Dashboard's filters to find your request.
3. Click the View button to the right of your request. Doing so opens the Config Analysis Upload Dashboard.
4. Drag and drop your spreadsheet file onto the Config Analysis Upload Dashboard. Or, use the dashboard's Browse option to upload your file.

The format of your file must be .xls or .xlsx to successfully upload to the dashboard.

A static image displaying the Config Analysis View Request page.

After the upload is complete, a new page opens displaying the Config Analysis Details page. You'll see all the detailed test results of your request.

After you've uploaded your spreadsheet, you do not have to do it again. When you view that request from the Config Analysis Dashboard, it opens directly in the Config Analysis Details page.

Navigating the Config Analysis Details Page

The Config Analysis Details page displays the test results for your request. The top of the page displays the basic information about your request:

  • Request #

  • User

  • Date

  • Scope

  • Resources

The dashboard also includes panels that let you view, filter, and share the results of the report. These panels include:

  • Charts

  • Filters

  • All Violations

  • Test Descriptions

Here's an example of a report in the Config Analysis Details page:

Let's look at each of these panels in more detail.

Navigating the Charts Panel

Expand the Charts panels to view all the test violations of your modules and applications. Violations are configurations that do not follow Unqork's best practices. You'll see that violations include severity types. The higher the severity, the greater the risk of issues occurring in your application.

Below are the charts you'll see in this panel:

Chart Description

Violations by Test Count

This pie chart displays the number of violations per test. Hover over a section of the chart to see the test it represents, and the number of violations.

Violations by Severity Count

This bar graph displays the number of violations per severity type. The different types of severities include:

  • Low: Violations that have a small chance of causing issues in your application.

  • Medium: Violations that have the potential of causing issues in your application.

  • High: Violations with a high risk of causing issues in your application.

  • Informational: These violations offer context about your configuration. These types of violations do not necessarily pose a risk to your configuration.

Violations by Module Count

This bar graph displays the number of violations per module.

One of the key features of these charts is that you can print and export them to share with your team. When you expand the Charts panel, you’ll notice a (Hamburger) button at the top right of each chart widget. When you click on this button, you see the following options:

Let's look at each of these in more detail.

Print Chart

The Print Chart option lets you print data from each chart.

To print a chart:

1. Click the(Hamburger) button to the right of the chart.
2. Select Print Chart.
3. At the print dialog, set your Destination:
a. Save as PDF.
b. A connected printer device.
4. Set the Layout as Portrait or Landscape.
5. Under More Settings, set the Scale as either Default or Custom. The Custom option lets you adjust the chart size to fit the full page.
6. Click Save/Print. The button updates based on the Destination selected previously.

Download CSV

A CSV (comma-separated values) file is a plain text file that contains a list of data.

To download your chart as a CSV file:

1. Click the (Hamburger) button to the right of the chart.
2. Select Download CSV.
3. Check your Downloads folder for the .csv file. Your file name is similar to that of the chart name. For example, the Violations by Test Count chart downloads as follows: violations-by-test-count.csv.

Download XLS

XLS is a file extension created by Microsoft for use with Microsoft Excel.

To download your chart as an XLS file:

1. Click the (Hamburger) button to the right of the chart.
2. Select Download XLS.
3. Check your Downloads folder for the .xls file. Your file name is similar to that of the chart name. For example, the Violations by Test Count chart downloads as follows: violations-by-test-count.xls.

Download PDF Document

PDF stands for Portable Document Format. Using this format prevents modification of your chart file while still allowing sharing and printing.

To download your chart as a PDF file:

1. Click the (Hamburger) button to the right of the chart.
2. Select Download PDF Document.
3. Check your Downloads folder for the .pdf file. Your file name is similar to that of the chart name. For example, the Violations by Test Count chart downloads as follows: violations-by-test-count.pdf.

Resources