Skip to main content
Es gibt keine dummen Fragen. Auf dieser Seite finden Sie Antworten auf die uns am häufigsten gestellten Fragen. Wenn Sie weitere Unterstützung benötigen, besuchen Sie bitte unsere Support-Seite.

Inhalt

Erste Schritte

Ich brauche Hilfe beim Einstieg. Wo fange ich an?

Wenn Sie neu bei AppSignal sind oder mehr über die Konfiguration von AppSignal-Funktionen erfahren möchten, lesen Sie bitte unsere Leitfäden.

AppSignal-Bibliotheken

Welche Programmiersprachen unterstützt AppSignal?

AppSignal unterstützt die Programmiersprachen Node.js, Ruby und Elixir. Außerdem haben wir JavaScript-Pakete, um clientseitige Fehler in unterstützten Browsern abzufangen.

Daten filtern

Wie ignoriere ich Actions in meiner Anwendung?

Sie können Actions ignorieren, um die Aufzeichnung von Daten für bestimmte Actions, Requests, background jobs usw. zu stoppen.

Wie ignoriere ich Fehler in meiner Anwendung?

Sie können Fehler ignorieren (basierend auf ihrem Namen), um zu verhindern, dass AppSignal sie meldet und Sie darüber benachrichtigt.

Wie filtere ich Daten, die an AppSignal gesendet werden?

Um zu erfahren, wie Sie die an AppSignal gesendeten Daten filtern können, lesen Sie einen der folgenden Leitfäden:

Welche Regex-Syntax unterstützt ignore_logs?

ignore_logs unterstützt nur eine begrenzte Teilmenge der Syntax regulärer Ausdrücke: ^ (Anfang der Zeichenkette), $ (Ende der Zeichenkette) und .* (Wildcard). Vollständige Regex-Konstrukte wie Zeichenklassen ([.]) sind nicht gültig und werden stillschweigend ignoriert. Um eine genaue Logzeile zu matchen, verankern Sie sie mit ^ und $. Um ein Präfix zu matchen, verwenden Sie ^ gefolgt vom literalen Text. Um irgendwo in der Nachricht zu matchen, umgeben Sie diese mit .*. Die vollständige Syntaxreferenz finden Sie im Leitfaden zum Ignorieren von Logs.

Warum zählen Uptime-Monitor-Requests zu meinem Budget und wie schließe ich sie aus?

Uptime monitors rufen Ihren endpoint nach einem regelmäßigen Zeitplan ab, und wenn AppSignal installiert ist, zählen diese Requests als transactions zu Ihrem monatlichen Request-Budget. Um zu verhindern, dass sie mitzählen, fügen Sie die Health-Check-Action zu ignore_actions in Ihrer AppSignal-Konfiguration hinzu — AppSignal hört dann vollständig auf, diese transactions aufzuzeichnen. Für Ruby:
Für Node.js:
Für Python (Django oder andere Frameworks) setzen Sie ignore_actions in appsignal.py:
Um den genauen Action-Namen zu finden, öffnen Sie Performance → Issue list und kopieren Sie ihn aus der Spalte „Action name”. Die vollständige Konfigurationsreferenz finden Sie im Leitfaden zum Ignorieren von Actions.

Wie ignoriere ich eine bestimmte Fehlermeldung im JavaScript-Front-End?

Um Fehler zu ignorieren, die einem bestimmten Nachrichtenmuster in der AppSignal-JavaScript-Integration entsprechen, übergeben Sie beim Initialisieren von Appsignal ein ignoreErrors-Array. Jedes Element im Array ist ein regulärer Ausdruck, der mit der Fehlermeldung abgeglichen wird.
Fehler, deren Nachrichten mit einem Muster in ignoreErrors übereinstimmen, werden nicht an AppSignal gesendet. Andere Fehler derselben Klasse werden weiterhin gemeldet. Die vollständige Liste der Initialisierungsoptionen finden Sie unter Front-End-Konfigurationsoptionen.

Wie unterdrücke ich Logs, die von appsignal-wrap gesendet werden?

appsignal-wrap leitet standardmäßig stdout und stderr an AppSignal weiter. Die Konfigurationsoption ignore_logs gilt nicht für appsignal-wrap. Um die Ausgabe zu unterdrücken, übergeben Sie --no-stdout und/oder --no-stderr an den Befehl appsignal-wrap:
Dies sind reine CLI-Flags und können nicht über Umgebungsvariablen gesetzt werden. Die vollständige Liste der Optionen finden Sie in der appsignal-wrap-Dokumentation.

