Naar hoofdinhoud gaan
Het AppSignal voor Python-pakket bevat een zelfdiagnostisch hulpmiddel waarmee u de installatie en configuratie van uw AppSignal-integratie kunt debuggen. Het is een van de eerste tools die ons supportteam u vraagt uit te voeren bij het debuggen van een probleem.

Het diagnoserapport

U kunt deze diagnosetool gebruiken om uw AppSignal-installatie te testen en valideren. Het geeft nuttige informatie weer om problemen te debuggen en controleert of de AppSignal-agent kan draaien op de architectuur van de machine en kan communiceren met de AppSignal-servers. Deze diagnosetool verzamelt en geeft het volgende weer:
  • Informatie over het AppSignal-pakket.
  • Informatie over het hostsysteem en Python.
  • Of de AppSignal-agent op het hostsysteem kan draaien.
  • Alle geconfigureerde configuratie-opties (inclusief standaardwaarden).
  • Of de configuratie geldig en actief is.
  • Of de Push API-sleutel aanwezig en geldig is (internetverbinding vereist).
  • Vanwaar de waarden van configuratie-opties afkomstig zijn.
  • Of de vereiste systeempaden bestaan, beschrijfbaar zijn, en welke gebruiker en groep eigenaar zijn.
  • Kleine fragmenten van het einde van de beschikbare logbestanden.
Lees meer over het gebruik van het diagnose-commando in onze Debugging-documentatie.

Het rapport indienen

Nadat het rapport is aangemaakt, wordt u gevraagd het rapport naar onze servers te versturen. Als u deze prompt accepteert, wordt het rapport naar onze servers verzonden en ontvangt u een supporttoken. Wanneer u deze supporttoken naar ons stuurt, zullen wij het rapport bekijken en u helpen het probleem te debuggen. We hebben gemerkt dat het kopiëren en plakken van de rapportoutput meestal de opmaak verliest en het moeilijker leesbaar maakt, daarom wordt het in JSON-formaat naar onze servers verzonden. Nadat het rapport naar onze servers is verzonden, wordt een link naar de webweergave van het rapport in de diagnose-output afgedrukt. Deze webweergave laat ook eventuele validatieproblemen en waarschuwingen zien die ons systeem heeft gedetecteerd.

Gebruik

Voer in uw project op de command-line uit:
python -m appsignal diagnose
Als u een probleem ervaart in productie en het rapport voor support naar AppSignal moet versturen, kunt u het volgende commando uitvoeren om het rapport te genereren en naar onze servers te versturen:
python -m appsignal diagnose --send-report

Opties

OptieGebruikBeschrijving
[no]-send-report--[no-]send-reportVerstuur het rapport automatisch, of niet.

Vlag voor rapportverzending

Met de --send-report-vlag is het mogelijk om het rapport automatisch te versturen zonder dat erom wordt gevraagd. Dit maakt het gemakkelijker in gebruik in niet-interactieve omgevingen. Om diagnose uit te voeren en de rapportgegevens naar AppSignal te versturen, voert u het onderstaande commando uit:
python -m appsignal diagnose --send-report
Om diagnose uit te voeren zonder de rapportgegevens naar AppSignal te versturen, voert u het onderstaande commando uit:
python -m appsignal diagnose --no-send-report

Configuratie-outputformaat

Formaat voor waarden van configuratie-opties

De configuratie-opties worden naar de CLI afgedrukt als hun geïnspecteerde waarden. Dit betekent dat we ze afdrukken zoals Python dat in een console zou doen.
  • Stringwaarden worden afgedrukt met dubbele aanhalingstekens eromheen, bijv. "My app name".
  • Booleanwaarden worden afgedrukt als hun ruwe waarden: True en False.
  • Arraywaarden worden afgedrukt als een verzameling waarden omgeven door vierkante haken, bijv. ["accept", "accept-charset"].
    • Lege arrays worden afgedrukt als twee vierkante haken: [].

Configuratiebronnen

De configuratiesectie geeft ook de herkomst van de waarden van configuratie-opties weer, wat kan helpen bronnen te identificeren die waarden overschrijven die in andere configuratiebronnen zijn gedefinieerd. Lees meer over configuratiebronnen, hun laadvolgorde en prioriteit in de documentatie over configuratielaadvolgorde. De configuratie-opties worden weergegeven op basis van de bron van hun waarden en het aantal bronnen dat ze instelt, zoals in het onderstaande voorbeeld:
Shell
Configuration
  # Option with a value loaded only from the default source
  send_params: True

  # Option with one source
  # A different source than the default source
  name: "My app name" (Loaded from file)

  # Option with multiple sources
  # Listed in order of priority (highest priority last)
  active: True
    Sources:
      default: False
      file:    False
      env:     True