Playbook case study - Firmware log analytics

Case study: a pilot firmware rollout starts filling support tickets.

A pilot cohort is running a new build and support starts seeing repeated sensor timeout errors. For devices still checking in, use Dataplicity to connect log signatures to firmware version, class, rollout cohort, incidents, and remote diagnostics.

  • Find the error signature across device logs.
  • Correlate matches with version, class, and rollout cohort.
  • Use remote checks only on devices that are online in Dataplicity.
  • Hold or roll back the rollout with evidence attached.

What the operator knows

The support queue has several reports, but nobody knows whether the issue is widespread.

Signal

Support keeps seeing the same timeout

The phrase is visible in tickets, but tickets do not reveal the affected cohort or firmware version.

Context

The issue may align with a rollout

Dataplicity keeps version, class, tags, events, and logs tied to the same device record.

Decision

Engineering must decide whether to pause

The decision needs evidence, not anecdotes.

CLI investigation walkthrough

Query the signature, correlate affected devices, then preserve the evidence.

01 - Signature

Search logs for the repeated error

Start with the phrase support saw and let Dataplicity return device-aware matches.

Find matching logs
$ dataplicity logs query "sensor read timeout" --last 6h --group-by device
devices=42
matches=389
top_device=<device>
first_seen=14:08

The issue is broader than one support ticket and has a clear first-seen time.

02 - Correlate

Group matches by version and class

Logs know product context, not just text.

Summarize by context
$ dataplicity logs query "sensor read timeout" --last 6h --group-by firmware,class,rollout
FIRMWARE   CLASS      ROLLOUT      DEVICES
<version>  <class>    pilot-west   42
previous   <class>    stable       0

The failure maps to the pilot rollout rather than the whole fleet.

03 - Evidence

Attach analysis to a rollout incident

Engineering and support need the same proof when deciding to pause or roll back.

Save investigation
$ dataplicity incidents create --title "Pilot rollout sensor timeout" --from-query <query>
incident=<incident>
evidence=log-query,affected-devices,version-summary
status=open

The incident carries the affected version, devices, and log proof for the rollback decision.

Operational conclusion

Move from log search to rollout control and customer messaging.

Pause

Hold the pilot rollout

The affected cohort is known, so engineering can stop expansion without guessing.

Target

Create a rollback cohort

Use class, version, and rollout tags to target exactly the affected units.

Inform

Share impact with support

Support sees the same device list, incident notes, and customer-safe summary.

Turn logs into product decisions.

Use Dataplicity to correlate errors with device class, version, rollout, incidents, and remote diagnostics.