> ## 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-Konfiguration

In diesem Abschnitt erklären wir, wie Sie AppSignal konfigurieren, was im Node.js-Paket konfiguriert werden kann und welche minimale Konfiguration erforderlich ist.

## Minimal erforderliche Konfiguration

Die minimal erforderliche Konfiguration für AppSignal für Node.js umfasst die folgenden Elemente. Wenn sie nicht vorhanden sind, sendet AppSignal keine Daten an AppSignal.com.

* Einen gültigen Push-API-Schlüssel
* Einen Anwendungsnamen
* Eine Anwendungsumgebung (`development`/`production`/`test` durch Setzen von `NODE_ENV`)
* Die Einstellung `active: true`

Die Integration unterstützt das Laden ihrer Konfiguration über Optionen, die an den `Appsignal`-Konstruktor übergeben werden. Wir empfehlen, eine `appsignal.cjs`-Datei zu erstellen, um AppSignal zu requiren und zu initialisieren.

<CodeGroup>
  ```javascript Node.js theme={null}
  // appsignal.cjs
  const { Appsignal } = require("@appsignal/nodejs");

  new Appsignal({
    active: true,
    name: "<YOUR APPLICATION NAME>",
    pushApiKey: "<YOUR API KEY>",
  });
  ```
</CodeGroup>

Alternativ können Sie den Agent über System-Umgebungsvariablen konfigurieren. AppSignal wird automatisch aktiv, wenn die Umgebungsvariable `APPSIGNAL_PUSH_API_KEY` gesetzt ist.

<CodeGroup>
  ```bash Bash theme={null}
  export APPSIGNAL_PUSH_API_KEY="<YOUR API KEY>"
  export APPSIGNAL_APP_NAME="<YOUR APPLICATION NAME>"
  export APPSIGNAL_APP_ENV="production"
  ```
</CodeGroup>

## Konfigurationsoptionen

Lesen Sie über alle Konfigurationsoptionen auf der [Optionsseite](/nodejs/3.x/configuration/options).

## Anwendungsumgebungen

Eine Anwendung kann mehrere Umgebungen haben, z. B. „development", „test", „staging" und „production".

Um die Fehler und Performance-Probleme, die in der „development"-Umgebung auftreten, von denen in „production" zu trennen, ist es möglich, die Umgebung, in der die Anwendung läuft, mit der Umgebungsvariable `NODE_ENV` festzulegen.

Wenn Sie AppSignal pro Umgebung aktivieren, können Sie die Eigenschaft `active` der Optionen, die Sie an den Konstruktor übergeben, bedingt setzen:

<CodeGroup>
  ```javascript Node.js theme={null}
  // appsignal.cjs
  const { Appsignal } = require("@appsignal/nodejs");

  new Appsignal({
    active: process.env.NODE_ENV !== "development",
    name: "<YOUR APPLICATION NAME>",
    pushApiKey: "<YOUR API KEY>",
  });
  ```
</CodeGroup>

Dies deaktiviert AppSignal auch beim Ausführen Ihrer Tests.