On this page:
|Summary: This page provides instructions for using the CAST Application Analytics Dashboard, i.e. how to login, what information is available etc.|
The CAST Application Analytics Dashboard (CAST AAD) is the dashboard view of all the data surfaced through CAST AIP analysis and snapshot generation. . This includes health factors, compliance scores, risk indicators, critical violation counts, technical sizing, all related statistics and also includes Function Points for sizing. The CAST Application Analytics Dashboard will give visibility and measurement overview of IT development activities at all levels.
This documentation section provides the following information:
If you need to know more about:
To connect to the CAST Application Analytics Dashboard, browse to the URL provided to you by your CAST Administrator. This will usually be in the following format:
The login page will then be displayed:
To login to the Application Analytics Dashboard, you need to enter a username and password and then click the Log In button.
Depending on the authentication mode configured by the CAST AI Administrator (see Installing and configuring the CAST Application Analytics Dashboard for more information) you need to login with a presupplied username and password, or your corporate username and password. If in doubt, contact your CAST AI Administrator.
Note that if you are not authorized to view any data in the CAST Application Analytics Dashboard, then upon login a message will be displayed as follows and no further use of the dashboard is allowed:
If you need to access the CAST Application Analytics Dashboard but:
then you can use the Can't access link to contact the CAST AI Administrator:
You will then be prompted to choose an option - each is explained below.
|Note that the email address and text for both options can be modified. Please see: CAST-AAD-AED - Lost password and request access configuration.|
If you choose this option:
A new email will be created in your default email client requesting the password for the username you specified. Send this to your CAST AI Administrator.
If you choose this option, simply click the Send button.
A new email will be created in your default email client requesting access. Send this to your CAST AI Administrator.
The information displayed in the CAST Application Analytics Dashboard is derived from snapshots generated by the CAST AI Administrator and provides a high level and intuitive overview of your set of Applications.
|Note that the CAST Application Analytics Dashboard features a server cache to improve the speed of data display. This does mean, however, that very recent changes in data (i.e. a new snapshot generation) may not instantly appear in the dashboard. If this is the case, the server cache needs to be manually reloaded. See CAST-AAD-AED - Reload the cache.|
When you first log in, you will be presented with the "landing page". The contents of this page depend on the number of Applications that are present in the Measurement Service:
If snapshot data for only one Application is present, you will be presented with the Application landing page - the Application name is displayed at the top as highlighted below.
If snapshot data for multiple Applications is present, you will be presented with the Multi-application landing page - the number of Applications is displayed at the top left. The Health Factor scores represent the full portfolio, and the trending graphs are at the portfolio level as well. Specific tiles can be configured, such as the CISQ Security standard, for viewing, tracking and drilldown. The view will show an Application Heatmap and a list of the riskiest applications. Some of the tiles can be configured to show persistence from prior snapshots. At the portfolio level, that persistence data shows the difference over the selected period of analysis. In the dashboard below, the Technical Debt was increased by $9.3m and 27 applications were added to the portfolio in the last 12 months.
To view data for an individual Application, click the "+" button underneath Application Analytics Dashboard and select the one you require. You will then be taken to the Application landing page:
|Note that this is known as filtering and is explained in more detail below.|
Data is displayed in the CAST Application Analytics Dashboard in the form of clickable "tiles". The data in the tiles is divided into various sections:
|This section is visible in both the Multi-application and Application landing pages.|
Data in these tiles represents the most recent "score" of your Application or Applications for a specific Quality or Quantity measurement (i.e. the information from the most recent snapshot generated by the CAST AI Administrator) in the most recent snapshot. Each tile contains a specific type of data, for example Robustness, Security, Number of Critical Violations, Number of Lines of Code. Where you have more than one Application (by default data from all Applications is displayed when you first load the CAST Application Analytics Dashboard), the data in these tiles is either a sum of all the Applications (for example the Size tile) or is an average of all the Applications (the TQI tile):
|This section is visible in both the Multi-application and Application landing pages|
Data in these tiles represents the evolution over time of the snapshot values for all Applications (multiple Applications) or Application (single Application) in the current scope. The Time Span selection and Filter selection determines the scope - see below for more information about this. If no data is present, this means that you only have one snapshot, therefore there is no evolution to display.
You can also view the evolution of specific measures over time by clicking any tile in the Evolutions section. Note that by default, the most recent results of the 10 worst Applications for the selected measure in the selected time period will be displayed. You can select and unselect Applications as required:
Trending can also be viewed by individual rules by application, or specific rulesets. For security analyses, rules are typically grouped into rulesets such as CWE Top-25, OWASP Top-10 and CISQ-22. In the example below, the CWE Top-25 ruleset is being explored, with a trendline shown per rule based on the findings across multiple snapshots (click to enlarge):
|This section is visible in the Application landing page only.|
Data in this tile deals with Function Points on a per Application basis: Function Points are used to determine the functional size of an Application - these are calculated by recent versions of CAST AIP and by default the Automated Enhancement Points (AEP) method is used to measure the modifications that add, change, or delete user functions to/from an existing Application. This tile therefore shows the total number of Functional and Technical Points that have been added/deleted/changed since the previous snapshot. Where there is only one snapshot, the tile will record only ADDED Function Points since there is no previous snapshot.
You can find out more information about the AEP measure in CAST Automated Enhancement Points Estimation - AEP.
|Note that if N/A is displayed in tile, then this means the legacy EFP (Enhancement Function Point) measure has been used to calculate the snapshot. This may be true for users that have upgraded from a release prior to CAST AIP 8.2.x where the EFP measure was the only mode available and where Applications are set to use the EFP mode indefinitely. If this is the case, it is possible to re-display the EFP tiles by merging the configuration of a pre CAST AIP 8.2.x dashboard with the current dashboard. Please see the section Upgrading to CAST AIP 8.2.x. in|
|Note that the tiles are fully configurable by the CAST AI Administrator. Please see CAST-AAD - Tile management for more information.|
Each tile in either landing page can be clicked to drill down and display more information about the selected Quality or Quantity measure. For example for the "Transferability" health factor:
In addition, you can drill down to find out why you have received a particular grade for a Health Factor by viewing the rationale behind the Quality Rule/Distribution/Measure (roll the mouse over the Quality Rule/Distribution/Measure):
The CAST Application Analytics Dashboard provides Automated and Enhanced Function Point information about your Application accessible from the "AEP" tile in the Application landing page. Depending on the enhancement Function Point counting mode that was used to generate the current snapshot (AEP or legacy EFP - see Measures used to calculate enhancement Function Points in CAST OMG-compliant Automated Function Points), the drill down information will differ. AFP data is always shown, along with either AEP or EFP data:
|See CAST Automated Enhancement Points Estimation - AEP for more information about how AEP data is calculated.|
The data provided (out of the box) is a simple value - e.g.:
Sizing provides information about content balance between technical and functional improvements between two snapshots. It provides deleted/added and modified points and the ratio of technical vs functional. AEP transaction information is alos provided (number of transactions impacted and ratio with regard to all transactions)
|See CAST Enhancement Function Points Estimation - EFP for more information about how EFP data is calculated.|
The data provided (out of the box) is a simple value - e.g.:
Out of the box, icons allowing the export of more detailed AFP and EFP information are available, however they are not activated (except when using the combined CAST-AAD-AED WAR file - see Installing and configuring the CAST Application Analytics Dashboard):
However, after a configuration change (please see CAST-AAD - Exporting Automated Function Point data to a Microsoft Excel or CSV file), the icons become active allowing an export to Microsoft Excel file:
When you click the icon, you will be prompted to either Open or Save the file depending on your browser:
Clicking Open will launch the program associated with the .xlsx file type (usually Microsoft Excel), while clicking Save will prompt you to choose a location to store the file for future use.The Excel file contains detailed about how the Enhanced/Automated Function Point value has been derived:
The following columns are displayed in the XLSX file:
|Element Type||Whether this object is a Data Function or a Transaction||String||1|
|Object Name||Full name||String||1|
|Nb of FPs||Number of Function Points for this OMG-compliant Automated Function Points Function||Integer||1|
|Type||OMG-compliant Automated Function Points Function type||String||0..1|
|DET||Data Element Type||Integer||0..1|
|RET||Record Element Type||Integer||0..1|
|EIF||External Interface File||Integer||0..1|
|ILF||Internal Logical File||Integer||0..1|
|FTR||File Type Referenced||Integer||0..1|
|Object Type||Type of this OMG-compliant Automated Function Points Function||String||1|
|Module name||Name of a functional module containing this OMG-compliant Automated Function Points Function||String||1|
|Technology||Technology to which this OMG-compliant Automated Function Points Function belongs||String||1|
By default, the export file format is set to Microsoft Excel (.xlsx). However, it is possible to change this to .csv if you prefer - see CAST-AAD - Exporting Automated Function Point data to a Microsoft Excel or CSV file.
If you set the export to CSV please take note that by default, the semi-colon (;) is used as the delimiter value for the CSV file. You may need to change the List Separator value in Control Panel > Region and Settings > Formats tab > Additional Settings in order for the CSV file to display correctly:
The following columns are displayed in the CSV file:
|Element Type||Whether this object is a Data Function or a Transaction||String||1|
|Object Name||Full name||String||1|
|Nb of FPs||Number of Function Points for this OMG-compliant Automated Function||Integer||1|
|FP details||Details on the Function Points for this OMG-compliant Automated Function||String||1|
|Object Type||Type of this IOMG-compliant Automated Function||String||1|
|Module name||Name of a functional module containing this OMG-compliant Automated Function||String||1|
|Technology||Technology to which this OMG-compliant Automated Function belongs||String||1|
When you click specific tiles in the CAST Application Analytics Dashboard (for example the default "Robustness" tile (a QualityIndicatorResults type tile)) and you have a large number of Applications consolidated, the drill down details will display one column per Application:
This display can make reading the details of each column very difficult. If this is the case you can select (i.e. hold the left mouse button down and select the Applications you require) a certain number of Applications and the dashboard will zoom into them. In the example below, just two Applications have been selected:
Navigating around the data in the dashboard is relatively straightforward - however, below is a brief explanation of some of the interface display options that are available to you:
In every screen in the dashboard, the icons shown above are displayed. When clicked they will behave as follows:
|This icon will take you back to the "home" page.|
|This icon will load this current help page in your browser.|
In every screen in the dashboard, a username button will be visible displaying the user's username. Clicking the button will display a drop down menu whose contents depends on the role granted to the username (see User Roles in Installing and configuring the CAST Application Analytics Dashboard):
|Role granted to the username||Available options|
|none||Only the Logout button is displayed. By default, when clicking the button, a confirmation message will be displayed prompting the user whether they really want to log out. This confirmation message can be deactivated by CAST administrator - see CAST-AAD - Dashboard wide configuration options in json).|
|ROLE_ADMIN||In addition to the Logout button (see above), if the username has been granted the ROLE_ADMIN role, then a link to the Tags Administration page will be displayed. See CAST-AAD - Tag and category management for more information.|
By default, the CAST Application Analytics Dashboard will always display data from the most recent snapshot available for all Applications. In other words:
However, when working at Application level (i.e. you have drilled down from the Multi-application landing page or you only have one Application) you can choose the snapshot data you would like to see by using the dropdown list:
As soon as you select the snapshot, the data in the page will update accordingly.
There are two options that enable you to choose what is displayed in the CAST Application Analytics Dashboard:
By default, the CAST Application Analytics Dashboard will display data for the last 3 months for SizingMeasureEvolution tiles (based on evolution) in the Overview section and for all tiles in the Evolution section - i.e tiles will display the evolution of the data over the period of time selected:
When selecting a time period, the tiles that will be affected will be shown active, those unaffected by the time period selection will be greyed out (the tiles in the Software Enhancement Function Points (since Previous Version) section are not affected by this selector).
|Your CAST Administrator can manually add additional categories to enhance the filtering possibilities. Please see CAST-AAD - Tag and category management for more information.|
The CAST Application Analytics Dashboard also offers you the possibility of filtering your data. By default, CAST will automatically assign the Category "Technologies" and the technology "Tags" to your Applications. In other words (and for example), Applications containing Cobol source code will be tagged with "Cobol" in the "Technologies" Category.
You can see this in action here (click the "+" button to view the filtering categories):
When using the filtering capabilities, results are displayed on an Application basis. So, for example, if you select "Cobol" in the Technologies category, the CAST Application Analytics Dashboard will automatically update and display only those Applications that contain that particular Technology:
You can also filter within specific Quality or Quantity measure information pages based on Categories (auto and manually defined). For example, in the Technical Size page:
Note that if your administrator has created a Category and no Applications have been assigned a Tag within that category, when filtering on that Category, the CAST Application Analytics Dashboard will display "No values to display" as follows:
It is possible to set a specific tag / category on a specific tile (see Scope under Common plugin parameters in CAST-AAD - Tile management for more information) as a scope. When a tile has a tag / category defined as a scope, the tile will be displayed regardless of the filter applied. The tag will also be mentioned in the tile itself:
|When applying a scope to a tile, the global filter still applies (except that Applications outside the initial scope are not considered, i.e. if we select to display scores for a specific Vendor, only applications from that Vendor will be displayed after the filter applies).|
You can filter on one or more tags in the same category:
Or on one or more tags from multiple categories:
If you have configured a filter, the easiest way to reset it is to remove the tags one by one by:
All drill down details pages that list Quality Rule violations include a check box (Only rules with violations) that enables you to filter out any Quality Rules that do not have any violations. This allows you to focus on the information you need:
Once the check box is enabled on an indicator or page, then, during navigation around the dashboard, the filtering will remain active. Navigating to other pages that show a new list of violations will use the most recent setting applied, even though you might change the Application you are looking at. On logout or page reload, the Only rules with violations setting is reset.
All drill down details pages that list Quality Rule violations include a check box (Only critical rules) that enables you to group together all Quality Rules that are designated as "critical":
All drill down details pages that list Quality Rule violations include the ability to list Quality Rules by:
If you are licensed to do so and your CAST AI Administrator has configured access (see in 2.2.3. Snapshot generation and validation), you can drill down into the or into the CAST Engineering Dashboard to obtain more detailed information about a specific Application or Quality indicator. To do so:
The CAST AIP build number is provided in the bottom right corner of each page in the CAST Application Analytics Dashboard:
This number can be provided to CAST Support to help troubleshoot any issues you may have.