Docs/Getting Started/First Event

Dein erstes Event

Nach der SDK-Installation kannst du so prüfen, ob alles funktioniert.

Browser JavaScript

<script type="module">
  import * as Unseenr from "@unseenr/node";

  Unseenr.init({
    dsn: "https://<DEIN_PUBLIC_KEY>@app.unseenr.io/<PROJECT_ID>",
  });

  // Test-Fehler auslösen
  document.getElementById("test-btn")?.addEventListener("click", () => {
    try {
      throw new Error("Unseenr Testfehler");
    } catch (e) {
      Unseenr.captureException(e);
      console.log("Fehler an Unseenr gesendet!");
    }
  });
</script>

Node.js

import * as Unseenr from "@unseenr/node";

Unseenr.init({
  dsn: "https://<DEIN_PUBLIC_KEY>@app.unseenr.io/<PROJECT_ID>",
});

// Test-Fehler senden
Unseenr.captureException(new Error("Hallo von Unseenr!"));

Was passiert als Nächstes

  1. Das SDK serialisiert den Fehler in ein Sentry-kompatibles Envelope
  2. Das Envelope wird per POST an https://app.unseenr.io/api/<PROJECT_ID>/envelope gesendet
  3. Unseenr validiert den Public Key und prüft Rate Limits
  4. Das Event wird für asynchrone Verarbeitung in die Queue gestellt
  5. Der Worker erstellt oder aktualisiert ein Issue basierend auf dem Error-Fingerprint
  6. Das Issue erscheint auf der Issues-Seite deines Projekts

Event überprüfen

Navigiere zu deinem Projekt-Dashboard und klicke auf Issues in der Seitenleiste. Du solltest deinen Testfehler als Issue sehen mit:

  • Der Fehlermeldung als Titel
  • Event Count von 1
  • Status: UNRESOLVED
  • Level: ERROR

Klicke auf das Issue, um die vollständigen Details zu sehen, inklusive Stack Trace, Breadcrumbs und Kontext.

Response Headers

Der Ingest-Endpoint gibt nützliche Header zurück:

Header Beschreibung
X-Unseenr-Usage Aktueller Verbrauch wie 1/5000 (Events genutzt / Kontingent)
X-Unseenr-Usage-Percent Verbrauch in Prozent als Integer
X-Unseenr-Quota-Warning Vorhanden und true wenn Verbrauch über 75%
X-RateLimit-Remaining Verbleibende Anfragen im aktuellen Rate-Limit-Fenster
X-RateLimit-Reset Zeitstempel wann das Rate-Limit-Fenster zurückgesetzt wird
Auch verfügbar auf:English