Projekt anlegen
So legen Sie ein Projekt an, finden Schlüssel und DSN und prüfen mit einem Test-Ereignis, ob alles ankommt.
Was ein Projekt ist
Ein Projekt steht für eine überwachte App oder einen Dienst, zum Beispiel Ihren Online-Shop, Ihre API oder eine Kunden-Website. Jedes Projekt hat eine Plattform, eigene Umgebungen, Filter, Datenschutz-Regeln und einen oder mehrere Schlüssel. Fehler, Releases und Statistik gehören immer zu genau einem Projekt.
Wie viele Projekte Sie anlegen können, hängt vom Tarif ab: Kostenlos 2, Starter 10, Team 30, Agentur unbegrenzt.
Tipp: Legen Sie Frontend und Backend als getrennte Projekte an, wenn verschiedene Personen zuständig sind. Für Staging brauchen Sie kein eigenes Projekt, dafür gibt es Umgebungen.
Schritt für Schritt
- Öffnen Sie Projekte (
/app/projekte) und klicken Sie auf Projekt anlegen. - Geben Sie einen Namen ein und wählen Sie die Plattform.
- Der Einrichtungs-Assistent zeigt den passenden Code mit Ihrem Schlüssel und Ihrer DSN zum Kopieren.
- Binden Sie den Code in Ihre App ein und spielen Sie sie aus.
- Klicken Sie auf Test-Ereignis senden oder lösen Sie einen echten Fehler aus.
- Sobald „Erstes Ereignis empfangen“ erscheint, ist das Projekt verbunden.
Der Assistent erkennt eingehende Ereignisse live. Sie müssen die Seite nicht neu laden.
Schlüssel und DSN
Der Schlüssel ist eine öffentliche Kennung aus 32 Zeichen. Er darf im Browser stehen, weil er nur das Senden von Ereignissen erlaubt, kein Lesen. Die DSN fasst Schlüssel und Projektnummer in einer Adresse zusammen:
https://<schluessel>@monitor.agiledeveloper.de/<nummer>Je Projekt können Sie mehrere Schlüssel anlegen, zum Beispiel einen für den Browser und einen für den Server. Einen Schlüssel, der in falsche Hände geraten ist, widerrufen Sie unter Projekte › Einstellungen › Schlüssel. Ereignisse mit einem widerrufenen Schlüssel werden abgelehnt.
Einstellungen des Projekts
Unter Projekte › Einstellungen finden Sie:
- Umgebungen: welche Umgebungen das Projekt kennt, etwa production und staging.
- Filter: Staging, Bots, Browser-Erweiterungen und eigene Muster ausschließen.
- Datenschutz-Regeln: eigene Felder und Muster, die vor dem Speichern entfernt werden.
- Spitzenschutz: wie viele Ereignisse das Projekt je Minute annimmt.
- Anteil: wie viel Prozent des Monatskontingents dieses Projekt höchstens verbrauchen darf.
- Schlüssel: anlegen und widerrufen.
Wenn nichts ankommt
- Prüfen Sie die DSN: Der Schlüssel steht vor dem @, die Projektnummer am Ende.
- Erlauben Sie ausgehendes HTTPS zu monitor.agiledeveloper.de, falls eine Firewall dazwischen liegt.
- Prüfen Sie die Filter des Projekts. Ist die Umgebung Ihres Tests gesperrt, wird das Ereignis gefiltert.
- Eine Antwort 401 oder 403 heißt: Schlüssel fehlt, ist falsch oder widerrufen, oder das Projekt ist archiviert.
- Eine Antwort 429 heißt: Spitzenschutz oder Kontingent ist erreicht.
Mehr dazu in der Einrichtungs-Doku: https://monitor.agiledeveloper.de/docs/einrichten#grenzen