---
description: 'The shared device portion of metric-series identity uses only stable
  attributes: tenant.id, device.id, device.name, device.mac, device.model, and…'
---

# Signals

## Lens metrics

| OTLP name | Prometheus name | Meaning |
|---|---|---|
| `polylens.device.connected` | `polylens_device_connected` | Lens connection state |
| `polylens.device.last_detected_seconds` | `polylens_device_last_detected_seconds` | Age of the last detection |
| `polylens.device.last_config_request_seconds` | `polylens_device_last_config_request_seconds` | Age of the last configuration request |
| `polylens.device.firmware_info` | `polylens_device_firmware_info` | Current version and build |
| `polylens.device.firmware_current` | `polylens_device_firmware_current` | Installed version matches the latest available version |
| `polylens.device.active_calls` | `polylens_device_active_calls` | Active calls grouped by state |
| `polylens.stream.connected` | `polylens_stream_connected` | WebSocket connection state |

## Phone metrics

| OTLP name | Prometheus name | Meaning |
|---|---|---|
| `polyphone.uptime_seconds` | `polyphone_uptime_seconds` | Phone uptime |
| `polyphone.network.packets` | `polyphone_network_packets_total` | Monotonic RX/TX packet counts |
| `polyphone.line.registered` | `polyphone_line_registered` | Registration state per logical line |
| `polyphone.lines_total` | `polyphone_lines_total` | Logical line count after duplicate line-key records are collapsed |
| `polyphone.config_param_source` | `polyphone_config_param_source` | Source of an allowlisted configuration parameter |
| `polyphone.api_state` | `polyphone_api_state` | Full current-state enum: `state` is one of `ok`, `api_disabled`, `auth_failed` or `unreachable`; the current state is `1` and every noncurrent state is `0` |

## Metric series identity

The shared device portion of metric-series identity uses only stable attributes:
`tenant.id`, `device.id`, `device.name`, `device.mac`, `device.model`, and
`site.name` when available. Each metric can additionally have its documented
dimensions, such as `state` for `polyphone.api_state`. `net.host.ip` is
deliberately excluded: a device address can change, and it must not create a
new metric series. Consumers should treat this as the public metric identity
contract and must not group, alert, or join device metric series by IP address.

## Self-observability

Self-observability uses the `polylens2otel.*` namespace. The generated dashboard accounts for every metric in `spec/signal-catalog.json`.

At process start the exporter emits the `polylens2otel.startup` event with the
`version`, `commit`, and `build.date` attributes. `polylens2otel.build_info` is
a metric with the same build metadata.

## CDR logs

Each new CDR row is an OTLP log with `event.name=polylens.cdr`. CDR attributes are Loki structured metadata. Only `service_name` is a stream label, so query the stream first and filter the event afterward:

```logql
{service_name="polylens2otel"} | event_name="polylens.cdr"
```

`{event_name="polylens.cdr"}` returns no rows because `event_name` is not a stream label.

Rows without parseable event timestamps are dropped. Duration is computed from `startTime` and `endTime`; deduplication uses `deviceId + startTime` because Lens returns a null CDR ID.