Skip to content

Signal Spec

Canonical data model for operational intelligence.

What is Signal Spec?

Signal Spec defines the schemas and types for normalizing operational observations from diverse sources into a unified format. It enables correlation, root cause analysis, and remediation tracking across your operational landscape.

Core Entities

Entity Purpose
Signal Normalized operational observations (tickets, alerts, incidents, findings)
RootCause Persistent clustered issues with lifecycle tracking
Remediation Corrective actions with efficacy measurement
ValidationSignal Evidence of fix effectiveness

Data Flow

flowchart TD
    A[External Systems] --> B[Signal]
    B -->|LLM Analysis| C[RootCause]
    C --> D[Remediation]
    D --> E[ValidationSignal]
    E -->|Feedback Loop| C

Quick Start

Install CLI

go install github.com/plexusone/signal-spec/cmd/signal-spec@latest

Validate a Signal

signal-spec validate -t signal signal.json

Generate Report

signal-spec report -i rootcauses.json -o summary.xlsx

Key Features

  • Go types as source of truth - JSON schemas generated from Go structs
  • Lifecycle tracking - Monitor issues from detection through resolution
  • Closed-loop validation - Measure whether fixes actually work
  • Domain taxonomy - Categorize issues by domain/subdomain for prioritization
  • Impact metrics - Quantify customer and business impact

Installation

go get github.com/plexusone/signal-spec

Download schemas from GitHub releases or generate:

signal-spec schema generate -o ./schemas/

Next Steps