---
title: stack kb significantevents get-streams-name-significant-events cli command
description: Read the significant events Behaviour flags: --dry-run — validate all inputs and exit without performing any action 
url: https://www.elastic.co/elastic/docs-builder/docs/4083/reference/elastic-cli/cli/stack/kb/significantevents/get-streams-name-significant-events
applies_to:
  - Elastic Cloud Serverless: Preview
  - Elastic Stack: Preview
---

# stack kb significantevents get-streams-name-significant-events cli command
<cli-modifiers>
</cli-modifiers>

```bash
elastic stack kb significantevents get-streams-name-significant-events \
  --name <name> \
  --from <from> \
  --to <to> \
  --bucket-size <bucket-size> \
  [options]
```

Read the significant events
**Behaviour flags:**
`--dry-run` — validate all inputs and exit without performing any action

## Options

<definitions>
  <definition term="--name string required">
    The name of the stream.
  </definition>
  <definition term="--from string required">
    Start of the time range as an ISO 8601 date string.
  </definition>
  <definition term="--to string required">
    End of the time range as an ISO 8601 date string.
  </definition>
  <definition term="--bucket-size string required">
    The bucket size for aggregating events (e.g. "1m", "1h").
  </definition>
  <definition term="--query string">
    Query string to filter significant events on metadata fields
  </definition>
  <definition term="--search-mode enum">
    Search mode: keyword (BM25), semantic (vector), or hybrid (RRF). When omitted, defaults to hybrid with a silent keyword fallback on failure. When set explicitly, failures propagate as errors.
    **Values:** keyword, semantic, hybrid
  </definition>
  <definition term="--input-file string">
    path to a JSON file to use as command input
  </definition>
  <definition term="--dry-run">
    validate all inputs and exit without performing any action (preview changes without applying them)
  </definition>
</definitions>


## Global Options

<definitions>
  <definition term="--json">
    output as JSON
  </definition>
</definitions>