> ## Documentation Index
> Fetch the complete documentation index at: https://docs.appsignal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# AppSignal voor Node.js: Diagnosetool

Het AppSignal Node.js-pakket wordt geleverd met een zelfdiagnose-tool. Deze tool kan worden gebruikt om uw AppSignal-installatie te debuggen en is een van de eerste dingen waar ons supportteam om vraagt wanneer er een probleem is.

## Het diagnoserapport

Deze commandline-tool is nuttig bij het testen van AppSignal op een systeem en het valideren van de lokale configuratie. De tool produceert nuttige informatie 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 toont het volgende:

* informatie over het AppSignal-pakket.
* informatie over het hostsysteem en Node.js.
* of de AppSignal-[extensie](/appsignal/how-appsignal-operates#extension) en [agent](/appsignal/how-appsignal-operates#agent) kunnen draaien op het hostsysteem.
* alle geconfigureerde configuratie-opties (inclusief standaardwaarden).
* of de configuratie geldig en actief is.
* of de Push API-sleutel aanwezig en geldig is (internetverbinding vereist).
* waar configuratie-optiewaarden vandaan komen.

Lees meer over hoe u het diagnosecommando gebruikt op de [Debugging][debugging]-pagina.

## Het rapport indienen

U moet de optie `--send-report` doorgeven om het diagnoserapport naar AppSignal te versturen. Als deze wordt gebruikt, wordt het rapport naar onze servers verzonden en ontvangt u een support-token.

Wanneer u [dit support-token naar ons stuurt](mailto:support@appsignal.com), bekijken wij het rapport en helpen wij u bij het debuggen van het probleem. We hebben gezien dat het kopiëren en plakken van de rapportuitvoer doorgaans opmaak verliest en het moeilijker leesbaar maakt, daarom wordt het in JSON-formaat naar onze servers verzonden.

## Gebruik

Voer in uw project op de commandline (een map met een `package.json` en `@appsignal/nodejs` geïnstalleerd) het volgende uit:

<CodeGroup>
  ```bash Bash theme={null}
  npx @appsignal/cli diagnose
  ```
</CodeGroup>

Op zijn minst moet `APPSIGNAL_PUSH_API_KEY` zijn ingesteld voordat het diagnosecommando kan worden uitgevoerd. Als deze nog niet in uw omgeving is ingesteld, kunt u deze ook tijdens runtime instellen met de optie `--api-key`:

<CodeGroup>
  ```bash Bash theme={null}
  npx @appsignal/cli diagnose --api-key="<PUSH API KEY HERE>"
  ```
</CodeGroup>

U kunt de omgevingsvariabele ook tijdens runtime instellen:

<CodeGroup>
  ```bash Bash theme={null}
  APPSIGNAL_PUSH_API_KEY="<PUSH API KEY HERE>" npx @appsignal/cli diagnose
  ```
</CodeGroup>

Om de diagnose op uw productieserver uit te voeren en het rapport voor ondersteuningsdoeleinden naar AppSignal te versturen, kunt u het volgende commando uitvoeren:

<CodeGroup>
  ```bash Bash theme={null}
  npx @appsignal/cli diagnose --environment=production --send-report --api-key="<PUSH API KEY HERE>"
  ```
</CodeGroup>

De omgevingsoptie is nuttig wanneer de standaardomgeving niet de omgeving is die u wilt diagnosticeren. De diagnosetool waarschuwt u wanneer er geen omgeving is geselecteerd.

## Opties

| Optie                                                | Beschrijving                                                                                   |
| ---------------------------------------------------- | ---------------------------------------------------------------------------------------------- |
| [`--environment=<environment>`](#environment-option) | Stel de omgeving in die in het commando moet worden gebruikt, bijv. `production` of `staging`. |
| `--api-key`                                          | Definieer welke API-sleutel moet worden gebruikt.                                              |
| [`--[no-]send-report`](#report-submission-option)    | Automatisch verzenden, of het rapport niet verzenden.                                          |

### Omgevingsoptie

Definieer welke app-omgeving AppSignal moet laden in de diagnose-CLI.

<CodeGroup>
  ```bash Bash theme={null}
  npx @appsignal/cli diagnose --environment=production
  ```
</CodeGroup>

### Optie voor rapportindiening

De opties om [het rapport in te dienen](#submitting-the-report) — direct of niet — zijn toegevoegd aan het AppSignal Node.js-pakket versie `1.2.5`.

Het rapport bij AppSignal indienen:

<CodeGroup>
  ```bash Bash theme={null}
  npx @appsignal/cli diagnose --send-report
  ```
</CodeGroup>

Het rapport niet bij AppSignal indienen:

<CodeGroup>
  ```bash Bash theme={null}
  npx @appsignal/cli diagnose --no-send-report
  ```
</CodeGroup>

## Uitvoerformaat van de configuratie

### Formaat van configuratie-optiewaarden

De configuratie-opties worden in de CLI afgedrukt als hun geïnspecteerde waarden. Dit betekent dat we ze afdrukken zoals Node.js 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`.
* Array-waarden worden afgedrukt als een verzameling waarden omgeven door vierkante haken, bijv. `["HTTP_ACCEPT", "HTTP_ACCEPT_CHARSET"]`.
  * Lege arrays worden afgedrukt als twee vierkante haken: `[]`.
* Null- of undefined-waarden worden afgedrukt als `null` of `undefined`.

[debugging]: /support/debugging.html