> ## Documentation Index
> Fetch the complete documentation index at: https://botmesh.afaya.com.co/llms.txt
> Use this file to discover all available pages before exploring further.

# TelemetryConfig

> Interface exported by @botmesh/core.

Defined in: [telemetry/types.ts:136](https://github.com/andresayac/botmesh/blob/main/packages/core/src/telemetry/types.ts#L136)

`BotConfig.telemetry` (opt-in): where spans go and what they may contain.

## Properties

### tracer

```ts theme={null}
tracer: BotTracer;
```

Defined in: [telemetry/types.ts:137](https://github.com/andresayac/botmesh/blob/main/packages/core/src/telemetry/types.ts#L137)

***

### ids?

```ts theme={null}
ids?: "hash" | "raw" | "omit";
```

Defined in: [telemetry/types.ts:144](https://github.com/andresayac/botmesh/blob/main/packages/core/src/telemetry/types.ts#L144)

How chat, sender and message ids appear on spans:

* `'hash'` (default): HMAC-SHA256 with [idKey](#idkey), base64url, 16 chars;
* `'raw'`: the opaque id as the provider gave it (personal data on most channels);
* `'omit'`: not recorded.

***

### idKey?

```ts theme={null}
idKey?: string | Uint8Array<ArrayBufferLike>;
```

Defined in: [telemetry/types.ts:149](https://github.com/andresayac/botmesh/blob/main/packages/core/src/telemetry/types.ts#L149)

HMAC key of `ids: 'hash'`. Default: 32 random bytes per process, so hashes do not
correlate across replicas or restarts — set it from a secret for that.

***

### errorMessages?

```ts theme={null}
errorMessages?: boolean;
```

Defined in: [telemetry/types.ts:151](https://github.com/andresayac/botmesh/blob/main/packages/core/src/telemetry/types.ts#L151)

Record `Error.message` on spans (it may contain user text). Default `false`: error name and code only.

***

### spans?

```ts theme={null}
spans?: object;
```

Defined in: [telemetry/types.ts:153](https://github.com/andresayac/botmesh/blob/main/packages/core/src/telemetry/types.ts#L153)

Granularity toggles. Defaults: `persist` true, `pace` true, `streamUpdates` false (stream edits are span events).

#### persist?

```ts theme={null}
persist?: boolean;
```

#### pace?

```ts theme={null}
pace?: boolean;
```

#### streamUpdates?

```ts theme={null}
streamUpdates?: boolean;
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.