Install and uninstall Elastic Agent integration assets
Elastic Agent integrations come with a number of assets, such as dashboards, saved searches, and visualizations for analyzing data. When you add an integration to an agent policy in Fleet, the assets are installed automatically. If you’re building a policy file by hand, you need to install required assets such as index templates.
- In Kibana, go to the Integrations page and open the Browse integrations tab. Search for and select an integration. You can select a category to narrow your search.
- Click the Settings tab.
- Click Install <integration> assets to set up the Kibana and Elasticsearch assets.
Note that it’s currently not possible to have multiple versions of the same integration installed. When you upgrade an integration, the previous version assets are removed and replaced by the current version.
Elastic Agent integrations and associated assets, such as dashboards, visualizations, and saved searches, behave differently depending on your Elastic Stack version:
Stack Fleet uses a space-aware data model for Elastic Agent policies and integrations. Agent policies can now span multiple spaces, while integration assets remain space-specific.
Integration assets are still installed per space, but can be managed and reinstalled independently in each space.
If you upgraded from an earlier version, enable space awareness in Fleet before managing integrations across spaces.
For more details, refer to Using Spaces with Fleet.
Stack In versions earlier than Elastic Stack 9.1, integration assets can be installed in only one Kibana space. You can manually copy them to other spaces. However, many integrations include markdown panels with dynamically generated links to other dashboards. When copied between spaces, these links might not behave as expected and can result in a
Dashboard not found
(404) error. Refer to known issue #175072 for details.
Uninstall an integration to remove all Kibana and Elasticsearch assets that were installed by the integration.
Before uninstalling an integration, delete the integration policy from any Elastic Agent policies that use it.
Any Elastic Agents enrolled in the policy will stop using the deleted integration.
In Kibana, go to the Integrations page and open the Installed integrations tab. Search for and select an integration.
Click the Settings tab.
Click Uninstall <integration> to remove all Kibana and Elasticsearch assets that were installed by this integration.
You may need to reinstall an integration package to resolve a specific problem, such as:
- An asset was edited manually, and you want to reset assets to their original state.
- A temporary problem (like a network issue) occurred during package installation or upgrade.
- A package was installed in a prior version that had a bug in the install code.
To reinstall integration assets:
- In Kibana, go to the Integrations page and open the Installed integrations tab. Search for and select an integration.
- Click the Settings tab.
- Click Reinstall <integration> to set up the Kibana and Elasticsearch assets.