Skip to content

Tracer

Tracer helps you use runtime evidence to understand how users move through a legacy application. It combines traced users, taxonomy mappings, uploaded logs, and module usage so you can identify candidate domains and focus later decomposition work.


Tracer workflow

The Tracer workflow is easiest to follow when you move from concepts, to master data, to log ingestion, and finally to reports. Each step builds on the previous one, so missing setup in an earlier page usually affects downstream analysis results. Use the sequence below as the recommended order for onboarding a new project into Tracer.

Use Tracer in this order:

  1. Review About Tracer to understand the tracing model, instrumentation options, and analysis approach.
  2. Add or import Traced Users.
  3. Create, merge, or import entries in Taxonomy Selection.
  4. Create the mappings in Taxonomy User Mapping.
  5. Upload runtime, database query, or OpenTelemetry logs on Upload Logfile.
  6. Review Mining Modules and the Tracer Reports to understand usage patterns and taxonomy probabilities.

About Tracer

The conceptual overview for Tracer now lives on the dedicated About Tracer page. The page explains the Tracer model, application overview, data gathering, instrumentation, OpenTelemetry, and data analysis topics in more detail. Start there if you need the background behind the runtime evidence and probability calculations used elsewhere in this section.


Traced users

The Traced Users page stores the users or actors that Tracer associates with runtime activity. These entries are foundational because Tracer uses them to connect observed system behavior to business-facing user groups. Maintain this page before loading logs so the resulting activity can be mapped meaningfully.

wwdecompose tracer Traced Users page stores users actors that

The page accepts CSV uploads.

Use the controls in the upper-right corner of the page to work with traced users:

  1. Click Download Traced Users to export the current user list.
  2. Click to create a traced user manually.
  3. Click to import users from a file.
Managing traced users

Use these actions to create and maintain traced users.

  1. Click .
  2. Enter the value in User name.
  3. Click to create the user and return to the user list. wwdecompose tracer Click :ant-outlined-save: create user return user list.
  1. Click to delete the user. The application asks for confirmation before the delete is applied.
  2. Click to open User Identities for the selected user.
  3. Maintain the identities associated with that traced user on the User Identities page.

Taxonomy selection

Use Taxonomy Selection to maintain the business taxonomies that Tracer uses during analysis. These taxonomies represent the candidate business domains that Tracer will compare against runtime behavior. Define them carefully so the later probabilities align with the business structure you want to evaluate.

wwdecompose tracer Taxonomy Selection maintain business taxonomies that Tracer

The page accepts CSV uploads.

The toolbar provides the following actions:

  1. Click Download Traced Taxonomies to export the current taxonomy list.
  2. Click to create a taxonomy manually.
  3. Click to combine two taxonomy entries.
  4. Click to import taxonomy data.
Managing taxonomies

Use these actions to create, merge, and maintain taxonomy entries.

  1. Click .
  2. Enter the value in Taxonomy Name.
  3. Click to create the taxonomy and return to the taxonomy list. wwdecompose tracer Click :ant-outlined-save: create taxonomy return taxonomy list.
  1. Click .
  2. Select the target taxonomy in Taxonomy to merge into.
  3. Select the source taxonomy in Taxonomy to be merged from.
  4. Click to merge the selected taxonomies. wwdecompose tracer Click :ant-filled-merge-cells: merge selected taxonomies.
  1. Click to open Edit Taxonomy. The page prepopulates Taxonomy Name for the selected entry.
  2. Update the taxonomy name and click to apply the change.
  3. Click to delete the taxonomy. The application asks for confirmation before the delete is applied.

Taxonomy user mapping

Use Taxonomy User Mapping to connect users to the taxonomy they represent. Tracer depends on this mapping to turn raw user activity into module-to-taxonomy probabilities. Keep it accurate because incorrect mappings can distort the analysis results significantly.

wwdecompose tracer Taxonomy User Mapping connect users taxonomy they

Use a CSV file when you import mappings on this page. A valid file uses the headers UserName;TaxonomyName.

The page is split into two lists:

  • The left side shows available taxonomies.
  • The right side shows the users mapped to the selected taxonomy.

Use the controls on this page as follows:

  1. Select a taxonomy from the list on the left.
  2. Review the mapped users for the selected taxonomy in the right panel.
  3. Click Add mapped users for the selected taxonomy to open Create Taxonomy To User Mapping.
  4. Select the user from the dropdown to map on the creation page and click to add the mapping.
  5. Click near the page title to import mapping data from a CSV file.

The Add mapped users action is context-sensitive. It works on the taxonomy that is currently selected in the left panel and opens a dedicated mapping page for that taxonomy.

Managing taxonomy user mappings

Use these actions to add, import, and remove taxonomy user mappings.

  1. Select a taxonomy from the list on the left.
  2. Click Add mapped users for the selected taxonomy.
  3. Select the user to map on the creation page.
  4. Click to add the mapping. wwdecompose tracer Click :ant-outlined-save: mapping.
  1. Click near the page title.
  2. Select a CSV file that uses the headers UserName;TaxonomyName.
  3. Complete the import to load the mappings into the page.
  1. Select a taxonomy from the list on the left.
  2. Review the mapped users in the right panel.
  3. Click in the mapped-users table to remove the selected user from that taxonomy.

