Fleet Management
Purpose
Design the fleet management infrastructure for an IoT device fleet, including device provisioning, OTA firmware update strategy, telemetry aggregation, and fleet-scale monitoring.
Scope Constraints
Produces fleet architecture recommendations covering provisioning, OTA, telemetry, and monitoring. Does not provision actual devices, deploy cloud infrastructure, or manage live certificates. Does not execute firmware builds or signing operations.
Inputs
- Expected fleet size (current and projected)
- Device hardware capabilities (storage, connectivity, compute)
- Update frequency requirements
- Monitoring and alerting requirements
- Regulatory requirements (safety-critical updates, rollback mandates)
Input Sanitization
No user-provided values are used in commands or file paths. All inputs are treated as read-only analysis targets.
Procedure
Step 1: Design Device Provisioning
Plan how devices go from factory to operational:
- Identity: Unique device ID (hardware serial, provisioned certificate)
- Authentication: Device certificates (X.509), pre-shared keys, or cloud-provisioned tokens
- Registration flow: First-boot sequence, cloud registration, owner assignment
- Zero-touch: Can a device self-provision without manual intervention?
- Factory integration: What happens on the manufacturing line?
Step 2: Design OTA Update System
Plan the firmware update lifecycle:
- Partition scheme: A/B (dual partition for atomic swap), single with rollback region
- Update delivery: Pull (device checks periodically) vs push (server initiates)
- Delta updates: Full firmware image vs binary diff (saves bandwidth)
- Integrity verification: Cryptographic signature verification before applying
- Rollback mechanism: Automatic rollback if new firmware fails health check
- Staged rollout: Canary (1%) → early (10%) → general (100%) with hold gates
Step 3: Design Telemetry Pipeline
Plan how device data reaches the cloud:
- Data types: Health metrics (battery, signal, temperature), application data, error reports
- Aggregation: On-device pre-aggregation to reduce bandwidth (send averages, not raw samples)
- Transport: MQTT topics, HTTP batch uploads, or store-and-forward
- Cloud ingestion: Message broker → stream processing → storage
- Retention: Hot (real-time queries), warm (weekly), cold (archive)
Step 4: Design Monitoring and Alerting
Plan fleet-scale observability:
- Health dashboards: Fleet-wide metrics (online %, firmware version distribution, battery levels)
- Anomaly detection: Devices reporting unusual values, sudden offline clusters
- Alert thresholds: Battery < 10%, signal < -90dBm, error rate > 1%, offline > 24h
- Group operations: Query and act on device groups (by firmware version, region, owner)
Step 5: Design Remote Management
Plan remote device operations:
- Configuration updates: Push configuration changes without firmware update
- Remote diagnostics: Request debug logs, trigger self-test, read sensor state
- Remote actions: Reboot, factory reset, enter recovery mode
- Access control: Who can perform which operations on which devices
Step 6: Plan Scaling Strategy
Design for fleet growth:
- Connection management: Connection limits per broker, load balancing
- Update infrastructure: CDN for firmware binaries, rate limiting downloads
- Database design: Time-series storage for telemetry, device registry scaling
- Cost modeling: Per-device cloud cost at 1K, 10K, 100K, 1M devices
Progress Checklist
Compaction resilience: If context was lost during a long session, re-read the Inputs section to reconstruct what fleet is being designed, check the Progress Checklist for completed steps, then resume from the earliest incomplete step.
Output Format
# Fleet Management Architecture
## Provisioning Flow
[Factory] → [Flash firmware + certificate] → [First boot] → [Cloud registration] → [Owner assignment] → [Operational]
| Step | Method | Duration | Manual? |
|------|--------|----------|---------|
| Identity | X.509 certificate | Factory | No |
| Registration | MQTT first-connect | <30s | No |
| Owner assignment | QR code scan | User-initiated | Yes |
## OTA Update Strategy
| Aspect | Approach |
|--------|----------|
| Partition scheme | A/B dual-partition |
| Delivery | Pull, 6-hour check interval |
| Format | Delta updates (bsdiff) |
| Verification | Ed25519 signature |
| Rollback | Automatic on 3 failed health checks |
| Staged rollout | 1% → 10% → 50% → 100% with 24h holds |
## Telemetry Pipeline
[Device] → [MQTT] → [Message Broker] → [Stream Processor] → [Time-Series DB] → [Dashboard]
| Data Type | Frequency | Aggregation | Retention |
|-----------|-----------|-------------|-----------|
| Health | 5 min | On-device avg | 90 days |
| Errors | Event-driven | None | 1 year |
| Application | 30 sec | 1-min rollups | 30 days |
## Monitoring Dashboard
| Metric | Threshold | Alert |
|--------|-----------|-------|
| Fleet online % | < 95% | Warning |
| Firmware current % | < 80% | Info |
| Battery critical | < 5% | Critical |
| Error rate | > 1% | Warning |
## Scaling Projections
| Fleet Size | Monthly Cost | Key Bottleneck |
|-----------|-------------|----------------|
| 1,000 | $X | None |
| 10,000 | $X | MQTT connections |
| 100,000 | $X | Telemetry storage |
Handoff
- Hand off to embedded-architecture if firmware-level OTA partition or recovery mode design decisions arise during fleet planning.
- Hand off to operator/observability-design if cloud-side observability infrastructure needs deeper design beyond fleet dashboards.
Quality Checks
Evolution Notes
Converted and distributed by TomeVault — claim your Tome and manage your conversions.
1---2name: fleet-management3description: Use when designing fleet management infrastructure for IoT device fleets. Covers device provisioning, OTA firmware update strategy, telemetry pipeline design, fleet monitoring, remote management, and scaling projections. Do not use for firmware architecture (use embedded-architecture) or wireless protocol selection (use protocol-design).4---56# Fleet Management78## Purpose910Design the fleet management infrastructure for an IoT device fleet, including device provisioning, OTA firmware update strategy, telemetry aggregation, and fleet-scale monitoring.1112## Scope Constraints1314Produces fleet architecture recommendations covering provisioning, OTA, telemetry, and monitoring. Does not provision actual devices, deploy cloud infrastructure, or manage live certificates. Does not execute firmware builds or signing operations.1516## Inputs1718- Expected fleet size (current and projected)19- Device hardware capabilities (storage, connectivity, compute)20- Update frequency requirements21- Monitoring and alerting requirements22- Regulatory requirements (safety-critical updates, rollback mandates)2324## Input Sanitization2526No user-provided values are used in commands or file paths. All inputs are treated as read-only analysis targets.2728## Procedure2930### Step 1: Design Device Provisioning3132Plan how devices go from factory to operational:33- **Identity:** Unique device ID (hardware serial, provisioned certificate)34- **Authentication:** Device certificates (X.509), pre-shared keys, or cloud-provisioned tokens35- **Registration flow:** First-boot sequence, cloud registration, owner assignment36- **Zero-touch:** Can a device self-provision without manual intervention?37- **Factory integration:** What happens on the manufacturing line?3839### Step 2: Design OTA Update System4041Plan the firmware update lifecycle:42- **Partition scheme:** A/B (dual partition for atomic swap), single with rollback region43- **Update delivery:** Pull (device checks periodically) vs push (server initiates)44- **Delta updates:** Full firmware image vs binary diff (saves bandwidth)45- **Integrity verification:** Cryptographic signature verification before applying46- **Rollback mechanism:** Automatic rollback if new firmware fails health check47- **Staged rollout:** Canary (1%) → early (10%) → general (100%) with hold gates4849### Step 3: Design Telemetry Pipeline5051Plan how device data reaches the cloud:52- **Data types:** Health metrics (battery, signal, temperature), application data, error reports53- **Aggregation:** On-device pre-aggregation to reduce bandwidth (send averages, not raw samples)54- **Transport:** MQTT topics, HTTP batch uploads, or store-and-forward55- **Cloud ingestion:** Message broker → stream processing → storage56- **Retention:** Hot (real-time queries), warm (weekly), cold (archive)5758### Step 4: Design Monitoring and Alerting5960Plan fleet-scale observability:61- **Health dashboards:** Fleet-wide metrics (online %, firmware version distribution, battery levels)62- **Anomaly detection:** Devices reporting unusual values, sudden offline clusters63- **Alert thresholds:** Battery < 10%, signal < -90dBm, error rate > 1%, offline > 24h64- **Group operations:** Query and act on device groups (by firmware version, region, owner)6566### Step 5: Design Remote Management6768Plan remote device operations:69- **Configuration updates:** Push configuration changes without firmware update70- **Remote diagnostics:** Request debug logs, trigger self-test, read sensor state71- **Remote actions:** Reboot, factory reset, enter recovery mode72- **Access control:** Who can perform which operations on which devices7374### Step 6: Plan Scaling Strategy7576Design for fleet growth:77- **Connection management:** Connection limits per broker, load balancing78- **Update infrastructure:** CDN for firmware binaries, rate limiting downloads79- **Database design:** Time-series storage for telemetry, device registry scaling80- **Cost modeling:** Per-device cloud cost at 1K, 10K, 100K, 1M devices8182### Progress Checklist8384- [ ] Step 1: Device provisioning flow designed85- [ ] Step 2: OTA update system with rollback and staged rollout86- [ ] Step 3: Telemetry pipeline with aggregation and retention87- [ ] Step 4: Monitoring dashboards and alert thresholds defined88- [ ] Step 5: Remote management operations and access control89- [ ] Step 6: Scaling strategy with cost projections9091> **Compaction resilience**: If context was lost during a long session, re-read the Inputs section to reconstruct what fleet is being designed, check the Progress Checklist for completed steps, then resume from the earliest incomplete step.9293## Output Format9495```markdown96# Fleet Management Architecture9798## Provisioning Flow99```100[Factory] → [Flash firmware + certificate] → [First boot] → [Cloud registration] → [Owner assignment] → [Operational]101```102103| Step | Method | Duration | Manual? |104|------|--------|----------|---------|105| Identity | X.509 certificate | Factory | No |106| Registration | MQTT first-connect | <30s | No |107| Owner assignment | QR code scan | User-initiated | Yes |108109## OTA Update Strategy110| Aspect | Approach |111|--------|----------|112| Partition scheme | A/B dual-partition |113| Delivery | Pull, 6-hour check interval |114| Format | Delta updates (bsdiff) |115| Verification | Ed25519 signature |116| Rollback | Automatic on 3 failed health checks |117| Staged rollout | 1% → 10% → 50% → 100% with 24h holds |118119## Telemetry Pipeline120```121[Device] → [MQTT] → [Message Broker] → [Stream Processor] → [Time-Series DB] → [Dashboard]122```123124| Data Type | Frequency | Aggregation | Retention |125|-----------|-----------|-------------|-----------|126| Health | 5 min | On-device avg | 90 days |127| Errors | Event-driven | None | 1 year |128| Application | 30 sec | 1-min rollups | 30 days |129130## Monitoring Dashboard131| Metric | Threshold | Alert |132|--------|-----------|-------|133| Fleet online % | < 95% | Warning |134| Firmware current % | < 80% | Info |135| Battery critical | < 5% | Critical |136| Error rate | > 1% | Warning |137138## Scaling Projections139| Fleet Size | Monthly Cost | Key Bottleneck |140|-----------|-------------|----------------|141| 1,000 | $X | None |142| 10,000 | $X | MQTT connections |143| 100,000 | $X | Telemetry storage |144```145146## Handoff147148- Hand off to embedded-architecture if firmware-level OTA partition or recovery mode design decisions arise during fleet planning.149- Hand off to operator/observability-design if cloud-side observability infrastructure needs deeper design beyond fleet dashboards.150151## Quality Checks152153- [ ] Provisioning flow is zero-touch (no manual steps per device)154- [ ] OTA updates are cryptographically signed and verified155- [ ] Rollback is automatic — a bad update doesn't brick the fleet156- [ ] Staged rollout has hold gates between stages157- [ ] Telemetry pipeline handles device-side aggregation to reduce bandwidth158- [ ] Monitoring has defined thresholds and alert escalation paths159- [ ] Cost model scales linearly (not exponentially) with fleet size160161## Evolution Notes162<!-- Observations appended after each use -->163164---165> Converted and distributed by [TomeVault](https://tomevault.io/claim/dtsong) — claim your Tome and manage your conversions.166<!-- tomevault:4.0:skill_md:2026-04-13 -->