﻿---
title: System OpenTelemetry Assets
description: System OpenTelemetry Assets provides dashboards for vizualising OpenTelemetry hosts' metrics and logs. Collect and ingest OpenTelemetry data from the...
url: https://docs-v3-preview.elastic.dev/elastic/integration-docs/tree/main/reference/system_otel
---

# System OpenTelemetry Assets
|                                                                                                                                                       |                                                        |
|-------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------|
| **Version**Version                                                                                                                                    | 0.2.3 `product: beta` ([View all](#changelog)View all) |
| **Subscription level**Subscription level[What's this?](https://www.elastic.co/subscriptions)What's this?                                              | Basic                                                  |
| **Developed by**Developed by[What's this?](https://docs-v3-preview.elastic.dev/elastic/integration-docs/tree/main/reference/developed-by)What's this? | Elastic                                                |

<admonition title="The System OpenTelemetry Assets integration v0.2.3 is in beta">
  To use beta integrations, go to the **Integrations** page in Kibana, scroll down, and toggle on the _Display beta integrations_ option.
</admonition>

System OpenTelemetry Assets provides dashboards for vizualising OpenTelemetry hosts' metrics and logs.

## Requirements

Collect and ingest OpenTelemetry data from the Collector's [`hostmetrics` receiver](https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/v0.127.0/receiver/hostmetricsreceiver) through:
- the [Elastic Distributions of OpenTelemetry](https://www.elastic.co/docs/reference/opentelemetry/quickstart/)
- or using the vanilla / upstream OpenTelemetry Collector

Compatible `hostmetrics` receiver versions are all versions `>= v0.102.0`.
For full functionality of the dashboards included in this content pack, you will need to ensure the following metrics are enabled in the [`hostmetrics` receiver](https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/v0.127.0/receiver/hostmetricsreceiver):

| Metric                                      | Enabled by default in EDOT Collector | Enabled by default in upstream Contrib Collector |
|---------------------------------------------|--------------------------------------|--------------------------------------------------|
| ***CPU*****CPU**CPU                         |                                      |                                                  |
| `system.cpu.time`                           | ✅                                    | ✅                                                |
| `system.cpu.utilization`                    | ✅                                    | ❌                                                |
| `system.cpu.logical.count`                  | ✅                                    | ❌                                                |
| ***Load*****Load**Load                      |                                      |                                                  |
| `system.cpu.load_average.1m`                | ✅                                    | ✅                                                |
| `system.cpu.load_average.5m`                | ✅                                    | ✅                                                |
| `system.cpu.load_average.15m`               | ✅                                    | ✅                                                |
| ***Memory*****Memory**Memory                |                                      |                                                  |
| `system.memory.usage`                       | ✅                                    | ✅                                                |
| `system.memory.utilization`                 | ✅                                    | ❌                                                |
| ***Network*****Network**Network             |                                      |                                                  |
| `system.network.connections`                | ✅                                    | ✅                                                |
| `system.network.dropped`                    | ✅                                    | ✅                                                |
| `system.network.errors`                     | ✅                                    | ✅                                                |
| `system.network.io`                         | ✅                                    | ✅                                                |
| `system.network.packets`                    | ✅                                    | ✅                                                |
| ***Disk*****Disk**Disk                      |                                      |                                                  |
| `system.disk.io`                            | ✅                                    | ✅                                                |
| `system.disk.io_time`                       | ✅                                    | ✅                                                |
| `system.disk.operations`                    | ✅                                    | ✅                                                |
| ***File System*****File System**File System |                                      |                                                  |
| `system.filesystem.usage`                   | ✅                                    | ✅                                                |
| ***Processes*****Processes**Processes       |                                      |                                                  |
| `system.processes.count`                    | ✅                                    | ✅                                                |
| `system.processes.created`                  | ✅                                    | ✅                                                |

For step-by-step instructions on how to ingest OpenTelemetry data using Elastic's distribution of the OpenTelemetry Collector, see the
[quickstart guide](https://www.elastic.co/docs/reference/opentelemetry/quickstart/).
Also, it's recommended to enable the *`resourcedetection` processor* with detection of the following resource attributes explicitly enabled:
- `host.name`
- `host.id`
- `host.arch`
- `host.ip`
- `host.mac`
- `host.cpu.vendor.id`
- `host.cpu.family`
- `host.cpu.model.id`
- `host.cpu.model.name`
- `host.cpu.stepping`
- `host.cpu.cache.l2.size`
- `os.description`
- `os.type`


## Troubleshooting

If individual widgets in the dashboard show errors that certain fields are not evailable, that might be an indicator of one of the following:
- For your use case the missing data is not relevant (e.g. you are only running plain, local VMs, no `Cloud` metadata will be available)
- You are using the OpenTelemetry upstream Contrib Collector (or any other, non-EDOT Collector) and some of the above-mentioned requirements are not met

See also:
- [Scraper limitations](https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/v0.127.0/receiver/hostmetricsreceiver#host-metrics-receiver) with the `hostmetrics` receiver for certain systems
- [Related EDOT Collector limitations](https://www.elastic.co/docs/reference/opentelemetry/compatibility/limitations#infrastructure-and-host-metrics) for host metrics


## Screenshots

This integration includes one or more Kibana dashboards that visualizes the data collected by the integration. The screenshots below illustrate how the ingested data is displayed.
<carousel>
  ![Host Details Metrics](https://epr.elastic.co/package/system_otel/0.2.3/img/metrics.png)

  ![Host Details Logs](https://epr.elastic.co/package/system_otel/0.2.3/img/logs-view.png)
</carousel>


## Changelog

<dropdown title="Changelog">
  | Version        | Details                                                                                                                                                                              | Kibana version(s) |
  |----------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------|
  | **0.2.3**0.2.3 | **Bug fix**Bug fix ([View pull request](https://github.com/elastic/integrations/pull/15615)View pull request)Use `metrics-*` index pattern for dataviews                             |                   |
  | **0.2.2**0.2.2 | **Enhancement**Enhancement ([View pull request](https://github.com/elastic/integrations/pull/15615)View pull request)Add `opentelemetry` category                                    |                   |
  | **0.2.1**0.2.1 | **Bug fix**Bug fix ([View pull request](https://github.com/elastic/integrations/pull/15509)View pull request)Remove adhoc dataviews                                                  |                   |
  | **0.2.0**0.2.0 | **Enhancement**Enhancement ([View pull request](https://github.com/elastic/integrations/pull/14770)View pull request)Add discovery datasets field                                    |                   |
  | **0.1.0**0.1.0 | **Enhancement**Enhancement ([View pull request](https://github.com/elastic/integrations/pull/14400)View pull request)Initial version of the System OpenTelemetry Assets content pack |                   |
</dropdown>