Manage and troubleshoot streams

Telemetry streams send your unit cost and allocation measurements into CloudZero. After your first send, the Telemetry Streams page (Settings > Telemetry Streams) is where you keep streams healthy: confirm data is flowing, update or delete a stream, and resolve any ingest issues.

Check stream status

Each stream on Settings > Telemetry Streams shows one of four statuses.

New records continue ingesting while a stream is Invalid, so you do not lose data while you resolve the cause.

Fix an Invalid stream

A stream lands in Invalid when one of its target Dimensions is missing or in a bad state. To recover:

1. Open the stream's details page and note the targeted Dimensions.
2. Open CostFormation and confirm each targeted Dimension exists and is valid.
3. Restore the deleted Dimension, fix the broken definition, or update the stream's references.

The stream returns to Available on the next ingest cycle once the underlying Dimension is healthy.

Edit a stream

Select a stream's name on Settings > Telemetry Streams to open its details page. From there you can:

• Update the description
• Toggle Fill gaps in time?
• Download the last 7 days of records as a CSV
• View ingest activity (record counts, last update)
• Upload a new CSV to add or replace records

Stream name, type, granularity, and target Dimensions are set at creation and cannot be changed. To change any of those, create a new stream.

Add or replace records

CloudZero matches each incoming record against existing ones:

• If everything except the value matches, the existing record is replaced.
• If nothing matches, the record is added as new.

For CSV streams, upload a new file from the details page. For API streams, POST to the same endpoint with /sum to add records or accumulate values into matching ones, /replace to overwrite, or /delete to remove.

Delete a stream

From the Telemetry Streams page:

1. Select the three-dot Actions menu on the stream's row.
2. Select Delete Stream.
3. Type the stream name and select Delete to confirm.

You can also delete from the stream's details page using the Delete Stream button. Deletion completes within one hour.

Common ingest errors