Skip to main content

logs

Typed specification

Generated by the pinned ess generate --kind docs from adapters/kubernetes/spec/ess. Structural validation establishes consistency; behaviour, storage and cross-record predicates remain implementation obligations.

Kubernetes-owned pod log selection, line observations and truncation accounting of pods.logs.

connectors_kubernetes.logs is one of connectors_kubernetes's bounded contexts. Back to the index.

Types​

LogLine​

connectors_kubernetes.logs.LogLine is a record of five fields:

  • timestamp_unix_ns — Optional<String>, which may be absent
  • stream — connectors_kubernetes.logs.LogStream
  • line — String
  • line_truncated — Boolean
  • redacted — Boolean

Every value satisfies line.count <= 8192.

LogStream​

connectors_kubernetes.logs.LogStream is a record of three fields:

  • namespace — String
  • pod — String
  • container — Optional<String>, which may be absent

LogTruncation​

connectors_kubernetes.logs.LogTruncation is a record of three fields:

  • causes — List<connectors_kubernetes.logs.TruncationCause>
  • occurrences_dropped — Optional<Integer>, which may be absent
  • stream_groups_dropped — Integer

Every value satisfies causes.count <= 3 and (stream_groups_dropped >= 0 and stream_groups_dropped <= 0).

PodLogSelection​

connectors_kubernetes.logs.PodLogSelection is a record of six fields:

  • namespace — String
  • pod — String
  • container — Optional<String>, which may be absent
  • since_seconds — Integer
  • tail_lines — Integer
  • max_bytes — Integer

Every value satisfies (namespace.count >= 1 and namespace.count <= 63), (pod.count >= 1 and pod.count <= 253), (not (defined(container)) or (container.count >= 1 and container.count <= 63)), (since_seconds >= 1 and since_seconds <= 86400), (tail_lines >= 1 and tail_lines <= 1000) and (max_bytes >= 1 and max_bytes <= 131072).

PodLogs​

connectors_kubernetes.logs.PodLogs is a record of five fields:

  • lines — List<connectors_kubernetes.logs.LogLine>
  • since_seconds — Integer
  • tail_lines — Integer
  • complete — Boolean
  • truncation — connectors_kubernetes.logs.LogTruncation

Every value satisfies lines.count <= 1000.

TruncationCause​

connectors_kubernetes.logs.TruncationCause is one of provider_limit, source_bytes and line_bytes.

Two of the types above are reached by nothing else in this system: connectors_kubernetes.logs.PodLogSelection and connectors_kubernetes.logs.PodLogs. No entity, view, command, event, error or crossing names them, so it is either vocabulary something outside this specification uses or a leftover — and only a person can tell which.

Generated from connectors_kubernetes v1 · model digest 860ee995d42502fcf5cf8042d04e0af8a02e201a325b1ea6d3c5c1b2d4cd0b9d · contract digest slice-sha256/2:2ba3050acd417006de65bda87e910b316b33b7401f3b64bafc120b1fe94c664a. Do not edit this file; change the specification and regenerate it with ess generate.