Agile Developer Hilfe-Center › Agile Monitoring

Vorhandenes Fehler-SDK umstellen

So wechseln Sie mit einer App, die schon ein Open-Source-Fehler-SDK nutzt, zu Agile Monitoring, indem Sie nur die DSN tauschen.

Das Prinzip

Agile Monitoring versteht das Protokoll der verbreiteten Open-Source-Fehler-SDKs. Wenn Ihre App bereits ein solches SDK nutzt, egal ob bisher an einen Cloud-Dienst oder an einen selbst betriebenen Server angebunden, ändern Sie nur die DSN. Paket, Code und Einstellungen bleiben, wie sie sind.

Schritt für Schritt

  1. Legen Sie unter Projekte (/app/projekte) ein Projekt mit passender Plattform an.
  2. Kopieren Sie die DSN aus dem Einrichtungs-Assistenten. Sie hat diese Form:

```
https://<schluessel>@monitor.agiledeveloper.de/<nummer>;
```

  1. Suchen Sie in Ihrer Konfiguration die bisherige DSN. Meist steht sie in einer Umgebungsvariablen, deren Name auf _DSN endet, oder direkt im Aufruf zur Initialisierung des SDKs.
  2. Ersetzen Sie den alten Wert durch die neue DSN:

```
# vorher
..._DSN=https://abc123@o0.ingest.example.io/123

# nachher
..._DSN=https://<schluessel>@monitor.agiledeveloper.de/<nummer>
```

  1. Spielen Sie die App aus oder starten Sie sie neu.
  2. Lösen Sie einen Fehler aus oder warten Sie auf den nächsten echten. Im Assistenten erscheint „Erstes Ereignis empfangen“.

Mehrere Apps stellen Sie nacheinander um, je App ein eigenes Projekt.

Was angenommen wird

  • Fehler und Meldungen: werden zu Issues gruppiert.
  • Cron-Check-ins: werden automatisch zu Heartbeats. Der Zeitplan kommt aus der Konfiguration im SDK.
  • Transaktionen: fließen in die Leistungsansicht (ab Starter) und zählen nicht ins Kontingent.

Was verworfen wird

Session-Aufzeichnungen, Profiling, Anhänge und Logs nehmen wir nicht an. Sie werden kostenlos verworfen und zählen nicht ins Kontingent. Damit Ihre App keine unnötigen Daten verschickt, setzen Sie die Raten für Aufzeichnungen im SDK auf 0. Für Leistungsdaten reicht eine Rate von 0.1.

Was sich ändert

  • Gruppierung: Agile Monitoring bildet die Issues mit einem eigenen Fingerabdruck. Er ist über Releases stabil und berücksichtigt keine Zeilennummern. Ihre bisherigen Issues werden nicht übernommen, sondern ab dem ersten Ereignis neu aufgebaut.
  • Eigene Fingerabdrücke aus dem SDK werden beachtet.
  • Source Maps: Für Browser-Code lädt Agile Monitoring öffentlich erreichbare Source Maps automatisch. Das Hochladen über Build-Plugins ist noch nicht verfügbar.
  • Spitzenschutz: Wird ein Projekt geflutet, antwortet der Eingang mit 429 und Retry-After. Die SDKs pausieren dann von selbst.

Parallel betreiben

Sie möchten erst vergleichen? Viele SDKs erlauben nur eine DSN. Stellen Sie dann zunächst die Staging-Umgebung um und erst danach die Produktion.

Zurück wechseln

Genauso einfach: alte DSN wieder eintragen. Es bleibt kein Code von uns in Ihrer App zurück.

Weiterführend

Einrichtungs-Doku zum Wechsel: https://monitor.agiledeveloper.de/docs/einrichten#wechsel und Beispiele weiterer Sprachen wie Go, Ruby, Java und .NET: https://monitor.agiledeveloper.de/docs/einrichten#weitere

War dieser Artikel hilfreich?

Zuletzt aktualisiert am 22. Oktober 2026

Weitere Artikel zu Agile Monitoring

Nicht gefunden, was Sie suchen?Schreiben Sie uns. Wir helfen gern weiter.