Links
Comment on page

Merging components

StackState SaaS

Overview

Components from a custom instrumentation can be merged with pre-existing components in StackState. This allows you to:
  • Add extra attributes into pre-existing components.
  • Create custom relations for pre-existing components.
  • Influence the propagation of health state. For details, see the page Span health state.
Components with the same identifier will be merged together in StackState. After merging, the original component will inherit all properties from the component that merged with it. The component that was merged will no longer be visible.
Important to know when merging:
When a custom instrumentation is merged with a pre-existing StackState component, it might seem that custom instrumentation component disappeared; it did not. All properties of the custom instrumentation component are inherited by the component with which it merges.

Merging inheritance

When a custom instrumentation component is merged with a pre-existing component, the component with which it is merged will inherit all the properties, health, and relations from the custom instrumentation component. This means that, although the custom instrumentation component will no longer be visible, the component that it merged with now acts as both the original component and the custom instrumentation component. The resulting component will now contain, for example, all the labels, telemetry, and health from the custom instrumentation component.
The example below shows an unmerged child component; below are all the labels and identifiers for this child component.
Topology Perspective - Labels and Identifiers
And on the right side, we included the list of health checks and telemetry also running on the child.
Topology Perspective - Unmerged Healthy OTEL Component
Now when we look at the component that we want to merge with, you will notice the labels and identifiers contains none of the same ones we looked at when viewing the child component.
Topology Perspective - Labels and Identifiers After Merge
This is the same for the health checks and telemetry on the right side.
Topology Perspective - Component Merged Health State
Now let's see the result after merging our child component with the pre-existing StackState component.
Let's look at the identifiers and labels again. As you can see in the image below the identifiers stayed the same but the labels merged, This StackState merged component now contain the values from both.
Topology Perspective - Labels and Identifiers After Merge
The same can be seen in the health checks and telemetry. You will notice that the health checks and telemetry streams are from both components.
Topology Perspective - Component Merged Health State

Component identifier

If two components in StackState have the same identifier, StackState will merge those two components.
For example, if you select a component and click on the SHOW ALL PROPERTIES button on the right panel
Topology Perspective - Show All Properties Button Position
It will open a dialog; within this dialog, you can see the identifiers. If you reuse any of these within your span, it will merge with that component, We will have a few visual examples further down in the documentation.
Topology Perspective - Component properties - Identifiers

Example: Merging a component

Let's take the following example; we have three components that we create, all having the previous one as their parent span.
Service Name: Parent Component
|
---> Service Name: Child Component
|
---> Service Name: Child 2 Component
That will create the following components with relations.
Topology Perspective - OTEL Components Unmerged Example
Now let's add a few pre-existing Lambda functions into the picture. We are focusing on the healthy Lambda function in the bottom right corner.
Topology Perspective - OTEL Components and Pre-Existing Components
If we click on that Lambda function, we will be able to see what the identifier is by using the same service identifier arn:aws:lambda:eu-west-1:965323806078:function:otel-example-custom-instrumentation-dev-create-custom-component in our second component it will merge with that pre-existing component.
Topology Perspective - Component properties - Identifier
That will result in the following happening. As you can see, the component we merged now has new relations, and those relations are the same ones our component had as the merged component inherited the same relations
Topology Perspective - Merged Component