Resources / TelemetryStream

TelemetryStream

A real-time stream of logs, metrics/APM, distributed traces, or network traffic flows (spec 0042).

Overview

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

Minimal example

apiVersion: monitoring.etorm.com/v1alpha1
kind: TelemetryStream
metadata:
  name: example
spec:
  workspaceRef:
    name: "<name>"
  kind: logs

Spec

FieldTypeRequiredDefaultAllowedDescription
workspaceRefreference to MonitoringWorkspaceyesTarget MonitoringWorkspace.
kindstring (one of)yeslogs, metrics, traces, networkTelemetry modality.
sourcestring (one of)"custom"compute, vpc, edge, otlp, customIngestion source.
retentionDaysinteger1 to 365Optional retention override in days.
samplingRatenumber1.00.0 to 1.0Fraction of events retained (0.0 to 1.0).
partitionBystring (one of)"hour"hour, dayTime partition granularity.
orderBylist of stringSort key columns inside each columnar part.
rollupslist of objectup to 4 itemsContinuous downsampling rollup intervals materialized during compaction.
rollups[].intervalSecondsintegeryes10 to 86400Rollup bucket interval in seconds (e.g. 60, 3600).
rollups[].aggstring (one of)yescount, sum, min, max, avg, rate, p50, p95, p99Aggregation function for the rollup.
vpcRefreference to VPCOptional VPC to capture L3/L4/L7 network flows from.

Status

FieldTypeRequiredDefaultAllowedDescription
phasestringPending or Ready.
storedBytesintegerStored bytes for this stream.
totalRowsintegerTotal ingested rows.
lastIngestAtstringRFC 3339 timestamp of latest ingest.
conditionslist of objectStatus conditions.
conditions[].typestringCondition type.
conditions[].statusstringTrue or False.
conditions[].reasonstringMachine-readable reason.
conditions[].messagestringHuman-readable detail.

Columns in listings

ColumnFrom
Workspace.spec.workspaceRef.name
Kind.spec.kind
Source.spec.source
Phase.status.phase

All resources