Wie leite ich den Traffic des AppSignal-Agents über einen HTTP-Proxy um?

Setzen Sie die Konfigurationsoption http_proxy (oder die Umgebungsvariable APPSIGNAL_HTTP_PROXY) auf die vollständige Adresse Ihres Proxys. Der AppSignal-Agent leitet den gesamten ausgehenden Traffic — transactions, Fehler, Metriken und Logs — über diesen Proxy. Für Ruby:
Oder als Umgebungsvariable:
Setzen Sie für Node.js httpProxy in Ihrer Konfiguration:
Die Option ist für Ruby-, Elixir-, Node.js- und Python-Integrationen verfügbar. Ihr Proxy muss ausgehende Verbindungen zu AppSignal-Endpoints herstellen können, damit Daten weitergeleitet werden. Die vollständige Referenz finden Sie unter Ruby-Konfigurationsoptionen und Elixir-Konfigurationsoptionen.

Wie füge ich meiner Anwendung zusätzliche Instrumentation hinzu?

Sie können Ihrer Anwendung zusätzliche Instrumentation hinzufügen, um durch die Messung der Dauer einzelner Ereignisse mehr Einblicke in deren Performance zu erhalten. Erfahren Sie wie, in der Dokumentation für unser Ruby Gem und unser Elixir-Paket.

Was ist der Unterschied zwischen setRootName und setName?

setName und setRootName benennen beide spans um, aber auf verschiedenen Ebenen. setName setzt den Namen eines einzelnen span so, wie er in der Performance-Sample-Timeline erscheint, während setRootName den Namen der Root-transaction festlegt — das, was Sie in der Performance-Übersicht und der Transaktionsliste sehen. Ein gutes Muster ist, setRootName einmal auf Ihrem äußersten Handler aufzurufen (zum Beispiel `${request.method} ${pattern}`, um einen Titel wie GET /users/:id zu erzeugen), und setName zusammen mit setCategory für innere spans wie Middleware, Loader und Actions zu verwenden, damit diese als klar beschriftete events in der Timeline-Aufschlüsselung erscheinen. Weitere Informationen zur Benennung und zum Hinzufügen von spans finden Sie im Leitfaden zur Node.js-Instrumentation.

Wie betreibe ich mehrere Anwendungen auf einem Host?

Standardmäßig geht AppSignal davon aus, dass eine Anwendung auf einem Host läuft. Wenn Sie mehr als eine Anwendung auf einem Host betreiben, kann es zu unerwartetem Verhalten kommen, z. B. dass Daten für eine andere Anwendung gemeldet werden. Um AppSignal für mehrere Anwendungen auf einem Host zu konfigurieren, muss das AppSignal-Arbeitsverzeichnis konfiguriert werden. Lesen Sie mehr darüber, wie Sie das Arbeitsverzeichnis in unserem Leitfaden zum Betrieb mehrerer Anwendungen auf einem Host konfigurieren.

Welche Betriebssysteme unterstützt AppSignal?

Bitte lesen Sie unsere Seite Betriebssysteme für die vollständige Liste der unterstützten Betriebssysteme und aller erforderlichen Pakete.

Wie debugge ich ein Problem mit der AppSignal-Integration?

Bitte lesen Sie unseren Debugging-Leitfaden für eine vollständige Anleitung zum Debuggen von Problemen mit der AppSignal-Integration. Sie können auch unsere Seite Bekannte Probleme auf Probleme prüfen, die in Ihrer Version der AppSignal-Integration vorhanden sein könnten.

Unterstützt AppSignal Windows?

AppSignal unterstützt Windows nicht, und es gibt keine Pläne, Windows-Unterstützung hinzuzufügen. Wir versuchen jedoch, die AppSignal-Bibliotheken unter Microsoft Windows ohne Fehler oder Build-Probleme installierbar zu halten.

Warum schlägt die Installation des AppSignal Ruby Gem mit einem JSON::Fragment-Fehler fehl?

