# Azure Blob Storage

### 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                                                                                                                              |

<mark style="color:red;">\*</mark>*<mark style="color:red;">required field</mark>*

### 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**

<figure><img src="https://1405008107-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgmiOMzBfoNFwmKJFHMcJ%2Fuploads%2Fgit-blob-7f2087991adcf7e20ee8c98fd97f0e8f53ee3973%2Fintegrations-sources-azure-blob-storage-image-1.png?alt=media" alt="Bindplane docs - Azure Blob Storage - image 1"><figcaption></figcaption></figure>

**Standalone Source**

```yaml
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'
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.bindplane.com/integrations/sources/azure-blob-storage.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.