|
| 1 | +--- |
| 2 | +navigation_title: Manage the lifecycle policy for integrations data |
| 3 | +applies_to: |
| 4 | + stack: ga |
| 5 | +products: |
| 6 | + - id: elasticsearch |
| 7 | +--- |
| 8 | + |
| 9 | +# Manage the lifecycle policy for integrations data [ilm-manage-lifecycle-policy-integrations-data] |
| 10 | + |
| 11 | +An Elastic integration is a pre-packaged collection of assets that provides an effective, simplified way to monitor a product, system, or service, with minimal required setup. Most integrations rely on {{agent}} as an ingest mechanism, and the policies used to govern installed integrations are managed in {{fleet}}. |
| 12 | + |
| 13 | +You can find installation and configuration details for all integrations in the [Elastic integrations](https://docs.elastic.co/en/integrations) chapter of the **Reference** section. To learn about managing your installed integrations, refer to [Manage Elastic Agent integrations](/reference/fleet/manage-integrations.md) in the {{fleet}} and {{agent}} chapter of the **Reference** section. |
| 14 | + |
| 15 | +When you install an integration, an [{{ilm}}](/manage-data/lifecycle/index-lifecycle-management.md) ({{ilm-init}}) policy is configured automatically to manage the integration's component [data streams](/manage-data/data-store/data-streams.md) and their backing indices. To view or adjust how your integration data is managed, a first step is to find the data streams that you're interested in. There are a few ways to do this: |
| 16 | + |
| 17 | +::::{dropdown} Find the data stream for a {{kib}} visualation |
| 18 | +To find the data stream associated with a visualization in a {{kib}}: |
| 19 | + |
| 20 | +1. Open **Dashboards** from the {{kib}} menu and select a dashboard to view. For example, with the [System integration](integration-docs://reference/system.md) installed, you can open the `[Metrics System] Host overview` dashboard to find visualizations about the host system being monitored. |
| 21 | + |
| 22 | +1. Hover over any visualization and click the **Explore in Discover** icon. |
| 23 | + |
| 24 | +  |
| 25 | + |
| 26 | +1. In **Discover**, the list of documents shows the columns for fields applicable to the visualzation that you selected. Select any document that has data for those fields and click the **Toggle dialog with details** icon. |
| 27 | + |
| 28 | +  |
| 29 | + |
| 30 | +1. In the document details, note that there are three `data_stream` fields. The full [data stream name](/reference/fleet/data-streams.md#data-streams-naming-scheme) is a composite of `data_stream.type`, `data_stream.dataset` and `data_stream.namespace`, separated by a hyphen. For example, in the System integration, the **CPU usage over time** visualization is associated with the `metrics-system.cpu-default` data stream. |
| 31 | + |
| 32 | + You can also see the data stream's current backing index, as well as other information such as the document timestamp and details about the agent that ingested the data. |
| 33 | + |
| 34 | +  |
| 35 | +:::: |
| 36 | + |
| 37 | +::::{dropdown} Find the data streams for an integration |
| 38 | +To find the data streams associated with an installed integration: |
| 39 | + |
| 40 | +1. In {{kib}} go to **Management > Integrations > Installed integrations** and select any integration. |
| 41 | + |
| 42 | +1. Open the **Assets** tab and expand the **Index templates** list. |
| 43 | + |
| 44 | + In the list, the name of each [index template](/manage-data/data-store/templates.md) matches an associated data stream. For example, the `metrics-system.cpu` template matches the `metrics-system.cpu-default` data stream that is set up when the System integration is installed. |
| 45 | + |
| 46 | +  |
| 47 | +:::: |
| 48 | + |
| 49 | +::::{dropdown} Find the data streams managed in {{fleet}} |
| 50 | +To find all of the data streams that are managed in {{fleet}}: |
| 51 | + |
| 52 | +1. In {{kib}} go to **Management > {{fleet}}** and select the **Data streams** tab. |
| 53 | + |
| 54 | +1. Use the search field and dropdown menus to filter the list. You can filter by the data stream type, dataset, namespace, or by the integration that the data stream belongs to. |
| 55 | + |
| 56 | +  |
| 57 | +:::: |
| 58 | + |
| 59 | +For any data stream that you're interested in, you can [view its current lifecycle status](/manage-data/lifecycle/index-lifecycle-management/policy-view-status.md), including details about its associated ILM policy. |
| 60 | + |
| 61 | +After you've identified one or more data streams for which you'd like to customize how the data is managed over time, refer to our tutorials: |
| 62 | + |
| 63 | +* For a general guide about configuring a custom ILM policy for any managed data stream, try out our [Customize built-in policies](/manage-data/lifecycle/index-lifecycle-management/tutorial-customize-built-in-policies.md) tutorial in the data lifecycle documentation. |
| 64 | +* For the steps to customize an ILM policy for a set of data streams, such as all logs or metrics data streams across all namespaces, across only a selected namespace, and others, check the set of tutorials in [Customize data retention policies](/reference/fleet/data-streams-ilm-tutorial.md) in the {{fleet}} and {{agent}} reference documentation. |
0 commit comments