Dieser Fehler tritt bei der Installation von appsignal 4.x mit Ruby 3.0 oder älter auf. Das in AppSignal 4.x als Abhängigkeit gebündelte json-gem hat JSON::Fragment eingeführt, eine Konstante, die nur in Ruby 3.1 und neuer verfügbar ist. Auf älteren Ruby-Versionen schlägt der Build der nativen Erweiterung fehl mit:
Die empfohlene Lösung ist, Ruby auf 3.1 oder höher zu aktualisieren, sodass Sie die aktuelle AppSignal-4.x-Version ohne Einschränkungen verwenden können. Wenn Sie Ruby nicht sofort aktualisieren können, können Sie als vorübergehende Lösung auf AppSignal 3.x pinnen: Fügen Sie gem "appsignal", "~> 3.0" zu Ihrem Gemfile hinzu und führen Sie bundle update appsignal aus. AppSignal 3.x funktioniert mit Ruby 2.7 und Ruby 3.0, erhält jedoch keine neuen Funktionen aus der 4.x-Linie, also planen Sie ein Ruby-Upgrade ein, sobald es möglich ist.

Wie konfiguriere ich AppSignal in einer Hanami-Anwendung?

AppSignal konfiguriert sich in Hanami nicht automatisch wie in Rails. Verwenden Sie eine Ruby-Konfigurationsdatei (config/appsignal.rb) anstatt der veralteten YAML-Datei (config/appsignal.yml) — das YAML-Format ist veraltet und wird in der nächsten Hauptversion des gem entfernt. Erstellen Sie config/appsignal.rb mit:
Stellen Sie dann sicher, dass config.ru die integration nach Hanami lädt:
Wenn Sie eine bestehende config/appsignal.yml haben, entfernen Sie sie oder fügen Sie einen development-Abschnitt mit active: true hinzu — beide Dateien gleichzeitig zu haben führt zu Konflikten. AppSignal startet in der development-Umgebung standardmäßig nicht; activate_if_environment aktiviert es explizit. Die vollständige Einrichtung finden Sie in der Hanami-Integrationsdokumentation.

Warum werden Fehler in Phoenix LiveComponent nicht von AppSignal erfasst?

AppSignal erfasst Phoenix-Fehler durch das Abhören von Phoenix-Telemetry-events. Wenn ein LiveComponent Form-events direkt verarbeitet, verwendet Phoenix einen internen Pfad, der diese Telemetry-events nicht aussendet, sodass der Fehler nie gemeldet wird. Um Fehler aus LiveComponent zu melden, verwenden Sie Appsignal.send_error/2, um sie manuell zu senden:
Alternativ können Sie Logik, die eine Exception auslösen kann, aus dem Template der Komponente in deren handle_event/3- oder update/2-Callbacks verschieben, wo Phoenix-Telemetry ausgelöst wird. Diese Lücke wurde Upstream in phoenix_live_view behoben. Ein Update auf die neueste Version ermöglicht es AppSignal, diese Fehler automatisch zu erfassen.

Benutzerkonto

Kann ich E-Mail-Benachrichtigungen an ein bestimmtes Teammitglied senden?

E-Mail-Benachrichtigungen können nicht an ein bestimmtes Teammitglied gesendet werden. Jedes Mitglied steuert seine eigenen Benachrichtigungseinstellungen. Um sie zu aktualisieren, gehen Sie zu Account Settings → Email Settings und schalten Sie Benachrichtigungen für jede App ein oder aus. Die verfügbaren Optionen finden Sie unter Notification settings.

Wie aktiviere ich die Zwei-Faktor-Authentifizierung (2FA) für die AppSignal-App?

Weitere Informationen zur Aktivierung von 2FA finden Sie auf unserer Seite Zwei-Faktor-Authentifizierung.

Warum funktionieren meine Zwei-Faktor-Authentifizierungs- (2FA-) Codes nicht?

Wenn die Codes Ihrer Authenticator-App beim Anmelden abgelehnt werden, ist die häufigste Ursache eine Abweichung der Uhr auf dem Gerät, das sie erzeugt. Zwei-Faktor-Authentifizierungs-Codes sind zeitbasiert (TOTP), daher muss die Uhr des Geräts genau gehen — dies funktioniert häufig nach einem Zeitzonenwechsel nicht mehr. Aktivieren Sie das automatische (Netzwerk-)Datum und die Uhrzeit auf dem Gerät und versuchen Sie es dann mit dem neu generierten Code. Wenn Sie sich weiterhin nicht anmelden können, verwenden Sie einen der fünf Wiederherstellungscodes, die Sie beim Aktivieren von 2FA gespeichert haben, um die Zwei-Faktor-Authentifizierung zu umgehen. Weitere Informationen zu Wiederherstellungscodes finden Sie unter Zwei-Faktor-Authentifizierung.

Wie registriere ich mein Zwei-Faktor-Authentifizierungs-Gerät erneut?

