Resources / LogStream

LogStream

Every log stream of one source (a station or a platform Worker), captured into a Monitoring workspace, and its health: lag, last sequence numbers, gaps and drops (spec 0042 "Platform logs").

Overview

APImonitoring.etorm.com/v1alpha1
Resourcelogstreams (cluster-scoped inside its cluster)
Short nameslogstream
Available inproject clusters only
Statuswritten by a controller through /status

Minimal example

apiVersion: monitoring.etorm.com/v1alpha1
kind: LogStream
metadata:
  name: example
spec:
  workspaceRef:
    name: "<name>"
  source:
    kind: station
    name: "<name>"

Spec

FieldTypeRequiredDefaultAllowedDescription
workspaceRefreference to MonitoringWorkspaceyesThe MonitoringWorkspace that holds the logs.
sourceobjectyesThe log source. Cannot be changed.
source.kindstring (one of)yesstation, workerA station (its node in a system project) or a platform Worker.
source.projectstringup to 63 charactersThe project of the station's node (required for a station).
source.namestringyeslength 1 to 63; pattern ^[a-z0-9]([-a-z0-9]*[a-z0-9])?$The node or Worker name.
expectedStreamslist of stringup to 64 itemsStreams that must be present; a missing one makes Complete false.
maxLagSecondsinteger12030 to 3600A source with no record for longer than this is Silent.
retentionDaysinteger1 to 365Optional retention override, at most the workspace's.

Status

FieldTypeRequiredDefaultAllowedDescription
phasestringPending, Flowing, Lagging or Silent.
bootstringThe source's current boot.
lastRecordAtstringWhen a record last arrived (RFC 3339, to the minute).
reportedAtstringWhen the ingest last wrote this status (RFC 3339).
streamslist of objectPer stream of the current boot (at most 64).
streams[].namestringStream name.
streams[].uptointegerEvery sequence number up to this one is stored or accounted.
streams[].lastintegerHighest sequence number the source assigned.
streams[].gapsintegerOpen gaps.
streams[].droppedintegerRecords dropped on the source and accounted.
totalsobjectCounts since the ingest first saw the source.
totals.recordsintegerRecords stored.
totals.duplicatesintegerDuplicate records received and discarded.
totals.droppedintegerRecords dropped on the source (accounted).
totals.gapsOpenintegerGaps open now.
totals.gapsFilledintegerRecords that closed a gap (late batches, console backfill).
conditionslist of objectFlowing, Complete, NoDrops and IngestReporting.
conditions[].typestringCondition type.
conditions[].statusstringTrue or False.
conditions[].reasonstringMachine-readable reason.
conditions[].messagestringHuman-readable detail.
conditions[].lastTransitionTimestringWhen the status last changed.

Columns in listings

ColumnFrom
Source.spec.source.name
Kind.spec.source.kind
Phase.status.phase
Gaps.status.totals.gapsOpen
Dropped.status.totals.dropped
Last record.status.lastRecordAt

All resources