Naar hoofdinhoud gaan
Er bestaat niet zoiets als een domme vraag. Op deze pagina vindt u de antwoorden op de vragen die ons het vaakst worden gesteld. Als u meer hulp nodig heeft, bekijk dan onze supportpagina

Inhoud

Aan de slag

Ik heb hulp nodig om aan de slag te gaan. Waar begin ik?

Als u nieuw bent bij AppSignal of meer wilt weten over het configureren van AppSignal-functies, lees dan onze gidsen

AppSignal-libraries

Welke programmeertalen ondersteunt AppSignal?

AppSignal ondersteunt de programmeertalen Node.js, Ruby en Elixir. We hebben ook JavaScript-packages voor het opvangen van client-side-fouten in ondersteunde browsers.

Data filteren

Hoe negeer ik actions in mijn applicatie?

U kunt Actions negeren om te stoppen met het vastleggen van data voor specifieke actions, requests, achtergrondtaken, enz.

Hoe negeer ik fouten in mijn applicatie?

U kunt Fouten negeren (op basis van hun naam) om te voorkomen dat AppSignal ze rapporteert en u erover waarschuwt.

Hoe filter ik data die naar AppSignal wordt verzonden?

Lees een van de volgende gidsen om te leren hoe u de data filtert die naar AppSignal wordt verzonden:

Welke regex-syntaxis ondersteunt ignore_logs?

ignore_logs ondersteunt een beperkte subset van reguliere-expressiesyntaxis: ^ (begin van string), $ (einde van string) en .* (wildcard). Volledige regex-constructies zoals tekenklassen ([.]) zijn niet geldig en worden stilzwijgend genegeerd. Om een exacte logregel te matchen, ankert u deze met zowel ^ als $. Om een prefix te matchen, gebruikt u ^ gevolgd door de letterlijke tekst. Om ergens in het bericht te matchen, gebruikt u .* eromheen. Zie de ignore logs-gids voor de volledige syntaxisreferentie.

Hoe onderdruk ik logs die door appsignal-wrap worden verzonden?

appsignal-wrap stuurt standaard stdout en stderr door naar AppSignal. De configuratieoptie ignore_logs is niet van toepassing op appsignal-wrap. Om output te onderdrukken, geeft u --no-stdout en/of --no-stderr mee aan het appsignal-wrap-commando:
appsignal-wrap --no-stdout --no-stderr your-api-key -- your-command
Dit zijn CLI-only vlaggen en kunnen niet via omgevingsvariabelen worden ingesteld. Zie de appsignal-wrap-docs voor de volledige lijst met opties.

Hoe voeg ik extra instrumentatie toe aan mijn applicatie?

Extra instrumentatie kan aan uw applicatie worden toegevoegd om u meer inzicht te geven in hoe uw applicatie presteert door de duur van afzonderlijke gebeurtenissen te meten. Leer hoe in de documentatie voor onze Ruby Gem en Elixir Package.

Wat is het verschil tussen setRootName en setName?

setName en setRootName hernoemen beide spans, maar op verschillende niveaus. setName stelt de naam in van een individuele span zoals deze verschijnt in de tijdlijn van de performance-sample, terwijl setRootName de naam instelt van de root-transaction — wat u ziet in het performance-overzicht en de transactielijst. Een goed patroon is om setRootName één keer aan te roepen op uw buitenste handler (bijvoorbeeld `${request.method} ${pattern}` om een titel als GET /users/:id te produceren), en setName samen met setCategory te gebruiken op binnenste spans zoals middleware, loaders en actions, zodat ze als duidelijk gelabelde events in de tijdlijnopbouw verschijnen. Voor meer over naming en het toevoegen van spans, zie de Node.js-instrumentatiegids.

Hoe draai ik meerdere applicaties op één host?

Standaard is AppSignal geconfigureerd om aan te nemen dat er één applicatie op één host draait. Als u meer dan één applicatie op een host draait, kan er onverwacht gedrag optreden, zoals data die voor een andere applicatie wordt gerapporteerd. Om AppSignal te configureren voor meerdere applicaties op één host, moet de AppSignal Working Directory worden geconfigureerd. Lees meer over het configureren van de working directory in onze Gids voor meerdere applicaties op één host

Welke besturingssystemen ondersteunt AppSignal?

Lees onze Besturingssystemen-pagina voor de volledige lijst met ondersteunde besturingssystemen en eventuele vereiste pakketten.