Um 2FA auf einer neuen Authenticator-App oder einem neuen Gerät einzurichten, gehen Sie zu Account Settings → Security → Two-factor authentication, deaktivieren Sie 2FA und aktivieren Sie es dann erneut. Ein neuer QR-Code erscheint, den Sie mit Ihrer Authenticator-App scannen können. Um zur Deaktivierungsoption zu gelangen, müssen Sie sich zuerst mit einem aktuellen Code oder einem Wiederherstellungscode authentifizieren. Die vollständige Einrichtungsanleitung finden Sie unter Zwei-Faktor-Authentifizierung.

Welche IP-Adressen verwendet AppSignal?

Derzeit verwendet die AppSignal Push API die folgenden IP-Adressen:
Derzeit stammen die AppSignal-Webhooks von den folgenden IP-Adressen:
Wir empfehlen nicht, bestimmte IP-Adressen auf eine Allowlist zu setzen. Sie können sich ändern, und in Zukunft kommen möglicherweise weitere hinzu, zum Beispiel wenn wir unsere Load Balancer rotieren oder schnell Server hinzufügen müssen. Wenn Sie sich dennoch entscheiden, unsere IP-Adressen auf eine Allowlist zu setzen, schreiben Sie bitte unserem Support-Team eine E-Mail, und wir tun unser Bestes, um Sie über bevorstehende Änderungen zu informieren.

Fehler & Performance

Warum wird mein Performance-Issue immer als „Closed” markiert?

Der Open- oder Closed-Status eines Issues wird durch seine Benachrichtigungseinstellungen bestimmt, nicht dadurch, ob das zugrunde liegende Problem immer noch auftritt. AppSignal markiert ein Issue als Open, wenn es eine Benachrichtigung dafür sendet. Performance-Issues verwenden standardmäßig die Einstellung „Never Notify”, sodass keine Benachrichtigung gesendet wird — weshalb sie als Closed bleiben. Damit ein Performance-Issue bei neuen Vorkommen geöffnet wird, ändern Sie seine Benachrichtigungseinstellung, entweder pro Issue oder durch Aktualisieren Ihrer organisationsweiten Standardeinstellung. Wie das konfiguriert wird, erfahren Sie unter Notification settings.

Wie sehe ich Fehleranzahlen pro Namespace?

Um Fehleranzahlen pro namespace zu sehen, erstellen Sie ein Number-Chart, das die Metrik transaction_exception_count verwendet (AppSignals Zählung der in einer Anwendung aufgezeichneten Fehler), gefiltert nach dem namespace-Tag:
  1. Öffnen Sie die Anwendung, die Sie messen möchten, gehen Sie zu Dashboards und fügen Sie ein neues Chart hinzu.
  2. Wählen Sie den Tab Number aus.
  3. Setzen Sie die Metrik auf transaction_exception_count.
  4. Fügen Sie den Tag namespace hinzu und geben Sie den Namespace-Namen ein (zum Beispiel web oder background).
  5. Setzen Sie den Aggregationstyp auf Total value.
  6. Erstellen Sie das Chart.
Das Chart zeigt die Gesamtfehleranzahl für diesen namespace über den von Ihnen beim Anzeigen ausgewählten Zeitraum. AppSignal speichert Fehlerdaten separat pro Anwendung, sodass es keine einzige Summe über alle Anwendungen gibt — erstellen Sie ein Chart pro namespace pro Anwendung und addieren Sie die Zahlen selbst, wenn Sie eine Gesamtsumme benötigen.

Wie lange werden Uptime monitoring-Daten aufbewahrt?

Uptime monitoring speichert minütliche Metriken für 30 Tage und stündliche Metriken für 5 Jahre. Um tägliche Uptime-Trends über einen längeren Zeitraum — zum Beispiel ein ganzes Jahr — anzuzeigen, verwenden Sie die Datumsauswahl in der Ansicht Uptime monitoring, um einen benutzerdefinierten Datumsbereich zu wählen.

Wie finde ich die Ursache langsamer API-Requests?

