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

# Installatie

Volg eerst de [installatiegids](/guides/new-application) wanneer u een nieuwe applicatie aan AppSignal toevoegt.

## Vereisten

Voordat u het AppSignal-pakket kunt compileren, dient u ervoor te zorgen dat de build-/compilatietools voor uw systeem zijn geïnstalleerd. Controleer de pagina [Ondersteunde besturingssystemen](/support/operating-systems) op eventuele systeemafhankelijkheden die vereist kunnen zijn.

## Installatie

Maak eerst een [AppSignal-account aan](https://appsignal.com/users/sign_up). Installeer AppSignal vervolgens door de instructies voor uw package manager te volgen.

### Met npm

<CodeGroup>
  ```bash Bash theme={null}
  npm install @appsignal/nodejs
  ```
</CodeGroup>

Het is ook mogelijk om het pakket `@appsignal/nodejs` handmatig toe te voegen aan uw `package.json`. Voer daarna `npm install` uit.

<CodeGroup>
  ```json JSON theme={null}
  {
    "name": "my-app",
    "dependencies": {
      "@appsignal/nodejs": "^3.0.0"
    }
  }
  ```
</CodeGroup>

Maak een `appsignal.cjs`-bestand aan om AppSignal te requiren en te configureren. Dit bestand kan ook op een andere locatie worden geplaatst, bijvoorbeeld in de map `src/`. Voor meer informatie over de configuratie, zie ons [configuratie-hoofdstuk](/nodejs/3.x/configuration).

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

### Met pnpm

pnpm onderdrukt standaard lifecycle scripts voor afhankelijkheden. Het pakket `@appsignal/nodejs` is afhankelijk van een `install`-lifecycle script om zijn native extensie te downloaden en te compileren. Zonder dit script wordt de extensie niet geladen en rapporteert AppSignal geen gegevens.

Om het pakket te installeren en zijn lifecycle script toe te staan uit te voeren:

<CodeGroup>
  ```bash Bash theme={null}
  pnpm --allow-build=@appsignal/nodejs add @appsignal/nodejs
  ```
</CodeGroup>

### De AppSignal-client requiren

U kunt uw applicatie nu zoals gebruikelijk uitvoeren, maar gebruik de vlag `--require` om de instrumentatie van AppSignal te laden vóór elke andere bibliotheek:

<CodeGroup>
  ```shell Shell theme={null}
  node --require './appsignal.cjs' index.js
  ```
</CodeGroup>

We raden aan de vlag `--require` toe te voegen aan elk script dat uw app start:

<CodeGroup>
  ```json JSON theme={null}
  {
    "scripts": {
      "server": "node --require ./appsignal.cjs index.js"
    }
  }
  ```
</CodeGroup>

U kunt de vlag `--require` ook gebruiken met tools zoals `ts-node` en `nodemon`.

Wanneer u een wrapper-CLI gebruikt, zoals `nest start` of `fastify start`, om uw applicatie te starten, gebruik dan de omgevingsvariabele `NODE_OPTIONS` om de vlag aan de Node.js-runtime door te geven:

<CodeGroup>
  ```sh Shell theme={null}
  NODE_OPTIONS='--require ./appsignal.cjs' nest start
  ```
</CodeGroup>

<Warning>
  Om de AppSignal-integratie correct te laten werken, **moet** het bestand
  `appsignal.cjs` worden gerequired vóór alle andere afhankelijkheden.
</Warning>

### TypeScript-ondersteuning

AppSignal is volledig compatibel met TypeScript. Bij het uitvoeren van een gecompileerde TypeScript-applicatie met `node`, raden we aan om [de Node.js-vlag `--enable-source-maps`](https://nodejs.org/api/cli.html#--enable-source-maps) te gebruiken, zodat fout-backtraces in AppSignal verwijzen naar locaties in de originele TypeScript-code:

<CodeGroup>
  ```sh Shell theme={null}
  node --enable-source-maps --require './appsignal.cjs' dist/src/main.js
  ```
</CodeGroup>

Wanneer u een wrapper-CLI gebruikt, zoals `nest start` of `fastify start`, om uw applicatie te starten, gebruik dan de omgevingsvariabele `NODE_OPTIONS` om de vlag aan de Node.js-runtime door te geven:

<CodeGroup>
  ```sh Shell theme={null}
  NODE_OPTIONS='--enable-source-maps --require ./appsignal.cjs' nest start
  ```
</CodeGroup>

### De AppSignal-client importeren

De AppSignal-client is toegankelijk via het globaal geëxporteerde object `Appsignal.client`.

Om functies zoals [aangepaste metrics](/metrics/custom) te gebruiken, moet u eerst de AppSignal-client importeren:

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

  const client = Appsignal.client;
  ```
</CodeGroup>

### Integraties toevoegen

AppSignal ondersteunt diverse bibliotheken en frameworks met aanvullende pakketten, zoals Express, Koa, Next.js en meer. Aanvullende installatie-instructies voor deze pakketten zijn te vinden in het [Node.js-integraties-hoofdstuk](/nodejs/3.x/integrations).

***

<Note>
  📖 Ga verder met onze [installatiehandleiding](/guides/new-application).
</Note>

## AppSignal voor Node.js verwijderen

Verwijder AppSignal uit uw app door de onderstaande stappen te volgen. Wanneer deze stappen zijn voltooid, stuurt uw app geen gegevens meer naar de AppSignal-servers.

1. Voer `npm uninstall @appsignal/nodejs` uit om de AppSignal voor Node.js-integratie te verwijderen, of verwijder de regel die naar het `@appsignal/nodejs`-pakket verwijst in het `dependencies`-blok van het `package.json`-bestand van uw applicatie.

2. Voer `npm install` uit om uw `package.lock` bij te werken met de status van de verwijderde pakketten.

3. Verwijder alle AppSignal-[configuratie](/nodejs/3.x/configuration/) uit uw app.

4. Commit, deploy en herstart uw app.
   * Dit zorgt ervoor dat de AppSignal-servers geen gegevens meer van uw app ontvangen.

5. Tot slot, [verwijder de app](/guides/application/deleting-applications) op AppSignal.com.

<Note>
  📖 Ga verder met onze [verwijderingshandleiding](/guides/application/deleting-applications).
</Note>

## De AppSignal-client stoppen

AppSignal stopt automatisch wanneer uw applicatie of machine stopt met draaien. Als u AppSignal echter handmatig wilt stoppen, kunt u het volgende commando uitvoeren:

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

  Appsignal.client.stop();
  ```
</CodeGroup>