Fix Pack 2

Actions for analyzing the content of business applications

By using the bizappscli tool, you can generate reports, which you can use to analyze the content of your business applications.

analytics

This action creates reports, which you can then use in the analysis of your business applications content and their creation process. You can display one report at a time. The following reports are available:
  • -a, --AbandonedCollections - displays the names of these applications, for which a pattern no longer exists. The pattern was deleted, or it was modified in such a way that it no longer generates application with the same ID. Topologies of such business applications are not updated anymore. The following information is displayed:
    • COLLECTION_NAME
    • LAST_GENERATION_TIME
  • -b, --PlaceholdersByProc - displays already discovered placeholder servers that are a part of at least one business application and that are matched with unrecognized processes. This report is useful when you create new custom server templates for the processes which are not recognized by default. The following information is displayed:
    • MATCHED_PROCESS
    • PLACEHOLDERS_COUNT
  • -c, --Counts - displays the number of nodes and paths of business applications. This report helps you quickly detect anomalies such as too large or too small applications. The following information is displayed:
    • COLLECTION_NAME
    • NODES_COUNT
    • PATHS_COUNT
    • LAST_GENERATION_TIME
  • -e, --ForRegeneration - displays the applications in which member nodes refer to the nodes that were deleted after the last generation of application. Such applications contain outdated content and must be regenerated. The following information is displayed:
    • COLLECTION_NAME
    • NODES_COUNT
  • -h, --AllPlaceholders - displays all placeholder servers that are a part of business applications. This report provides detailed information about each placeholder server. The following information is displayed:
    • PLACEHOLDER
    • MATCHED_PROCESS
    • HOST
    • LAST_STORE_TIME
    • COLLECTION_NAME
  • -n, --PlaceholdersNeverDiscovered - displays the placeholder servers that are a part of at least one business application and that do not contain any host information. Typically, such servers are a part of an environment that was not yet discovered, or an external environment, for example cloud. The following information is displayed:
    • PLACEHOLDER
    • COLLECTION_NAME
  • -o, --UnusedRoutes - displays the routes that were traversed but were not used in building paths. The relations that are represented by these routes might be excluded from traversing in the grouping pattern configuration. Analyze carefully the routes that are unused, because they might be used again when new data is introduced. The following information is displayed:
    • RELATION_TYPE
    • COUNT
  • -r, --Routes - displays routes that are used to generate business applications. Routes are not displayed on the topology, but they build paths that are displayed on the topology. By adding the -g option, you can display the routes for a particular application. The following information is displayed:
    • RELATION_TYPE
    • SOURCE_TYPE
    • TARGET_TYPE
    • COUNT
  • -w, --PlaceholdersToRediscover - displays the placeholder servers that are a part of at least one business application and that contain hosts, but no matched processes. This means that the placeholder server host is in the scope of the discovery, but the information about unrecognized runtime processes was already deleted. The following information is displayed:
    • PLACEHOLDER
    • HOST
    • LAST_STORE_TIME
    • COLLECTION_NAME
You can use the following options when you create reports with the analytics action:
  • -A, --sortAsc <arg> - sorts the names of business applications in the alphabetical order. The possible values are true and false. The default value is false.
  • -g, --guid <arg> - defines the GUID of an application. You can use it to limit the output of some of the reports to one specific business application.
  • -G, --showGuids - shows the GUIDs of the objects, where an object can be an application, placeholder, process, or host.
  • -m, --maxRows <arg> - limits the output to the specified number of rows.
  • -R, --showPattern - displays the names of grouping patterns. The possible values are true and false. The default value is false.
  • -S, --separator <arg> - defines the separator of the values. The default separator is a space, " ".
Examples
1. The following command displays a report that contains information about the number of nodes and paths of an application with the GUID 00000000000000000000000000000000:
bizappscli.sh analytics -c -g 00000000000000000000000000000000
Sample output:
COLLECTION_NAME   COLLECTION_GUID   NODES_COUNT   PATHS_COUNT   LAST_GENERATION_TIME
pattern_1   00000000000000000000000000000000   2   2   07/09/2015 07:57:07
2. The following command displays a report that contains information about all placeholder servers, and additionally specifies GUIDs of the objects:
bizappscli.sh analytics -h -G
Sample output:
PLACEHOLDER   PLACEHOLDER_GUID   MATCHED_PROCESS   PROCESS_GUID   HOST   HOST_GUID   LAST_STORE_TIME   COLLECTION_NAME   COLLECTION_GUID
23.23.23.23:9550   11111111111111111111111111111111   kdsmain   22222222222222222222222222222222   23.23.23.23   3333333333333333333333   30/08/2015 06:27:53   my_app2   44444444444444444444444444444444