You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{agent}} integrations provide a unified way to collect data from apps and services and to protect systems from security threats.
12
16
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).
15
18
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:
19
20
20
21
* Data ingestion, storage, and transformation rules
21
22
* Configuration options
22
23
* Pre-built, custom dashboards and visualizations
23
24
* Documentation
24
25
25
-
::::
26
-
27
-
28
26
::::{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.
31
28
::::
32
29
30
+
## Integration actions
33
31
34
32
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.
35
33
@@ -44,9 +42,36 @@ The following table shows the main actions you can perform in the **Integrations
44
42
45
43
::::{note}
46
44
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
-
48
45
::::
49
46
50
47
:::{tip}
51
48
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.
52
49
:::
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.
0 commit comments