---
title: blossom metric:stream:create
url: "/docs/reference/cli/metric/stream/create/"
canonical_url: https://docs.blossom88.com/docs/reference/cli/metric/stream/create/
markdown_url: https://docs.blossom88.com/docs/reference/cli/metric/stream/create.md
summary: Create a metric stream
categories:
- cli
- reference
---

# blossom metric:stream:create

Create a metric stream

## Usage

    blossom metric:stream:create [--data DATA]

## Flags

| Flag | Description |
| --- | --- |
| `--data, -d` | YAML or JSON metric stream data, a path to a data file, or an HTTP(S) URL |

Examples:

    blossom metric:stream:init
    blossom metric:stream:create --data metric_stream.yml
    blossom metric:stream:create --data '{"metric_stream":{"streamable_id":"environment-100","source_type":"container","metric_scope":"environment-100:web","time_range":"live"}}'
    blossom metric:stream:create --data '{"metric_stream":{"streamable_id":"database_instance-100","source_type":"database_instance","metric_scope":"database_instance-100","time_range":"live"}}'

Creates or reuses a `MetricStream` for a streamable resource.

`metric_stream.streamable_id` is the resource context.
`metric_stream.source_type` chooses container, database_instance, or cache_instance metrics
inside that context. `metric_stream.metric_scope` chooses the specific source
within that source type. Copy the exact `SOURCE_TYPE` and `METRIC_SCOPE` values
from `blossom metric:source:list`.

When `metric_stream.time_range` is omitted, Blossom uses `live`.

Use only source types and metric scopes returned by
`blossom metric:source:list`.