Observability — data model

Generated from the architecture model

This page is rendered from model/**/*.yaml by tools/docs_model during mkdocs build. Edit the YAML, not this page; hand-written design lives on the linked service, platform and plane pages.

AlertRuleService

erDiagram
    AlertRule {
        guid ruleId PK
        string tenantId
        string name
        enum_AlertSourceKind sourceKind
        json condition
        enum_AlertSeverity severity
        string dedupKeyTemplate
        json routes
        json suppression
        bool active
    }
    AlertInstance {
        guid alertId PK
        string tenantId
        guid ruleId
        string dedupKey
        enum_AlertSeverity severity
        string sourceRef
        enum_AlertState state
        datetime firedAt
        string acknowledgedBy
        datetime resolvedAt
        json notifications
    }

Hold "Alt" / "Option" to enable pan & zoom

Tables: dbo.AlertRules, dbo.AlertInstances — see the DDL appendix.

DashboardService

erDiagram
    RunProjection {
        guid runId PK
        string tenantId
        string projectId
        string workflowId
        string state
        int steps
        int attempts
        int modelCalls
        int toolCalls
        int approvalsWaiting
        int uncertainEffects
        long tokens
        json costUsdByStatus
        long durationMs
        string traceId
        long lastEventSequence
        datetime updatedAt
    }
    OverviewProjection {
        guid overviewId PK
        string tenantId
        enum_ProjectionKind kind
        string subjectId
        string window
        json metrics
        datetime computedAt
    }
    TimelineEntry {
        long sequence

        string kind

        string reference

        string summary

        datetime occurredAt

        long durationMs

        decimal costUsd

    }
    RunProjection ||--o{ TimelineEntry : contains

Hold "Alt" / "Option" to enable pan & zoom

TimelineEntry (entity)

One event on the run timeline (the §51 trace tree as rows).

Field	Type	Required	Description
sequence	long	yes
kind	string	yes	run
reference	string	yes	Receipt, snapshot, approval or decision id.
summary	string	yes
occurredAt	datetime	yes
durationMs	long	no
costUsd	decimal	no

Tables: dbo.RunProjections, dbo.TimelineEntries, dbo.ProjectionCheckpoints, dbo.OverviewProjections — see the DDL appendix.

FeedbackService

erDiagram
    HumanFeedback {
        guid feedbackId PK
        string tenantId
        string projectId
        string subjectKind
        string subjectRef
        enum_FeedbackKind kind
        int rating
        string commentRef
        string correctedArtifactRef
        string givenBy
        datetime givenAt
    }
    Dataset {
        guid datasetId PK
        string tenantId
        string name
        string target
        int version
        int taskCount
        string snapshotRef
        string classification
        datetime publishedAt
    }
    LearningProposal {
        guid proposalId PK
        string tenantId
        enum_ProposalKind kind
        string targetAssetId
        string targetVersion
        string summaryRef
        list_string evidenceRefs
        json expectedEffect
        enum_ProposalState state
        string reviewedBy
        string resultingReleaseId
        datetime raisedAt
    }

Hold "Alt" / "Option" to enable pan & zoom

Tables: dbo.HumanFeedback, dbo.Datasets, dbo.DatasetTasks, dbo.LearningProposals — see the DDL appendix.

QualityScoreService

erDiagram
    EvaluationSuite {
        string suiteId PK
        string version
        string releaseId
        string tenantId
        enum_EvaluationTarget target
        guid datasetId
        json metrics
        json baselineRule
        json budgets
        bool active
    }
    EvaluationRun {
        guid evaluationId PK
        string tenantId
        string suiteId
        string suiteVersion
        string targetReleaseId
        string baselineReleaseId
        string datasetSnapshotRef
        enum_EvaluationState state
        json results
        enum_Verdict verdict
        guid waiverApprovalId
        decimal costUsd
        long durationMs
        string evidenceRef
        datetime startedAt
        datetime completedAt
    }

Hold "Alt" / "Option" to enable pan & zoom

Tables: dbo.EvaluationSuites, dbo.EvaluationRuns, dbo.EvaluationResults — see the DDL appendix.

SloService

erDiagram
    SloDefinition {
        guid sloId PK
        string tenantId
        string subjectKind
        string subjectId
        enum_ObjectiveKind kind
        decimal target
        string window
        json burnAlertThresholds
        string source
        bool active
    }
    ServiceHealth {
        string hostId PK
        string tenantId
        enum_HealthState state
        json dependencies
        int replicasReady
        datetime observedAt
    }
    SloMeasurement {
        datetime measuredAt

        decimal value

        decimal errorBudgetRemaining

        decimal burnRate

        enum_SloState state

    }
    SloDefinition ||--o{ SloMeasurement : contains

Hold "Alt" / "Option" to enable pan & zoom

SloMeasurement (entity)

One evaluation of the objective.

Field	Type	Required	Description
measuredAt	datetime	yes
value	decimal	yes
errorBudgetRemaining	decimal	yes
burnRate	decimal	yes
state	enum:SloState	yes

Tables: dbo.SloDefinitions, dbo.SloMeasurements, dbo.ServiceHealth — see the DDL appendix.