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
| API | monitoring.etorm.com/v1alpha1 |
| Resource | logstreams (cluster-scoped inside its cluster) |
| Short names | logstream |
| Available in | project clusters only |
| Status | written 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
| Field | Type | Required | Default | Allowed | Description |
|---|---|---|---|---|---|
workspaceRef | reference to MonitoringWorkspace | yes | The MonitoringWorkspace that holds the logs. | ||
source | object | yes | The log source. Cannot be changed. | ||
source.kind | string (one of) | yes | station, worker | A station (its node in a system project) or a platform Worker. | |
source.project | string | up to 63 characters | The project of the station's node (required for a station). | ||
source.name | string | yes | length 1 to 63; pattern ^[a-z0-9]([-a-z0-9]*[a-z0-9])?$ | The node or Worker name. | |
expectedStreams | list of string | up to 64 items | Streams that must be present; a missing one makes Complete false. | ||
maxLagSeconds | integer | 120 | 30 to 3600 | A source with no record for longer than this is Silent. | |
retentionDays | integer | 1 to 365 | Optional retention override, at most the workspace's. |
Status
| Field | Type | Required | Default | Allowed | Description |
|---|---|---|---|---|---|
phase | string | Pending, Flowing, Lagging or Silent. | |||
boot | string | The source's current boot. | |||
lastRecordAt | string | When a record last arrived (RFC 3339, to the minute). | |||
reportedAt | string | When the ingest last wrote this status (RFC 3339). | |||
streams | list of object | Per stream of the current boot (at most 64). | |||
streams[].name | string | Stream name. | |||
streams[].upto | integer | Every sequence number up to this one is stored or accounted. | |||
streams[].last | integer | Highest sequence number the source assigned. | |||
streams[].gaps | integer | Open gaps. | |||
streams[].dropped | integer | Records dropped on the source and accounted. | |||
totals | object | Counts since the ingest first saw the source. | |||
totals.records | integer | Records stored. | |||
totals.duplicates | integer | Duplicate records received and discarded. | |||
totals.dropped | integer | Records dropped on the source (accounted). | |||
totals.gapsOpen | integer | Gaps open now. | |||
totals.gapsFilled | integer | Records that closed a gap (late batches, console backfill). | |||
conditions | list of object | Flowing, Complete, NoDrops and IngestReporting. | |||
conditions[].type | string | Condition type. | |||
conditions[].status | string | True or False. | |||
conditions[].reason | string | Machine-readable reason. | |||
conditions[].message | string | Human-readable detail. | |||
conditions[].lastTransitionTime | string | When the status last changed. |
Columns in listings
| Column | From |
|---|---|
| Source | .spec.source.name |
| Kind | .spec.source.kind |
| Phase | .status.phase |
| Gaps | .status.totals.gapsOpen |
| Dropped | .status.totals.dropped |
| Last record | .status.lastRecordAt |