﻿---
title: StatsD OpenTelemetry Input Package
description: The StatsD OpenTelemetry Input Package for Elastic enables collection of metrics from StatsD-compatible applications through OpenTelemetry protocols using...
url: https://www.elastic.co/docs/reference/integrations/statsd_input_otel
products:
  - Elastic integrations
applies_to:
  - Serverless Observability projects: Preview
  - Serverless Security projects: Preview
  - Elastic Stack: Preview since 9.3
---

# StatsD OpenTelemetry Input Package
|                                                                                                 |                                                                   |
|-------------------------------------------------------------------------------------------------|-------------------------------------------------------------------|
| **Version**                                                                                     | 0.1.0 <applies-to>: Preview</applies-to> ([View all](#changelog)) |
| **Subscription level**[What's this?](https://www.elastic.co/subscriptions)                      | Basic                                                             |
| **Developed by**[What's this?](https://www.elastic.co/docs/reference/integrations/developed-by) | Elastic                                                           |
| **Minimum Kibana version(s)**                                                                   | 9.3.19.2.6                                                        |

<admonition title="The StatsD OpenTelemetry Input Package integration v0.1.0 is in technical preview">
  To use pre-release integrations, go to the **Integrations** page in Kibana, scroll down, and toggle on the _Display beta integrations_ option.
</admonition>


## Overview

The StatsD OpenTelemetry Input Package for Elastic enables collection of metrics from StatsD-compatible applications through OpenTelemetry protocols using the [statsdreceiver](https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/main/receiver/statsdreceiver#statsd-receiver).

### How it works

This package receives telemetry data from StatsD-compatible applications by configuring the StatsD endpoint in the Input Package, which then gets applied to the statsdreceiver present in the EDOT collector, which then forwards the data to Elastic Agent. The Elastic Agent processes and enriches the data before sending it to Elasticsearch for indexing and analysis.
The StatsD receiver listens on a UDP (default), TCP, or Unix socket endpoint for incoming StatsD messages and parses them into OTLP equivalent metric representations.

### Supported metric types

<definitions>
  <definition term="Counter (c)">
    Measurement which accumulates over period of time until flushed.
  </definition>
  <definition term="Gauge (g)">
    Measurement which can increase, decrease or be set to a value.
  </definition>
  <definition term="Timer (ms)">
    Time measurement (in milliseconds) of an event.
  </definition>
  <definition term="Histogram (h)">
    Time measurement, alias for timer.
  </definition>
</definitions>


### Supported tag extensions

The StatsD receiver supports the following tag formats:
**DogStatsD**
`<metric name>:<value>|<type>|@<sample-rate>|#<tag-key>:<tag-value>,<tag-key>:<tag-value>`
**InfluxDB**
`<metric name>,<tag-key>=<tag-value>,<tag-key>=<tag-value>:<value>|<type>|@<sample-rate>`
**Graphite 1.1.x**
`<metric name>;<tag-key>=<tag-value>;<tag-key>=<tag-value>:<value>|<type>|@<sample-rate>`

## Configuration

For the full list of settings exposed for the receiver and examples, refer to the [configuration](https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/main/receiver/statsdreceiver#configuration) section.

## Metrics reference

For a complete list of all available metrics and their detailed descriptions, refer to the [StatsD Receiver documentation](https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/main/receiver/statsdreceiver) in the upstream OpenTelemetry Collector repository.

## Changelog

<dropdown title="Changelog">
  | Version   | Details                                                                                                               | Minimum Kibana version |
  |-----------|-----------------------------------------------------------------------------------------------------------------------|------------------------|
  | **0.1.0** | **Enhancement** ([View pull request](https://github.com/elastic/integrations/pull/17109))Initial draft of the package | 9.3.19.2.6             |
</dropdown>