Component Trace Session V1¶
Source schema: doc/schemas/component-trace-session.v1.schema.json
Host capture-session lifecycle and bounded counters.
Governing Basis¶
Project Lineage¶
Fields¶
| Field | Required | Shape | Description |
|---|---|---|---|
schema |
yes |
const: component-trace-session.v1 |
|
schema/v |
yes |
const: 1 |
|
session/ref |
yes |
ref: #/$defs/ref |
|
node/ref |
yes |
ref: #/$defs/ref |
|
observation/generation |
yes |
ref: #/$defs/ref |
|
policy/ref |
yes |
ref: #/$defs/ref |
|
policy/digest |
yes |
ref: #/$defs/digest |
|
status |
yes |
enum: disabled, active, stopping, closed, expired, revoked, interrupted, failed |
|
started/at |
yes |
ref: #/$defs/timestamp |
|
expires/at |
yes |
ref: #/$defs/timestamp |
|
start/cursor |
yes |
ref: #/$defs/cursor |
|
start/resume-token |
yes |
string | |
final/cursor |
no |
ref: #/$defs/cursor |
|
final/resume-token |
no |
string | |
observations/accepted |
yes |
ref: #/$defs/cursor |
|
observations/dropped |
yes |
ref: #/$defs/cursor |
|
gaps/emitted |
yes |
ref: #/$defs/cursor |
|
terminal/reason-code |
no |
ref: #/$defs/ref |
|
links |
yes |
object |
Definitions¶
| Definition | Shape | Description |
|---|---|---|
ref |
string | |
digest |
string | |
timestamp |
string | |
cursor |
integer |
Conditional Rules¶
Rule 1¶
When:
{
"required": [
"final/cursor"
]
}
Then:
{
"required": [
"final/resume-token"
]
}
Rule 2¶
When:
{
"properties": {
"status": {
"enum": [
"disabled",
"active",
"stopping"
]
}
},
"required": [
"status"
]
}
Then:
{
"not": {
"required": [
"terminal/reason-code"
]
}
}
Field Semantics¶
schema¶
- Required:
yes - Shape: const:
component-trace-session.v1
schema/v¶
- Required:
yes - Shape: const:
1
session/ref¶
- Required:
yes - Shape: ref:
#/$defs/ref
node/ref¶
- Required:
yes - Shape: ref:
#/$defs/ref
observation/generation¶
- Required:
yes - Shape: ref:
#/$defs/ref
policy/ref¶
- Required:
yes - Shape: ref:
#/$defs/ref
policy/digest¶
- Required:
yes - Shape: ref:
#/$defs/digest
status¶
- Required:
yes - Shape: enum:
disabled,active,stopping,closed,expired,revoked,interrupted,failed
started/at¶
- Required:
yes - Shape: ref:
#/$defs/timestamp
expires/at¶
- Required:
yes - Shape: ref:
#/$defs/timestamp
start/cursor¶
- Required:
yes - Shape: ref:
#/$defs/cursor
start/resume-token¶
- Required:
yes - Shape: string
final/cursor¶
- Required:
no - Shape: ref:
#/$defs/cursor
final/resume-token¶
- Required:
no - Shape: string
observations/accepted¶
- Required:
yes - Shape: ref:
#/$defs/cursor
observations/dropped¶
- Required:
yes - Shape: ref:
#/$defs/cursor
gaps/emitted¶
- Required:
yes - Shape: ref:
#/$defs/cursor
terminal/reason-code¶
- Required:
no - Shape: ref:
#/$defs/ref
links¶
- Required:
yes - Shape: object
Definition Semantics¶
$defs.ref¶
- Shape: string
$defs.digest¶
- Shape: string
$defs.timestamp¶
- Shape: string
$defs.cursor¶
- Shape: integer