84 lines
3.8 KiB
Markdown
84 lines
3.8 KiB
Markdown
---
|
||
id: howto-guest-upload-failing
|
||
title: How-to – Gäste können nicht hochladen
|
||
sidebar_label: Gäste können nicht hochladen
|
||
---
|
||
|
||
Dieses How‑to beschreibt, wie du vorgehst, wenn Gäste melden, dass sie keine Fotos mehr hochladen können (Fehler im Upload‑Flow oder „hängenbleibende“ Uploads).
|
||
|
||
## 1. Problem eingrenzen
|
||
|
||
Fragen an den Tenant/Support:
|
||
|
||
- Betrifft es **alle** Gäste oder nur einzelne?
|
||
- Betrifft es **alle** Events oder nur ein bestimmtes Event?
|
||
- Welche Fehlermeldung erscheint im Guest‑Frontend (so genau wie möglich, gerne mit Screenshot)?
|
||
- Seit wann tritt das Problem auf? (Zeitfenster)
|
||
|
||
Diese Informationen bestimmen, ob du in Richtung API/Rate‑Limit, Storage/Queues oder Event‑Konfiguration schauen musst.
|
||
|
||
## 2. Basischecks – API & App
|
||
|
||
1. **Public-API Status**
|
||
- Teste manuell einen Upload gegen ein Test‑Event oder reproduziere das Problem mit dem betroffenen Join‑Token.
|
||
- Achte auf HTTP‑Statuscodes im Browser‑Network‑Tab (4xx vs. 5xx).
|
||
2. **App- / Deployment-Status**
|
||
- Prüfe in Docker/Dokploy, ob App/Queue/Redis/DB‑Container gesund sind.
|
||
- Schaue in `storage/logs/laravel.log` nach offensichtlichen Exceptions rund um das gemeldete Zeitfenster.
|
||
|
||
Wenn die Public‑API generell 5xx liefert, greift eher das Public‑API‑Incident‑Playbook (`docs/ops/deployment/public-api-incident-playbook.md`).
|
||
|
||
## 3. Queues & Upload-Health
|
||
|
||
Wenn das Problem hauptsächlich Uploads betrifft (andere Funktionen laufen):
|
||
|
||
1. **Queue-Längen prüfen**
|
||
- In Horizon:
|
||
- `media-storage`, `media-security` und ggf. `notifications` Queue‑Längen ansehen.
|
||
- In Logs:
|
||
- Warnungen aus `storage:check-upload-queues` oder `storage-jobs` suchen.
|
||
2. **Upload-Health-Command**
|
||
- Sicherstellen, dass `storage:check-upload-queues` regelmäßig läuft (Cron / Scheduler).
|
||
- Manuell ausführen (in der App‑Container‑Shell):
|
||
```bash
|
||
php artisan storage:check-upload-queues
|
||
```
|
||
- Ausgaben/Logs prüfen:
|
||
- Meldungen zu „stalled“ Uploads, Events mit dauerhaft vielen Pending‑Assets.
|
||
|
||
## 4. Storage & Limit-Probleme
|
||
|
||
1. **Hot-Storage-Füllstand**
|
||
- Prüfen, ob das Storage‑Volume/Bucket nahe an 100 % ist (siehe `docs/ops/dr-storage-issues.md`).
|
||
- Wenn ja:
|
||
- Archivierung beschleunigen (`storage:archive-pending` verifizieren).
|
||
- Kurzfristig Speicher vergrößern oder Caches aufräumen.
|
||
2. **Paket-/Limit-Prüfungen**
|
||
- Wenn nur bestimmte Events betroffen sind:
|
||
- Paket‑Limits des Events prüfen (z.B. max_photos/max_guests).
|
||
- Event‑Status (abgelaufen/archiviert?) prüfen.
|
||
- Logs können Fehlercodes liefern wie „photo_limit_exceeded“ – diese deuten auf bewusst ausgelöste Limit‑Sperren hin, nicht auf technische Fehler.
|
||
|
||
## 5. Typische Muster & Gegenmaßnahmen
|
||
|
||
- **Hohe Fehlerrate beim Upload (5xx)**
|
||
- Hinweis auf API‑/Backend‑Problem:
|
||
- Siehe Public‑API‑Runbook und App‑Logs (Datenbank‑/Redis‑Fehler, Timeouts).
|
||
- **Uploads bleiben „ewig“ auf „wird verarbeitet“**
|
||
- Queues laufen nicht oder `media-storage`/`media-security` steckt fest:
|
||
- Horizon prüfen, ob Worker‑Container laufen.
|
||
- Ggf. Worker neu starten und Failed Jobs analysieren.
|
||
- **Nur ein Event betroffen, andere funktionieren**
|
||
- Meist Limit‑ oder Konfig‑Thema (Paket voll, Galerie abgelaufen, Event deaktiviert).
|
||
- Tenant‑Admin‑UI prüfen: Event‑Status, Paket‑Status, Data Lifecycle Einstellungen.
|
||
|
||
## 6. Kommunikation
|
||
|
||
- **An Tenant/Support zurückmelden**:
|
||
- Was war die Ursache? (z.B. Paket‑Limit, temporäre Überlastung, Storage‑Knappheit).
|
||
- Was wurde getan? (z.B. Paket angepasst, Queues neu gestartet, Storage erweitert).
|
||
- Ob und wie der Tenant/gäste weiteres tun müssen (z.B. Seite neu laden, später erneut probieren).
|
||
|
||
Für tiefere Ursachen rund um Storage siehe `docs/ops/media-storage-spec.md` und `docs/ops/dr-storage-issues.md`.
|
||
|