Fehlerbehebung

Der Agent startet nicht

Diagnose — bei Autostart (systemd):

journalctl --user -u conhive-agent -n 50 --no-pager

Diagnose — bei manuellem Start:

~/conhive-agent

Starten Sie den Agent direkt im Terminal (ohne &), so sehen Sie die Ausgabe sofort. Suchen Sie nach Zeilen mit ERR oder error.

Webinterface nicht erreichbar

1. Prüfen Sie, ob der Agent läuft:

   pgrep -a conhive-agent

2. Warten Sie 20 Sekunden nach dem Start — die Oberfläche braucht einen kurzen Moment.

3. Prüfen Sie die IP-Adresse (bei Zugriff von einem anderen Gerät):

   ip addr show | grep "inet " | grep -v 127

4. Firewall prüfen (falls aktiv, Port 5050 freigeben):

   sudo ufw allow 5050

Port 5050 ist belegt

Prüfen, welches Programm Port 5050 belegt:

ss -tlnp | grep :5050

Die Ausgabe zeigt Prozessname und PID. Beenden Sie das andere Programm gezielt, oder starten Sie den Rechner neu — in den meisten Fällen ist es ein bereits gestoppter Prozess, der seinen Port nicht freigegeben hat.

Agent läuft nicht nach Neustart

Der Agent startet nicht automatisch ohne eingerichteten Autostart.

Lösung: Autostart einrichten — einmalige Einrichtung, danach startet der Agent bei jedem Systemstart automatisch.

Schnellstart ohne Autostart:

~/conhive-agent > ~/.local/share/conhive/logs/agent.log 2>&1 &

Flow startet nicht / stoppt sofort

Der Flow prüft sich vor dem Start selbst. Mögliche Ursachen:

8-Kanal-Mikrofon nicht angeschlossen (beim ACCDOA-Flow): Mikrofon anschließen und Deploy erneut klicken — oder den einfacheren 1-Kanal-Flow verwenden.

Kein Mikrofon erkannt:

arecord -L

Prüfen Sie, ob Ihr Mikrofon in der Liste erscheint. Falls ja: im Flow-Editor den Knoten ALSA Capture öffnen, Gerätenamen eintragen, dann Save → Deploy. Detaillierte Anleitung: Mikrofon einrichten.

Keine Erkennungen obwohl Flow läuft

• Sind Vögel in Rufweite? BirdID erkennt nur tatsächliche Rufe.
• Pegel auf der Audio-Seite prüfen: zeigt das Mikrofon ein Signal? Wenn der Pegel bei null steht → Mikrofon einrichten.
• Liegt der Konfidenz-Schwellwert zu hoch? Standard: 70 %. Im Flow-Editor beim Knoten BirdID Classifier prüfen.
• Läuft der Flow wirklich? Im Dashboard unter „Laufende Flows" prüfen.

Testlizenz läuft ab

Kurzreferenz

# Installation / Update
curl -sSL https://files.conhive.ai/agent/download.sh | bash -s wiese

# Agent manuell starten (Hintergrund mit Log)
~/conhive-agent > ~/.local/share/conhive/logs/agent.log 2>&1 &

# Webinterface
http://localhost:5050

# Status prüfen
pgrep -a conhive-agent

# Agent stoppen
pkill conhive-agent

# Logs (systemd-Autostart)
journalctl --user -u conhive-agent -f

# Logs (manueller Start)
tail -f ~/.local/share/conhive/logs/agent.log

# Mikrofone anzeigen
arecord -L