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

# Honeycomb Telemetry Pipeline Agent

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

## Description

Monitor the logs of the Honeycomb Telemetry Pipeline agent the config is applied to.

## Supported Platforms

HTP Agent: `v1.40.0`+

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

### Configuration

| Field                      | Description                                                                                                                                     |
| :------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------- |
| Agent Log Path             | The absolute path to the bindplane-agent log. Default is `$OIQ_OTEL_COLLECTOR_HOME/log/collector.log`.                                          |
| Enable File Offset Storage | When enabled, the current position into a file will be saved to disk, and reading will resume from where it left off after a collector restart. |
| Offset Storage Directory   | The directory that the offset storage file will be created. Default is `$OIQ_OTEL_COLLECTOR_HOME/storage`.                                      |
| Start At                   | Where in the log file to begin reading logs from. Can be `beginning` or `end`.                                                                  |

## Example Configuration

### Basic Configuration

For basic configuration, the defaults are used.

#### Web Interface

<img src="https://mintcdn.com/honeycomb/xBk0WdKAt1ctZm35/_assets/images/htp/xnapper-bindplane-agent-source.png?fit=max&auto=format&n=xBk0WdKAt1ctZm35&q=85&s=e2c3d8ebb17abb8daa8b4adb33af85b3" alt="Honeycomb Docs - HTP Agent Source - image 1" width="2176" height="2058" data-path="_assets/images/htp/xnapper-bindplane-agent-source.png" />

#### Standalone Source

```yaml theme={}
apiVersion: bindplane.observiq.com/v1
kind: Source
metadata:
  id: bindplane-agent
  name: bindplane-agent
spec:
  type: bindplane-agent
  parameters:
    - name: log_path
      value: '$OIQ_OTEL_COLLECTOR_HOME/log/collector.log'
    - name: enable_offset_storage
      value: true
    - name: offset_storage_dir
      value: '$OIQ_OTEL_COLLECTOR_HOME/storage'
    - name: start_at
      value: 'end'
```
