Resources / TelemetryStream
TelemetryStream
A real-time stream of logs, metrics/APM, distributed traces, or network traffic flows (spec 0042).
Overview
| API | monitoring.etorm.com/v1alpha1 |
| Resource | telemetrystreams (cluster-scoped inside its cluster) |
| Short names | tstream |
| Available in | project clusters only |
| Status | written by a controller through /status |
Minimal example
apiVersion: monitoring.etorm.com/v1alpha1
kind: TelemetryStream
metadata:
name: example
spec:
workspaceRef:
name: "<name>"
kind: logs
Spec
| Field | Type | Required | Default | Allowed | Description |
|---|---|---|---|---|---|
workspaceRef | reference to MonitoringWorkspace | yes | Target MonitoringWorkspace. | ||
kind | string (one of) | yes | logs, metrics, traces, network | Telemetry modality. | |
source | string (one of) | "custom" | compute, vpc, edge, otlp, custom | Ingestion source. | |
retentionDays | integer | 1 to 365 | Optional retention override in days. | ||
samplingRate | number | 1.0 | 0.0 to 1.0 | Fraction of events retained (0.0 to 1.0). | |
partitionBy | string (one of) | "hour" | hour, day | Time partition granularity. | |
orderBy | list of string | Sort key columns inside each columnar part. | |||
rollups | list of object | up to 4 items | Continuous downsampling rollup intervals materialized during compaction. | ||
rollups[].intervalSeconds | integer | yes | 10 to 86400 | Rollup bucket interval in seconds (e.g. 60, 3600). | |
rollups[].agg | string (one of) | yes | count, sum, min, max, avg, rate, p50, p95, p99 | Aggregation function for the rollup. | |
vpcRef | reference to VPC | Optional VPC to capture L3/L4/L7 network flows from. |
Status
| Field | Type | Required | Default | Allowed | Description |
|---|---|---|---|---|---|
phase | string | Pending or Ready. | |||
storedBytes | integer | Stored bytes for this stream. | |||
totalRows | integer | Total ingested rows. | |||
lastIngestAt | string | RFC 3339 timestamp of latest ingest. | |||
conditions | list of object | Status conditions. | |||
conditions[].type | string | Condition type. | |||
conditions[].status | string | True or False. | |||
conditions[].reason | string | Machine-readable reason. | |||
conditions[].message | string | Human-readable detail. |
Columns in listings
| Column | From |
|---|---|
| Workspace | .spec.workspaceRef.name |
| Kind | .spec.kind |
| Source | .spec.source |
| Phase | .status.phase |