Skip to content

Synthetic Open Schema

  • Portable


    Write checks once, run on any compatible runner. No vendor lock-in.

  • Declarative


    YAML-based, Kubernetes-style configuration. Easy to read and write.

  • Production Ready


    Stable v1.0.0 specification. Battle-tested in production environments.

  • Open Source


    Apache 2.0 licensed. Community-driven, vendor-neutral standard.


What is Synthetic Open Schema?

Synthetic Open Schema (SOS) is an open specification that defines a vendor-neutral format for synthetic monitoring checks. It enables you to define your monitoring checks once and run them anywhere.

Get Started Read Specification View on GitHub


Quick Example

api-health-check.yaml
apiVersion: v1
kind: HttpCheck
metadata:
  name: api-health-check
  title: API Health Check
spec:
  url: https://api.example.com/health
  method: GET
  interval: 1m
  timeout: 30s
  checks:
    - type: statusCode
      value: 200
    - type: responseTime
      operator: lessThan
      value: 500ms

See more examples →


Supported Check Types

Core Checks (apiVersion: v1)

  • HttpCheck


    Monitor HTTP/HTTPS endpoints with status codes, headers, response times, and body validation.

    Learn more

  • TcpCheck


    Validate TCP port connectivity and optional response content.

    Learn more

  • DnsCheck


    Verify DNS resolution for A, AAAA, CNAME, MX, TXT, NS, and PTR records.

    Learn more

  • TlsCheck


    Monitor TLS/SSL certificates for expiration, validity, and custom CAs.

    Learn more

  • DomainCheck


    Track domain registration, expiration, nameservers, and WHOIS data.

    Learn more

Browser Checks (apiVersion: browser/v1)

  • LoadCheck


    Monitor page load performance with real browsers. Track FCP, LCP, and network timing.

    Learn more

  • ScriptedCheck


    Execute custom browser automation scripts with Playwright-based scripting.

    Learn more


Implementations

Official

Python Model
pip install synthetic-open-schema-model
Python Runner
pip install synthetic-open-schema-runner

View all implementations


Open Source

Licensed under Apache License 2.0. Stewarded by Ideatives Inc.

Contributing Guide Governance Security