---
title: "ay events"
source: "https://ayoune.com/en/docs/cli/ay-events"
tenant: "tolinax UG"
brand: "aYOUne"
collection: "aYOUne CLI"
language: "en"
retrieved: "2026-08-27T22:23:57.064Z"
platform: "aYOUne — https://ayoune.com"
generator: "aYOUne Doku-Export"
contact: "info@tolinax.com"
license: "Alle Rechte vorbehalten. Weitergabe nur mit Quellenangabe."
---

# `ay events` (Alias: `sub`)

Subscribed via WebSocket auf den aYOUne Customer-Event-Bus und filtert die Events auf der Client-Seite. Output formatiert als JSON, YAML oder Tabelle.

## Syntax

```
ay events [flags]
```

## Flags

| Flag | Default | Zweck |
|---|---|---|
| `-f, --format <fmt>` | `json` | `json` / `yaml` / `table` |
| `-c, --category <cat>` | `*` | Event-Category (z.B. `sales`, `crm`) |
| `-a, --action <act>` | `*` | Action (z.B. `create`, `update`, `delete`) |
| `-l, --label <label>` | `*` | Label-Filter |
| `-V, --value <val>` | `*` | Value-Filter |

`*` = match-all. Filter werden client-seitig ausgewertet — Server sendet alle Events des aktiven Customers.

## Beispiele

```bash
# Alle Events
ay events

# CRM-Events als YAML
ay sub -c crm -f yaml

# Sales-Creates in Tabellenform
ay events -c sales -a create -f table

# Nur Errors
ay events -c errors -f json

# Notification-Worker im Blick behalten
ay events -c notifications -f yaml
```

## Schema

Jedes Event hat:
```
{
  category: string,
  action: string,
  label: string,
  value: string,
  evt_data: { …payload }
}
```

## Hinweis

Die WebSocket-Connection bleibt offen bis `Ctrl+C`. Auto-Reconnect ist eingebaut (mit Customer-Room-Rejoin). Für strukturierte Long-Term-Logs siehe [monitor logs](wiki:cli/devops/monitor).

## Siehe auch

- [stream](wiki:cli/streaming/stream) — Live-Änderungen einer Collection
- [monitor](wiki:cli/devops/monitor) — Persistente Log-Streams

---

## 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