> ## 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 für Node.js: Diagnose-Tool

Das AppSignal Node.js-Paket wird mit einem Selbstdiagnose-Tool ausgeliefert. Dieses Tool kann verwendet werden, um Ihre AppSignal-Installation zu debuggen, und ist eines der ersten Dinge, nach denen unser Support-Team fragt, wenn ein Problem auftritt.

## Der Diagnosebericht

Dieses Kommandozeilen-Tool ist nützlich, um AppSignal auf einem System zu testen und die lokale Konfiguration zu validieren. Es gibt nützliche Informationen zur Fehlersuche aus und prüft, ob der AppSignal-Agent auf der Architektur des Rechners ausgeführt werden und mit den AppSignal-Servern kommunizieren kann.

Dieses Diagnose-Tool sammelt und gibt Folgendes aus:

* Informationen über das AppSignal-Paket.
* Informationen über das Host-System und Node.js.
* ob die AppSignal-[Extension](/appsignal/how-appsignal-operates#extension) und der [Agent](/appsignal/how-appsignal-operates#agent) auf dem Host-System ausgeführt werden können.
* alle konfigurierten Konfigurationsoptionen (einschließlich Standardwerte).
* ob die Konfiguration gültig und aktiv ist.
* ob der Push-API-Schlüssel vorhanden und gültig ist (Internetverbindung erforderlich).
* woher die Werte der Konfigurationsoptionen stammen.

Weitere Informationen zur Verwendung des Diagnosebefehls finden Sie auf der Seite [Debugging][debugging].

## Einreichen des Berichts

Sie müssen die Option `--send-report` übergeben, um den Diagnosebericht an AppSignal zu senden. Bei Verwendung wird der Bericht an unsere Server gesendet und Sie erhalten ein Support-Token.

Wenn Sie [uns dieses Support-Token senden](mailto:support@appsignal.com), prüfen wir den Bericht und helfen Ihnen, das Problem zu debuggen. Wir haben festgestellt, dass beim Kopieren und Einfügen der Berichtsausgabe normalerweise die Formatierung verloren geht, was die Lesbarkeit erschwert. Daher wird der Bericht im JSON-Format an unsere Server gesendet.

## Verwendung

Führen Sie in der Kommandozeile Ihres Projekts (ein Verzeichnis mit einer `package.json` und installiertem `@appsignal/nodejs`) Folgendes aus:

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

Zumindest muss `APPSIGNAL_PUSH_API_KEY` gesetzt sein, bevor der Diagnosebefehl ausgeführt werden kann. Falls dies in Ihrer Umgebung noch nicht gesetzt ist, können Sie es auch zur Laufzeit mit der Option `--api-key` setzen:

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

Sie können die Umgebungsvariable auch zur Laufzeit setzen:

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

Um die Diagnose auf Ihrem Produktionsserver auszuführen und den Bericht zu Support-Zwecken an AppSignal zu senden, können Sie den folgenden Befehl ausführen:

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

Die Umgebungsoption ist nützlich, wenn die Standardumgebung nicht diejenige ist, die Sie diagnostizieren möchten. Das Diagnose-Tool warnt Sie, wenn keine Umgebung ausgewählt ist.

## Optionen

| Option                                               | Beschreibung                                                                             |
| ---------------------------------------------------- | ---------------------------------------------------------------------------------------- |
| [`--environment=<environment>`](#environment-option) | Legen Sie die im Befehl zu verwendende Umgebung fest, z. B. `production` oder `staging`. |
| `--api-key`                                          | Definieren Sie, welcher API-Schlüssel verwendet werden soll.                             |
| [`--[no-]send-report`](#report-submission-option)    | Bericht automatisch senden oder nicht senden.                                            |

### Umgebungsoption

Definieren Sie, welche App-Umgebung AppSignal im Diagnose-CLI laden soll.

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

### Option zum Einreichen des Berichts

Die Optionen, den Bericht [sofort einzureichen](#submitting-the-report) oder nicht, wurden in Version `1.2.5` des AppSignal Node.js-Pakets hinzugefügt.

Bericht an AppSignal senden:

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

Bericht nicht an AppSignal senden:

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

## Format der Konfigurationsausgabe

### Format der Werte von Konfigurationsoptionen

Die Konfigurationsoptionen werden als ihre inspizierten Werte im CLI ausgegeben. Das bedeutet, wir geben sie so aus, wie Node.js sie in einer Konsole ausgeben würde.

* Zeichenketten-Werte werden mit doppelten Anführungszeichen ausgegeben, z. B. `"My app name"`.
* Boolesche Werte werden als ihre rohen Werte ausgegeben: `true` und `false`.
* Array-Werte werden als Sammlung von Werten in eckigen Klammern ausgegeben, z. B. `["HTTP_ACCEPT", "HTTP_ACCEPT_CHARSET"]`.
  * Leere Arrays werden als zwei eckige Klammern ausgegeben: `[]`.
* Null- oder undefinierte Werte werden als `null` oder `undefined` ausgegeben.

[debugging]: /support/debugging.html