1. Install Atatus Node.js package.

    copy
    icon/buttons/copy
    npm install --save atatus-nodejs
    
  2. You need to add NODE_OPTIONS='-r atatus-nodejs/start-next.js' to enable Atatus auto instrumentation for the Next.js backend. If you start your Next.js app using package.json, you can update your dev and start npm scripts as follows:

      // package.json
      {
        // ...
        "scripts": {
          "dev": "NODE_OPTIONS='-r atatus-nodejs/start-next.js' next dev",
          "build": "next build",
          "start": "NODE_OPTIONS='-r atatus-nodejs/start-next.js' next start",
          "lint": "next lint"
        },
        // ...
      }
    

    If you use any other startup script (e.g pm2), add NODE_OPTIONS accordingly.

    For example:

    NODE_OPTIONS='-r atatus-nodejs/start-next.js' next start
    
  3. Set the license key and app name using environment variables:

    export ATATUS_LICENSE_KEY="YOUR_LICENSE_KEY"
    export ATATUS_APP_NAME="YOUR_APP_NAME"
    export ATATUS_ANALYTICS=true
    export ATATUS_ANALYTICS_CAPTURE_OUTGOING=true
    export ATATUS_LOG_BODY="all"
    
  4. Restart your Next.js server.

    Just restart your server and access it from your web app or mobile app or curl. You will visualize your application's metrics within minutes.