Files
OpenShell/docs
Kris Hicks 0e96e8e8c9 feat(ocsf)!: emit OCSF 1.8.0 only and deprecate the schema version knobs (#5036)
Remove the OCSF schema downgrade. OpenShell now writes native OCSF 1.8.0
records to supervisor JSONL and stderr, gateway JSONL, and OTLP log
export regardless of configuration.

The downgrade did not produce valid records: events it labelled 1.1 or
1.3 failed validation against those versions, because OpenShell's
emitters rely on requirements that only 1.8 relaxed (#4284). It was also
not shown to be required by any SIEM: of ten sinks and pipelines tested
with real OpenShell records, none rejected native 1.8.0 or gated on
metadata.version.

The version knobs stay accepted so existing configuration still loads,
but they are deprecated and ignored:

- The ocsf_schema_version sandbox setting accepts any value; the
  supervisor reports a newly set value as a Device Config State Change
  event.
- schema_version under [openshell.gateway.ocsf_log] and
  [openshell.gateway.otlp.ocsf], and the server.ocsfLog.schemaVersion
  Helm value, accept any value; the gateway logs a warning at startup.
- The compute drivers' OPENSHELL_OTLP_OCSF_SCHEMA_VERSION flag and
  environment variable are hidden and ignored, with a warning, and are
  no longer forwarded to sandboxes.

BREAKING CHANGE: Deployments that set an OCSF schema version now receive
native OCSF 1.8.0 records instead of records labelled 1.1 or 1.3.

Closes #4284

Signed-off-by: Kris Hicks <khicks@nvidia.com>
2026-10-30 15:23:37 +00:00
..