Actor Lineage 🚀
Last updated
Last updated
In Data Mover, actor lineage refers to the process of tracing the configured complete flows of data from a source actor to one or more destination actors. As the level of detail increases, the actor lineage offers a comprehensive perspective on the flow, showing the complete configuration, and covering all contracts and protocols configured within them.
This feature is particularly useful for simplifying troubleshooting and data analysis since the lineage always shows the full path, from a source actor to a destination actor or actors and there will never be a flow in the configured path that starts from an actor and stops in the middle of the mediation.
In a setup involving two Data Mover actors, the configuration includes these key components:
A source actor, with an input configuration that can be either an input contract or a connection contract.
One or more mediation contracts that manage the interaction between the source and destination actor.
A destination actor, with an output configuration that is either an output contract or a connection contract.
The lineage goes down to an increasing level of detail. It starts with a general view of the source actor and the destination actors to which it is connected. From there, users can access more details showing the flow. Finally, more information is displayed with all the details, from the template used to the individual configurations chosen when creating the flow.
Only mediation contracts that use "sourceVirtualPath" as the variable name for the starting virtual path are suitable for identifying the complete flow. Mediation contracts that use custom names for virtual path variables will not be tracked in lineage.
To access the Actor lineage functionality, go to Actors, click the 3 dots button on the actor row, and select the Lineage option. A specific license is needed to see this menu.
After selecting the Lineage option, a screen will show the source actor and its single or multiple destinations. In this latter case, an arrow starts from the source and goes to each destination. Each arrow represents a distinct action toward one of the destinations, creating a one-to-one correspondence between the source of the arrows and the destinations to which they are directed.
Clicking on a single source or destination, details are displayed in a panel appearing on the right. This is the information shown:
Actor: name of the actor involved
Type: type of actor, i.e. Application or Partner
Description: description of the actor, entered upon its creation
Last update: if applicable, the date of the last update is given
Read the following pages for the details about Actor Lineage:
All diagrams can be exported in SVG format by clicking the icon in the upper right corner.