Hoe debug ik een probleem met de AppSignal-integratie?

Lees onze Debugginggids voor een volledige gids voor het debuggen van problemen met de AppSignal-integratie. U kunt ook onze Bekende issues-pagina raadplegen voor issues die mogelijk in uw versie van de AppSignal-integratie aanwezig zijn.

Ondersteunt AppSignal Windows?

AppSignal ondersteunt geen Windows, en er zijn geen plannen om Windows-ondersteuning toe te voegen. We proberen wel de AppSignal-libraries installeerbaar te maken op Microsoft Windows zonder fouten of buildproblemen.

Waarom mislukt het installeren van de AppSignal Ruby Gem met een JSON::Fragment-fout?

Deze fout treedt op bij het installeren van appsignal 4.x met Ruby 3.0 en eerder. De json-gem die als afhankelijkheid in AppSignal 4.x is opgenomen, heeft JSON::Fragment geïntroduceerd, een constante die alleen beschikbaar is op Ruby 3.1 en later. Op oudere Ruby-versies mislukt de native extension-build met:
uninitialized constant JSON::Fragment (NameError)
De aanbevolen oplossing is om Ruby te upgraden naar 3.1 of later, zodat u de huidige AppSignal 4.x-release zonder beperkingen kunt gebruiken. Als u Ruby niet meteen kunt upgraden, kunt u als tijdelijke oplossing vastpinnen op AppSignal 3.x: voeg gem "appsignal", "~> 3.0" toe aan uw Gemfile en voer bundle update appsignal uit. AppSignal 3.x werkt met Ruby 2.7 en Ruby 3.0, maar krijgt geen nieuwe functies uit de 4.x-lijn, dus plan om Ruby te upgraden wanneer dat mogelijk is.

Hoe configureer ik AppSignal in een Hanami-applicatie?

AppSignal configureert zichzelf niet automatisch in Hanami zoals in Rails. Gebruik een Ruby-configuratiebestand (config/appsignal.rb) in plaats van het oude YAML-bestand (config/appsignal.yml) — het YAML-formaat is verouderd en wordt in de volgende major-versie van de gem verwijderd. Maak config/appsignal.rb aan met:
Appsignal.configure do |config|
  config.activate_if_environment(:development, :staging, :production)
  config.name = "Your App Name"
  config.push_api_key = "your-key-here"
end
Zorg er vervolgens voor dat config.ru de integratie na Hanami laadt:
require "appsignal"
require "hanami/boot"

Appsignal.load(:hanami)
Appsignal.start

run Hanami.app
Als u een bestaande config/appsignal.yml heeft, verwijder die dan of voeg een development-sectie toe met active: true — het hebben van beide bestanden veroorzaakt conflicten. AppSignal start standaard niet in de development-omgeving; activate_if_environment schakelt het expliciet in. Zie de Hanami-integratiedocs voor de volledige setup.

Waarom worden fouten in Phoenix LiveComponent niet door AppSignal opgevangen?

AppSignal vangt Phoenix-fouten op door te luisteren naar Phoenix-telemetrie-events. Wanneer een LiveComponent form-events direct afhandelt, gebruikt Phoenix een intern pad dat die telemetrie-events niet uitstuurt, waardoor de fout nooit wordt gerapporteerd. Om fouten vanuit LiveComponent te rapporteren, gebruikt u Appsignal.send_error/2 om ze handmatig te verzenden:
rescue e ->
  Appsignal.send_error(e, __STACKTRACE__)
  reraise e, __STACKTRACE__
end
U kunt ook logica die mogelijk een fout opwerpt verplaatsen uit de template van het component naar de handle_event/3- of update/2-callbacks, waar Phoenix-telemetrie wel afgaat. Dit gat is upstream opgelost in phoenix_live_view. Door te updaten naar de nieuwste release kan AppSignal deze fouten automatisch opvangen.

Gebruikersaccount

Hoe schakel ik tweefactorauthenticatie (2FA) in voor de AppSignal-app?

Raadpleeg onze Tweefactorauthenticatie-pagina voor meer informatie over het inschakelen van 2FA.

Waarom werken mijn tweefactorauthenticatiecodes (2FA) niet?

