Nuxt.js 환경 설치

사용자가 설치하기 쉬운 Nuxt.js 3에서 Node.js 에이전트 설치 방법을 안내합니다. 이 문서는 Nuxt.js 3 기준으로 작성했습니다.

에이전트 설치하기

프로젝트의 루트(Root) 경로에서 다음 명령어를 실행해 와탭 에이전트를 설치하세요.

BASH

npm install whatap

에이전트 설정 파일 생성하기

프로젝트의 루트(Root) 경로에 whatap.conf 파일을 생성하고 필요한 설정을 추가하세요. 에이전트 설정에 대한 자세한 내용은 다음 문서를 참조하세요.

whatap.conf

license={ACCESS_KEY}
whatap.server.host={COLLECTION_SERVER_IP}

Nuxt 애플리케이션 빌드하기

다음 명령어를 실행해 Nuxt 애플리케이션을 빌드하세요.

BASH

npm run build

빌드를 완료하면 .output/server 디렉터리가 생성됩니다. 디렉터리의 구조는 다음을 참조하세요.

• chunks/청크 파일들(코드 분할된 자바스크립트 파일)
• node_modules/서버 실행에 필요한 의존성 모듈
• package.json애플리케이션 정보와 의존성(dependency) 관리 문서
• index.mjs서버 진입점 파일

애플리케이션 실행하기

다음 명령어를 이용해 애플리케이션을 실행하세요.

BASH

node -r whatap .output/server/index.mjs

Docker 환경에서 실행하기

Docker 환경에서 Nuxt 애플리케이션을 실행하려면 Dockerfile에서 다음 순서를 추가로 작성하세요.

1. .output/server 디렉토리로 이동하세요.

   BASH

   cd .output/server

2. 다음 명령어를 실행해 와탭 에이전트를 설치하세요.

   BASH

   npm install whatap
   노트

   애플리케이션을 빌드한 다음, .output/server 경로에는 whatap 패키지가 존재하지 않으므로 별도의 명령어로 whatap 패키지를 설치해야 합니다. Nuxt.js의 Tree shaking 기능으로 코드상으로 사용하지 않는 패키지는 빌드에 포함되지 않습니다.

3. whatap.conf 파일을 생성하고 설정하세요.

4. 설정이 완료된 .output/server 경로를 WORKDIR로 복사하세요.

5. 다음 명령어를 이용해 애플리케이션을 실행하세요.

   BASH

   node -r whatap .output/server/index.mjs

다음 단계

• 설치 점검하기

  프로젝트 생성 및 에이전트 설치까지 모두 적용했다면 다음 문서에서 점검 사항을 확인하세요.

• 에이전트 설정

  에이전트 설정(whatap.conf) 파일에 옵션을 적용해 모니터링을 위한 다양한 기능을 제공합니다. 기본 설정부터 서버 연결 및 데이터 전송 설정, 여러 애플리케이션 서버의 설정 파일 관리 방법, 트랜잭션 추적 등을 포함합니다. 자세한 내용은 다음 문서를 참조하세요.

• 모니터링 시작하기

  모든 설정을 완료한 다음 애플리케이션 서버를 다시 시작하세요. 에이전트가 정보를 수집하기 시작합니다. 먼저 애플리케이션 대시보드 메뉴에서 모니터링 데이터가 수집되는지 확인하세요. 애플리케이션 대시보드에 대한 자세한 내용은 다음 문서를 참조하세요.