Beginnen Sie unter Performance → Slow API requests. Requests sind nach Impact sortiert — die Kombination aus Dauer und Häufigkeit — sodass die obersten Einträge die wahrscheinlichsten Verursacher sind. Bei Auswahl eines Requests werden dessen mittlere Dauer, Antwortzeit-Diagramm, throughput und die Liste der Actions, die ihn enthalten, angezeigt. Für Datenbankabfragen prüfen Sie Performance → Slow queries. Jede Query ist nach Impact sortiert, und bei Auswahl wird angezeigt, welche Actions sie auslösen. Um N+1-Queries zu finden, öffnen Sie Performance → Issue list. Actions, die mit dem Tag N+1 markiert sind, enthalten wiederholte Datenbankaufrufe. Öffnen Sie ein Sample und betrachten Sie die Performance-Timeline — events, die mit x2, x5 usw. markiert sind, weisen auf dieselbe Query hin, die innerhalb eines einzelnen Requests wiederholt wird. Eine geführte Anleitung finden Sie unter Langsame Datenbankabfragen finden und Langsame HTTP-Requests finden.

Wie ändere ich die Front-End-Fehlergruppierungsstrategie?

Standardmäßig gruppiert AppSignal Front-End-Fehler nach Fehlernamen. Wenn mehrere nicht abgefangene Fehler einen generischen Namen teilen, werden sie zu einem einzigen Issue zusammengeführt, selbst wenn ihre Nachrichten und Stacktraces unterschiedlich sind. Um überaggregierte Front-End-Fehler danach aufzuteilen, wo sie in Ihrem Code entstehen, gehen Sie zur Seite Settings Ihrer Anwendung und setzen Sie Front-end error grouping strategy auf Relevant backtrace line strategy. Dies gruppiert Fehler nach der ersten Zeile Ihres eigenen Codes im Backtrace anstelle des Fehlernamens. Damit dies funktioniert, laden Sie Source Maps für Ihre Anwendung hoch — ohne diese kann AppSignal den Backtrace nicht zu Ihren Quelldateien auflösen. Wie Sie diese einrichten, erfahren Sie unter Front-end source maps. Sie benötigen Owner-Zugriff auf die Organisation, um diese Einstellung zu ändern. Wenn die Option nicht sichtbar ist, bitten Sie einen Owner, die Änderung vorzunehmen.

Wie suche ich nach Fehlern anhand der Nachricht?

Um nach Fehlern anhand ihres Nachrichtentexts zu suchen, verwenden Sie das Tag message: in der AppSignal-Suchleiste. Zum Beispiel gibt die Eingabe von message:"could not connect" alle Fehler-Samples zurück, deren Fehlernachricht diese Phrase enthält. Die Suchleiste erscheint im Header des AppSignal-dashboard.

Wie erhalte ich Anomaly-Benachrichtigungen per Webhook?

Anomaly-Benachrichtigungen per Webhook werden am Anomaly-Trigger konfiguriert, nicht auf dem Webhook-Einstellungsbildschirm. Erstellen oder bearbeiten Sie einen Anomaly-Trigger, scrollen Sie zu Notify me through und wählen Sie den Webhook aus, den Sie in AppSignal eingerichtet haben. Der Webhook-Einstellungsbildschirm listet nur Deploys-, Errors- und Performance-events auf — die Anomaly-Verbindung befindet sich am Trigger selbst. Wie Sie Trigger einrichten und bearbeiten, erfahren Sie unter Anomaly detection triggers.

Warum zeigt meine Elixir-App eine plötzliche Spitze bei der Request-Nutzung?

Eine plötzliche Spitze bei der Request-Nutzung nach einem Deploy wird oft durch eine große Anzahl von Fehlern verursacht, die von Ihrer Anwendung generiert werden. Fehler zählen in AppSignal als Requests. Wenn der in Ihrem dashboard angezeigte Fehler-throughput deutlich niedriger erscheint als der Anstieg der Request-Anzahl, verwenden Sie möglicherweise eine ältere Version der AppSignal-Elixir-Integration. In älteren Versionen erscheinen nur gesampelte Fehler in den Fehler-throughput-Metriken, aber alle Fehler-Requests zählen zu Ihrer gesamten Request-Nutzung. Diese Diskrepanz lässt die Spitze größer erscheinen, als die Fehleranzahl vermuten lässt. Um die Diskrepanz zu beheben, aktualisieren Sie das appsignal-Elixir-Paket auf die neueste Version. Nach dem Update spiegeln die Fehler-throughput-Metriken die vollständige Anzahl wider und stimmen mit dem überein, was AppSignal für die Abrechnung erfasst. Um die Fehler zu finden, die die Spitze verursachen, gehen Sie zu Errors und filtern Sie nach dem Deploy-Datum. Anleitungen zum Aktualisieren finden Sie im Elixir-Installationsleitfaden.