Enabling the Instana-Turbonomic two-way integration
You can maximize the benefits of Turbonomic and Instana Observability (Instana) by setting up a two-way integration. To set up the two-way integration, you need to configure Turbonomic to fetch data from Instana, and then configure Instana by using the Turbonomic sensor to receive data (or actions) from Turbonomic. After you install the Instana agent, you must enable the Turbonomic sensor in the agent configuration file. Then, you can view performance-related actions from Turbonomic in the Instana UI.
The Turbonomic sensor polls Turbonomic APIs every 10 minutes to retrieve the executed and recommended actions. The sensor uses a unique key (SnapshotID) to link Instana entities with the corresponding Turbonomic actions.
The sensor needs the Instana automation action framework to automate the data retrieval and correlation process.
Supported operating systems
The supported operating systems of the Turbonomic sensor are consistent with host agent requirements. For more information, see the supported operating systems section of each host agent installation topic, such as Supported operating systems for Unix.
Prerequisites
Before you enable the Turbonomic sensor to set up a two-way integration between Turbonomic and Instana, complete the following steps:
-
Instana must be added as a target in Turbonomic. For more information, see Instana.
-
Enable the Instana automation actions framework for your Instana backend. For more information, see Managing actions in the Instana documentation.
Configuring Instana
By default, the Turbonomic sensor is disabled. To enable the sensor, update the agent configuration file as shown in the following example:
# Turbonomic Sensor
com.instana.plugin.turbonomic:
enabled: true
host: '<INSERT_TURBONOMIC_SERVER_HERE>' # Turbonomic Server Host or IP address
target: '<INSERT_TURBONOMIC_TARGET_NAME>' # Name of the target (Instana Server) as configured in Turbonomic
auth:
username: <INSERT_USERNAME_OF_TURBONOMIC_SERVER_HERE> # User must have administrator, deployer, or automator authority.
password: <INSERT_PASSWORD_OF_TURBONOMIC_SERVER_HERE>
You must have administrator, deployer, or automator authority to be able to use the Turbonomic API to collect actions.
Viewing Turbonomic actions in Instana
After you enable the Turbonomic sensor, you can view the executed and recommended actions from Turbonomic in the Instana UI. These actions are aimed at improving the performance of the entities that are monitored by Instana.
For more information, see Viewing Turbonomic actions in the Instana documentation.
Executed actions
You can view the executed actions on any of the following dashboards in the Instana UI.
Application perspective dashboard
-
In the sidebar of the Instana UI, select Applications.
-
Click an application perspective. On the Summary tab, you can see the actions that are executed by Turbonomic in the Actions swimlane with the application KPIs to indicate the impact of the action on the KPIs.
-
Click the action in the Actions swimlane. The Action History dialog is displayed with the details of the executed action.
Infrastructure dashboard
-
In the sidebar of the Instana UI, select Infrastructure.
-
On the Map tab, click a tower specific to the monitored host.
-
Click Open Dashboard. You can see the actions that are executed by or from Turbonomic in the Actions swimlane with the entity KPIs to indicate the impact of the action on the KPIs.
-
Click the action in the Actions swimlane. The Action History dialog is displayed with the details of the action.
Automation dashboard
-
In the sidebar of the Instana UI, select Automation.
-
Click the Action History tab. You can view a list of executed actions.
-
Click an executed action from the list to view its details.
Recommended actions
Recommended actions are proposed by Turbonomic for performance improvements on the entities that are monitored by Instana. These actions are retrieved by Instana and correlated against the ongoing incidents.
-
In the sidebar of the Instana UI, go to Events > Issues.
-
Click an issue.
-
Click the Recommended Actions tab. You can see all recommended actions with the Incident context.
Note:When you click any recommended action from the list, you're directed to the Entity dashboard in the Turbonomic UI.