Als de codes van uw authenticator-app worden geweigerd wanneer u inlogt, is de meest voorkomende oorzaak klokafwijking op het apparaat dat ze genereert. Tweefactorauthenticatiecodes zijn tijdgebaseerd (TOTP), dus de klok van dat apparaat moet nauwkeurig zijn — dit gaat vaak mis na het wisselen van tijdzones. Schakel automatische (netwerk-) datum en tijd in op het apparaat en probeer vervolgens de nieuw gegenereerde code. Als u nog steeds niet kunt inloggen, gebruik dan een van de vijf recovery codes die u heeft opgeslagen toen u 2FA inschakelde om tweefactorauthenticatie te omzeilen. Zie Tweefactorauthenticatie voor meer over recovery codes.

Welke IP-adressen gebruikt AppSignal?

Momenteel gebruikt de AppSignal Push API de volgende IP-adressen:
185.191.3.93
185.191.3.94
185.191.3.125
185.191.3.126
Momenteel zijn de AppSignal-webhooks afkomstig van de volgende IP-adressen:
185.191.3.107
185.191.3.72
185.191.3.116
185.191.3.84
We raden niet aan om specifieke IP-adressen op een allowlist te zetten. Ze kunnen veranderen en er kunnen in de toekomst meer worden toegevoegd, bijvoorbeeld wanneer we onze loadbalancers moeten verversen of snel servers moeten toevoegen. Als u besluit onze IP-adressen op een allowlist te zetten, stuur dan een e-mail naar ons supportteam, dan zullen we ons best doen om u op de hoogte te stellen van aankomende wijzigingen.

Fouten & performance

Waarom wordt mijn performance-issue altijd als Closed gemarkeerd?

Of een issue Open of Closed is, wordt bepaald door de meldingsinstellingen, niet door de vraag of het onderliggende probleem nog steeds optreedt. AppSignal markeert een issue als Open wanneer er een melding voor wordt verzonden. Performance-issues gebruiken standaard de instelling “Never Notify”, dus er wordt geen melding verzonden — daarom blijven ze Closed. Om ervoor te zorgen dat een performance-issue opent bij nieuwe voorkomens, wijzigt u de meldingsinstelling, hetzij per issue of door uw standaardinstelling op organisatieniveau bij te werken. Zie Meldingsinstellingen voor hoe u dit configureert.

Hoe zie ik foutaantallen per namespace?

Om foutaantallen per namespace te zien, maakt u een Number chart die de metriek transaction_exception_count gebruikt (de telling van AppSignal van fouten die in een applicatie zijn vastgelegd), gefilterd op de namespace-tag:
  1. Open de applicatie die u wilt meten, ga naar Dashboards en voeg een nieuwe chart toe.
  2. Selecteer het tabblad Number.
  3. Stel de metriek in op transaction_exception_count.
  4. Voeg de namespace-tag toe en voer de naam van de namespace in (bijvoorbeeld web of background).
  5. Stel het aggregatietype in op Total value.
  6. Maak de chart aan.
De chart toont het totale foutaantal voor die namespace over de tijdsperiode die u selecteert bij het bekijken ervan. AppSignal slaat foutdata afzonderlijk per applicatie op, dus er is geen enkel totaal over alle applicaties — maak één chart per namespace per applicatie en tel de tellingen zelf bij elkaar op als u een totaalcijfer nodig heeft.

Hoe lang worden uptime monitoring-data bewaard?

Uptime monitoring slaat minuutmetrieken 30 dagen op en uurmetrieken 5 jaar. Om dagelijkse uptime-trends over een langere periode te bekijken — bijvoorbeeld een heel jaar — gebruikt u de datumkiezer in de uptime monitoring-weergave om een aangepast datumbereik te selecteren.

Hoe vind ik de oorzaak van trage API-requests?

Begin in Performance → Slow API requests. Requests worden gesorteerd op impact — de combinatie van duur en frequentie — zodat de bovenste items de meest waarschijnlijke boosdoeners zijn. Als u een request selecteert, ziet u de gemiddelde duur, response-tijdgrafiek, throughput en de lijst met actions waarin deze voorkomt. Voor databasequeries kijkt u bij Performance → Slow queries. Elke query wordt gesorteerd op impact en als u er een selecteert ziet u welke actions deze triggeren. Om N+1-queries te vinden, opent u Performance → Issue list. Actions die met de N+1-tag zijn gemarkeerd, bevatten herhaalde database-aanroepen. Open een sample en bekijk de performance-tijdlijn — events gemarkeerd met x2, x5 enzovoort geven aan dat dezelfde query wordt herhaald binnen één request. Voor een begeleide uitleg, zie Trage databasequeries vinden en Trage HTTP-requests vinden.