Skip to main content
Challenge

Build a Sparkplug B Industrial Network Outage Triage Reconciler

Evaluate simulated Sparkplug B edge node state transitions and death certificates to localize network outages. Formulate step-by-step recovery rehearsal playbooks for OT personnel.

EngineeringHosted by Vera
Challenge brief

What you are building

The core problem, expected build, and operating context for this challenge.

Evaluate simulated Sparkplug B edge node state transitions and death certificates to localize network outages. Formulate step-by-step recovery rehearsal playbooks for OT personnel.

OT Network Systems Specialist

Ingest MQTT Sparkplug B edge node lifecycle events including NDEATH and NBIRTH messages.

Map communication dropouts against switch topology to identify common failure domains.

Simulate recovery step sequencing to avoid reconnection storms across edge nodes.

Publish an outage post-mortem and network recovery rehearsal playbook.

Network topology graph showing edge node death timestamps, affected switch zones, and recovery rehearsal plan.

Simulated Sparkplug B telemetry packets containing seq numbers, NDEATH payloads, and bdSeq metrics. Starter examples below are synthetic. They are not downloaded records.

Eclipse Sparkplug Leverages Sparkplug B state management, particularly bdSeq counters, NDEATH payloads, and edge node lifecycle tracking.

langgraph, networkx, pydantic. LangGraph manages stateful traversal through multi-switch topology failure graphs and recovery phases. Local or hosted LLM with strong logical troubleshooting and network topology reasoning.

Submit runnable source, pinned dependencies, setup commands, a working interface, example outputs, and a recorded end-to-end demo. Include tests and an action log.

Correlates NDEATH burst events to single upstream network switches.

Validates bdSeq sequence continuity during node reconnection simulations.

Generates an ordered recovery procedure minimizing simultaneous MQTT connection spikes.

```json [ { "input": { "broker": "tcp://broker.factory.local:1883", "outage_events": [ { "timestamp": "2025-05-10T14:02:00Z", "topic": "spBv1.0/Plant1/NDEATH/LineA_Cell1", "bdSeq": 4 }, { "timestamp": "2025-05-10T14:02:01Z", "topic": "spBv1.0/Plant1/NDEATH/LineA_Cell2", "bdSeq": 8 } ], "switch_topology": { "Switch_Core": [ "Switch_LineA" ], "Switch_LineA": [ "LineA_Cell1", "LineA_Cell2" ] } }, "expected_output": { "isolated_fault_location": "Switch_LineA", "affected_nodes_count": 2, "rehearsal_sequence": [ "Inspect Switch_LineA power/link", "Verify Switch_Core trunk", "Restore LineA_Cell1 then Cell2 staggered by 5s" ], "reconnection_storm_risk": "LOW" } }, { "input": { "broker": "tcp://broker.factory.local:1883", "outage_events": [ { "timestamp": "2025-05-10T15:00:00Z", "topic": "spBv1.0/Plant1/NDEATH/Warehouse_Sensors", "bdSeq": 12 } ], "switch_topology": { "Switch_Core": [ "Switch_LineA", "Switch_Warehouse" ], "Switch_Warehouse": [ "Warehouse_Sensors" ] } }, "expected_output": { "isolated_fault_location": "Warehouse_Sensors edge link", "affected_nodes_count": 1, "rehearsal_sequence": [ "Check local patch cable at Warehouse_Sensors", "Verify edge node bdSeq re-birth" ], "reconnection_storm_risk": "NONE" } } ] ```

Operates entirely on historical or mock telemetry; no remote network reconfiguration. Use mock external writes. Require human review before any real deployment.

Rules

Participation guide

Operates entirely on historical or mock telemetry; no remote network reconfiguration. Use mock external writes and human review.

Delivery guide

How work is evaluated

Evaluation

Correlates NDEATH burst events to single upstream network switches. Validates bdSeq sequence continuity during node reconnection simulations. Generates an ordered recovery procedure minimizing simultaneous MQTT connection spikes.

Submission format

Runnable source, pinned dependencies, setup commands, working interface, example outputs, recorded demo, tests, and action logs.

Datasets

Challenge datasets

Public datasets, plus the private datasets you have access to.

Evaluation rubric

How submissions are scored

These dimensions define what the evaluator checks and which criteria separate a passable run from a strong one.

Dimensions
4 scoring checks
Binary
1 pass or fail dimensions
Ordinal
3 scaled dimensions
Dimension 1

Complete workflow

Ingest MQTT Sparkplug B edge node lifecycle events including NDEATH and NBIRTH messages. Map communication dropouts against switch topology to identify common failure domains. Simulate recovery step sequencing to avoid reconnection storms across edge nodes. Publish an outage post-mortem and network recovery rehearsal playbook.

Score scale
012
Score 0

Missing or incorrect.

Score 1

Partly complete, with documented gaps.

Score 2

Complete, with reproducible evidence.

Dimension 2

Correctness and evidence

Correlates NDEATH burst events to single upstream network switches. Validates bdSeq sequence continuity during node reconnection simulations. Generates an ordered recovery procedure minimizing simultaneous MQTT connection spikes.

Score scale
012
Score 0

Missing or incorrect.

Score 1

Partly complete, with documented gaps.

Score 2

Complete, with reproducible evidence.

Dimension 3

Review interface

Network topology graph showing edge node death timestamps, affected switch zones, and recovery rehearsal plan.

Score scale
012
Score 0

Missing or incorrect.

Score 1

Partly complete, with documented gaps.

Score 2

Complete, with reproducible evidence.

Dimension 4

Safe execution

Operates entirely on historical or mock telemetry; no remote network reconfiguration.

Binary check

This dimension contributes its full weight only when the submission satisfies the requirement. Partial credit is not awarded.

Learning goals

What you should walk away with

  • Ingest MQTT Sparkplug B edge node lifecycle events including NDEATH and NBIRTH messages.

  • Map communication dropouts against switch topology to identify common failure domains.

  • Simulate recovery step sequencing to avoid reconnection storms across edge nodes.

  • Publish an outage post-mortem and network recovery rehearsal playbook.

Resources and assets

Reference links and supporting material

Dataset notes

Simulated Sparkplug B telemetry packets containing seq numbers, NDEATH payloads, and bdSeq metrics. Supplied starter examples are synthetic, not source extracts.

Challenge setup

Configuration summary for this challenge.

Challenge input

Input details are not configured.

LangGraph

Runtime for stateful agent workflows.

Evaluated output

No output checks are configured.

Evaluation checks
  • Ingest MQTT Sparkplug B edge node lifecycle events including NDEATH and NBIRTH messages. Map communication...
  • Correlates NDEATH burst events to single upstream network switches. Validates bdSeq sequence continuity dur...
  • Network topology graph showing edge node death timestamps, affected switch zones, and recovery rehearsal plan.
Configured evaluation evidence
  • 2 public reference cases
Configured runtime
  • 2 configured tools

Summary shows the first task, up to three tools, and up to three evidence items. Open the technical recipe to view all configured items.

View technical recipe

Configured tools

Action Space
  • LangGraph · Optional
Orchestration
  • LangGraph · Optional

Evaluation contract

  • Complete workflow · Weight 40
  • Correctness and evidence · Weight 30
  • Review interface · Weight 20
  • Safe execution · Weight 10

Reference cases

  • 2 public reference cases

Workflow tasks

No workflow tasks are configured.

Recipe freeze marker

No recipe freeze time is recorded.

Frequently Asked Questions about Build a Sparkplug B Industrial Network Outage Triage Reconciler