Skip to content

Commit 6210ead

Browse files
committed
Document OTel integrations for Fleet-managed Elastic Agent
1 parent 0fbda05 commit 6210ead

File tree

1 file changed

+36
-11
lines changed

1 file changed

+36
-11
lines changed

reference/fleet/manage-integrations.md

Lines changed: 36 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -2,34 +2,32 @@
22
navigation_title: Manage integrations
33
mapped_pages:
44
- https://www.elastic.co/guide/en/fleet/current/integrations.html
5+
applies_to:
6+
stack: ga
7+
serverless: ga
58
products:
69
- id: fleet
710
- id: elastic-agent
811
---
912

1013
# Manage {{agent}} integrations [integrations]
1114

15+
{{agent}} integrations provide a unified way to collect data from apps and services and to protect systems from security threats.
1216

13-
::::{admonition}
14-
Integrations are available for a wide array of popular services and platforms. To see the full list of available integrations, go to the **Integrations** page in {{kib}}, or visit [Elastic Integrations](integration-docs://reference/index.md).
17+
Integrations are available for a wide array of services and platforms. To see the full list of available integrations, go to the **Integrations** page in {{kib}}, or visit [Elastic Integrations](integration-docs://reference/index.md).
1518

16-
{{agent}} integrations provide a simple, unified way to collect data from popular apps and services, and protect systems from security threats.
17-
18-
Each integration comes prepackaged with assets that support all of your observability needs:
19+
Each integration comes prepackaged with assets that support your observability needs:
1920

2021
* Data ingestion, storage, and transformation rules
2122
* Configuration options
2223
* Pre-built, custom dashboards and visualizations
2324
* Documentation
2425

25-
::::
26-
27-
2826
::::{note}
29-
Be aware that some integrations may function differently across different spaces. Also, some might only work in the default space. We recommend reviewing the specific integration documentation for any space-related considerations.
30-
27+
Some integrations may function differently across different spaces, and some might only work in the default space. For any space-related considerations, review the documentation for the specific integration.
3128
::::
3229

30+
## Integration actions
3331

3432
The following table shows the main actions you can perform in the **Integrations** app in {{kib}}. You can perform some of these actions from other places in {{kib}}, too.
3533

@@ -44,9 +42,36 @@ The following table shows the main actions you can perform in the **Integrations
4442

4543
::::{note}
4644
The **Integrations** app in {{kib}} needs access to the public {{package-registry}} to discover integrations. If your deployment has network restrictions, you can [deploy your own self-managed {{package-registry}}](/reference/fleet/air-gapped.md#air-gapped-diy-epr).
47-
4845
::::
4946

5047
:::{tip}
5148
Once you've started using integrations to ingest data, you can customize how that data is managed over time. Refer to [Index lifecycle management](/reference/fleet/data-streams.md#data-streams-ilm) to learn more.
5249
:::
50+
51+
## Using {{agent}} integrations to collect OpenTelemetry data
52+
53+
```{applies_to}
54+
stack: preview 9.2
55+
```
56+
57+
{{fleet}} now supports installing {{agent}} integration input packages for collecting OpenTelemetry (OTel) data such as logs, metrics, and traces. To find the available OpenTelemetry (OTel) integrations, select the **OpenTelemetry** category on the **Integrations** page in {{kib}}.
58+
59+
Unlike {{agent}} integrations based on the [Elastic Common Schema](ecs://reference/index.md) (ECS), OTel integrations use OTel Collector receivers to collect OTel data following [OpenTelemetry semantic conventions](https://opentelemetry.io/docs/specs/semconv).
60+
61+
:::{important}
62+
OTel integrations are for use with {{Fleet}} and {{agent}} running in default mode. They are distinct from [running {{agent}} as an EDOT Collector](/reference/fleet/otel-agent.md).
63+
:::
64+
65+
### OTel integration configuration
66+
67+
To add an OTel integration in {{fleet}}, configure its integration policy similarly to how you would configure an ECS-based integration.
68+
69+
When the integration policy is created, assets such as pre-built dashboards and visualizations for OTel data are automatically installed if available.
70+
71+
{{fleet}} also creates a managed [index template](/manage-data/data-store/templates.md#index-templates) with an OTel configuration and an `.otel` suffix in its index pattern. The index template uses {{fleet}} [component templates](/manage-data/data-store/templates.md#component-templates) for settings and OTel component templates for default mappings. It also includes `@custom` component templates that allow you to [customize your Elasticsearch index](/reference/fleet/data-streams.md#data-streams-index-templates-edit) similarly to ECS-based integrations.
72+
73+
On the OTel integration's **Configs** page, you can view a generated sample configuration, which you can use as a starting point to set up the integration on a standalone {{agent}}.
74+
75+
:::{note}
76+
Currently, OTel integrations only support sending data using the {{es}} output.
77+
:::

0 commit comments

Comments
 (0)