Mining modules

The Mining Modules page lists the modules discovered by tracing and shows the module metadata available for later reporting and decomposition. It gives you a direct view of the technical artifacts Tracer has identified from the collected evidence. Use it to confirm coverage, inspect module details, and control inclusion in later results.

wwdecompose tracer Mining Modules page lists modules discovered tracing

The table includes these columns:

  • Name identifies the module.
  • Module Hash shows the unique technical identifier for the module.
  • Path shows the source or logical path when available.
  • Module Type identifies the type of module, such as EXEC_PGM, FILE, PROC, or SUBROUTINE.
Using mining module actions

Use these actions to include modules in results and review related details.

  1. Use the switch in the module row to control whether the module is included in Tracer results.
  2. Use toggle on to include the module in results.
  3. Use toggle off to exclude the module from results. wwdecompose tracer :ant-filled-toggle-off: toggle exclude module from results.
  1. Click Mining Functions to review the functions for the selected module.
  2. Review the traced functions for that module.
  3. Use the recorded line range and duration values to inspect the function activity. wwdecompose tracer recorded line range duration values inspect function
  1. Click Database Queries to review the database queries for the selected module.
  2. Review the traced SQL statements associated with that module. wwdecompose tracer Review traced statements associated with that module.

Use the pagination controls at the bottom of the table to move through the full module list.


Upload logfile

Use Upload Logfile to import trace data into the project. This is the step where runtime evidence enters Tracer and becomes available for processing and probability calculations. Use the correct upload panel for each log type so the collector can interpret the data properly.

wwdecompose tracer Upload Logfile import trace data into project.

The page contains three upload panels:

  • Application Runtime Logs for application runtime traces.
  • Database Query Logs for database access traces.
  • OpenTelemetry Logs for trace data produced by OpenTelemetry instrumentation.
Uploading logs

Use the appropriate panel to load each log type into Tracer.

  1. In Application Runtime Logs, click Import Data.
  2. Select the runtime log file to upload.
  3. Monitor the progress bar and the counters for Total, Processed, and Failed.
  1. In Database Query Logs, click Import Data.
  2. Select the database query log file to upload.
  3. Monitor the progress bar and the counters for Total, Processed, and Failed.
  1. In OpenTelemetry Logs, click Import Data.
  2. Select the OpenTelemetry log file to upload.
  3. Monitor the progress bar and the counters for Total, Processed, and Failed.

Repeat these steps for each log type you want to load.


Reports

The Reports section exposes the analysis outputs generated from the traced users, taxonomies, mappings, and uploaded logs. These views help you turn collected runtime data into decisions about usage, taxonomy alignment, and decomposition candidates. Review them after the upstream setup and log-ingestion steps are complete.

Results dashboard

The Results Dashboard provides download links for the main Tracer output files and summarizes module usage.

wwdecompose tracer Results Dashboard provides download links main Tracer

Use the dashboard to download:

  • Traced Taxonomies
  • Modules And Queries
  • Module Relations
  • Traced Taxonomies and Modules
  • Module usage
  • Unused Modules

The chart in the lower section compares the used and unused module counts for the project.

Taxonomy usage

The Taxonomy Usage report calculates the probability that modules belong to a taxonomy based on traced activity.

For the calculation model and worked examples behind these probability values, see Tracer Probability Calculation.

wwdecompose tracer calculation model worked examples behind these probability

Use this page as follows:

  1. Click Calculate to run the probability analysis.
  2. Review the taxonomy list in the first table.
  3. Use Show Highest Probability to focus on the strongest taxonomy matches for modules.

Module usage

The Module Usage report combines the traced module list with usage counts by taxonomy.

wwdecompose tracer Module Usage report combines traced module list

Use this page as follows:

  1. Review the upper table for the traced module list, including the module name, hash, and path.
  2. Review the lower table for the usage count per taxonomy when probability results are available.
  3. Use the pagination controls to move through the module list.

Total function usage

The Total Function Usage report lists functions together with their taxonomy, module, and probability values.

wwdecompose tracer Total Function Usage report lists functions together

Use this page as follows:

  1. Review the Taxonomy, Module, Function, and Probability columns.
  2. Use the pagination controls to move through the result set.
  3. Click Download Function Usage Results to export the current report.

Social graph

The Social Graph report visualizes relationships around a selected taxonomy and supports graph export.

wwdecompose tracer Social Graph report visualizes relationships around selected

Use this page as follows:

  1. Select a taxonomy from Select specific taxonomy.
  2. Review the generated graph for the selected taxonomy.
  3. Click SVG or GraphML to export the current graph.

If the project does not yet contain taxonomy data, the page cannot generate the graph.

Taxonomy graph

The Taxonomy Graph report visualizes the selected taxonomy and supports SVG export.

wwdecompose tracer Taxonomy Graph report visualizes selected taxonomy supports

Use this page as follows:

  1. Select a taxonomy from the drop-down list.
  2. Review the generated business process graph for the selected taxonomy.
  3. Click camera Created with Sketch Beta. SVG to export the graph.