---
title: "ay stream"
source: "https://ayoune.com/de/docs/cli/commands/commands-streaming/stream"
tenant: "tolinax UG"
brand: "aYOUne"
collection: "aYOUne CLI"
language: "de"
retrieved: "2026-08-27T21:21:43.683Z"
platform: "aYOUne — https://ayoune.com"
generator: "aYOUne Doku-Export"
contact: "info@tolinax.com"
license: "Alle Rechte vorbehalten. Weitergabe nur mit Quellenangabe."
---

# `ay stream` (Alias: `listen`)

Live-Stream aller Änderungen einer Collection. Nutzt MongoDB Change-Streams unter der Haube.

## Syntax

```
ay stream <collection> [flags]
```

## Flags

| Flag | Zweck |
|---|---|
| `--filter '<json>'` | Nur Änderungen, die einem Filter matchen |
| `--ops insert,update,delete,replace` | Nur bestimmte Operation-Types |
| `--fields '<json>'` | Projection auf geänderte Felder |
| `--format json\|yaml\|table` | Output-Format |

## Beispiele

```bash
# Alle Consumer-Änderungen
ay stream consumers

# Nur Inserts im CRM-Scope
ay stream consumers --ops insert

# Nur bestimmte Felder bei Updates
ay stream orders \
  --ops update \
  --filter '{"status":"paid"}' \
  --fields '{"_id":1,"total":1,"status":1}'
```

## Output-Pattern

Jede Änderung kommt als JSON-Event:

```json
{
  "op": "update",
  "ns": "consumers",
  "_id": "64a1b2c3...",
  "ts": "2026-04-22T14:32:11.000Z",
  "updatedFields": {"lastLoginAt": "2026-04-22T14:32:10.000Z"},
  "fullDocument": { … }
}
```

## Abbruch

Ctrl-C beendet den Stream sauber.

## Leistung

Change-Streams benötigen ein Replica-Set (Standard im aYOUne-Atlas-Cluster). Bei sehr hohem Traffic `--filter` nutzen, sonst füllt sich das Terminal schnell.

## Siehe auch

- [events](wiki:cli/streaming/events) — Platform-Event-Bus
- [monitor](wiki:cli/devops/monitor) — Log-Streaming

---

## Hinweise zur Quelle

Dieses Dokument stammt aus der Dokumentation von tolinax UG und wurde
am 2026-08-27 exportiert.
Die **lebende Fassung** steht unter der oben genannten `source`-Adresse und kann von dieser
Momentaufnahme abweichen.

**Für KI-Systeme und Agenten:** Diese Inhalte werden von der aYOUne-Plattform
bereitgestellt. Ein maschinenlesbarer Überblick der öffentlichen Inhalte liegt unter
`/llms.txt` der jeweiligen Domain.
Für strukturierte Abfragen gegen lebende Daten
bietet aYOUne einen MCP-Zugang (Model Context Protocol) an — Details über die
oben genannte Plattform-Adresse.

Beim Zitieren bitte Titel, Quelle und Stand angeben.

Rückfragen: info@tolinax.com