> ## Documentation Index
> Fetch the complete documentation index at: https://docs.honeycomb.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Azure Blob Storage

<Badge className="hny-badge-enterprise-addon" stroke>Ent+</Badge>

<Note>
  This feature is available as an add-on for the [Honeycomb Enterprise plan](https://www.honeycomb.io/pricing/).
  Please contact your Honeycomb account team for details.
</Note>

## Prerequisites

Setup an Event Hub to listen for `Blob Create` events. More information on how to set this up can be found in the Azure documentation [here](https://learn.microsoft.com/en-us/azure/storage/blobs/storage-blob-event-overview).

## Blob Format

Stored logs and traces must be in [OTLP JSON format](https://github.com/open-telemetry/opentelemetry-proto#otlpjson) in order to be correctly parsed by the receiver.

## Supported Platforms

| Platform | Metrics | Logs | Traces |
| :------- | :------ | :--- | :----- |
| Linux    |         | ✓    | ✓      |
| Windows  |         | ✓    | ✓      |
| macOS    |         | ✓    | ✓      |

## Configuration Table

| Parameter              | Type                | Default              | Description                                                                                                                                                                              |
| :--------------------- | :------------------ | :------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| telemetry\_types       | `telemetrySelector` | `["Logs", "Traces"]` | Choose Telemetry Type.                                                                                                                                                                   |
| connection\_string\*   | `string`            | ""                   | The connection string for the Azure Storage account. Information can be found [here](https://learn.microsoft.com/en-gb/azure/storage/common/storage-configure-connection-string).        |
| event\_hub\_endpoint\* | `string`            | ""                   | The Azure Event Hub endpoint triggering on the `Blob Create` events. Information can be found [here](https://learn.microsoft.com/en-us/azure/storage/blobs/storage-blob-event-overview). |
| logs\_container\*      | `string`            | "logs"               | Name of the Azure Storage container where logs are stored.                                                                                                                               |
| traces\_container\*    | `string`            | "traces"             | Name of the Azure Storage container where traces are stored                                                                                                                              |

<span style={{color: 'red'}}>\* *required field*</span>

## Example Configuration

### Basic Configuration

For basic configuration only, the `connection_string` for Azure Storage and the `event_hub_endpoint` need to be supplied. In the example below, we are using a fake `connection_string` and `event_hub_endpoint` in the form Azure expects.

#### Web Interface

<img src="https://mintcdn.com/honeycomb/xBk0WdKAt1ctZm35/_assets/images/htp/xnapper-azure-blob-source.png?fit=max&auto=format&n=xBk0WdKAt1ctZm35&q=85&s=fff0d3e3dd8f24c0c51f2ed39cca04bd" alt="Honeycomb Docs - Azure Blob Storage - image 1" width="2172" height="2034" data-path="_assets/images/htp/xnapper-azure-blob-source.png" />

#### Standalone Source

```yaml YAML theme={}
apiVersion: bindplane.observiq.com/v1
kind: Source
metadata:
  id: azure_blob
  name: azure_blob
spec:
  type: azure_blob
  parameters:
    - name: connection_string
      value: 'DefaultEndpointsProtocol=https;AccountName=accountName;AccountKey=+idLkHYcL0MUWIKYHm2j4Q==;EndpointSuffix=core.windows.net'
    - name: event_hub_endpoint
      value: 'Endpoint=sb://oteldata.servicebus.windows.net/;SharedAccessKeyName=otelhubbpollicy;SharedAccessKey=mPJVubIK5dJ6mLfZo1ucsdkLysLSQ6N7kddvsIcmoEs=;EntityPath=otellhub'
```