n8n에서 New Relic 커스텀 패키지를 만들었더니 생각보다 다운로드 수가 많았던 이야기

안녕하세요! 평소 개인적으로 워크플로우 자동화 도구인 n8n을 활용하고 있는데요, 이번에는 옵저버빌리티(Observability) 플랫폼인 New Relic과 연동하는 커스텀 노드(npm package)를 개인 개발로 직접 제작하여 공개했습니다.

이번에는 제작한 npm package 소개, Claude Code를 활용해 약 1주일 만에 제작한 이야기, 그리고 **New Relic AI MCP(Model Context Protocol)**와 조합한 데모를 전달해 드립니다.

n8n(에็น에잇엔)이란 다양한 Web 서비스나 애플리케이션, 생성형 AI 등을 드래그 앤 드롭으로 연결하여 업무 자동화나 데이터 연동을 실현하는 워크플로우 자동화 도구입니다.

현재 n8n에는 New Relic에 대응하는 공식 노드가 준비되어 있지 않습니다. 그래서 이번에는 n8n 상에 독자적인 연동 기능을 추가할 수 있는 메커니즘을 이용하여, New Relic용 커스텀 노드(플러그인)를 직접 만들어 보고자 합니다.

n8n은 TypeScript를 통한 추가 개발을 지원하며, 셀프 호스트(Self-hosted) 버전의 Docker 이미지도 배포되고 있습니다. 이번에는 개발한 코드를 npm 패키지(OSS)로 공개하고, 그것을 자신의 n8n 환경에 설치하는 접근 방식을 채택했습니다.

n8n에서 New Relic의 API를 GUI 상에서 쉽게 조작할 수 있도록 하는 커뮤니티 패키지를 작성하여 npm에 공개했습니다.

npm: n8n-nodes-newrelic

방금 막 제작되었고 공식적으로 채택된 것은 아니기 때문에, n8n 셀프 호스트 컨테이너에 npm install 하여 이용하실 수 있습니다.

이를 사용함으로써 n8n 워크플로우 내에서 다음과 같은 일을 노코드(No-code)로 실현할 수 있게 됩니다.

• New Relic으로의 커스텀 이벤트 전송
• NRQL(New Relic Query Language) 실행 및 결과 취득

위 내용은 하나의 예시일 뿐이며, 기본적으로 NerdGraph API로 실행하는 엔드포인트를 몇 가지 선정하여 GUI에서 설정하고 실행할 수 있습니다.

여담이지만, n8n 공식에서 사용되는 패키지는 모두 n8n-nodes라는 접두사(prefix)가 붙습니다.

이 접두사가 붙은 악의적인 n8n 패키지가 공개되어 공격에 이용된 배경이 있기 때문에, 사용자 수가 많은 애플리케이션은 명칭 취득이 엄격하여 npm 관리자와 협상이 필요했습니다.

이메일로 소통하며 수상한 사람이 아니라는 점을 이해시켜 드렸고, 어떻게든 n8n-nodes-newrelic이라는 명칭을 사용할 수 있게 되었습니다.

커스텀 노드를 만든다고 하면 진입 장벽이 높게 느껴질 수 있지만, 사실 매우 심플하며 이번에는 착수부터 npm 공개까지 1주일 정도 만에 완료했습니다.

우선 공식 템플릿이 존재하고 다른 패키지의 구현 코드도 있기 때문에, 참고할 만한 유망한 것들을 몇 가지 찾아 Claude Code로 구현할 수 있었습니다.

공식 스타터 키트를 이용한 개발

n8n 공식이 제공하는 n8n-nodes-starter 리포지토리를 클론하여 개발의 토대로 삼습니다. TypeScript 기반이며 빌드 및 테스트 설정이 이미 갖춰져 있어 환경 구축의 수고는 거의 제로였습니다. 참고할 패키지를 몇 가지 찾은 뒤, 나머지는 Claude Code에게 구현을 맡기는 것만으로 완료되었습니다. -
테스트 및 npm 공개

로컬 n8n 환경에 링크하여 동작 확인을 수행하고, 문제가 없다면 npm publish 하는 것만으로 완료됩니다.

정형적인 UI 정의 기술이나 타입 맞추기 등 사람이 하면 시간이 걸리는 부분을 Claude Code에게 통째로 맡길 수 있었던 덕분에, API 사양 이해나 본질적인 유스케이스(Use case) 설계에 집중할 수 있었고 극적인 속도로 개발할 수 있었습니다.

현재 New Relic AI MCP라는 기능이 Public Preview 중입니다. 이는 외부의 LLM이나 AI 에이전트로부터 New Relic의 데이터를 안전하게 참조 및 분석할 수 있는 연동 기반입니다.

이 기능을 직접 만든 패키지와 MCP를 조합하면 상당히 강력한 자동화가 가능하지 않을까 하는 생각에, n8n 상에서 알람 발보(Alert)를 후크(Hook)로 삼아 New Relic의 데이터를 분석하여 통지하는 워크플로우를 만들어 보았습니다.

흐름은 다음과 같습니다: 1. 알람 발보(Alert) → 2. n8n이 에러 내용을 캐치 → 3. Gemini가 New Relic AI MCP를 이용하여 리포트를 작성 → 4. Gmail 전송 순서입니다.

처음에는 저희 팀의 자동화를 위해 간단히 만든 패키지였으나, npm에 공개했더니 주간(Weekly) 다운로드 수가 200회 정도 발생하며 누적 1,500회를 넘어선 것 같습니다.

아직 갓 만들어진 패키지이므로, 추가 개발을 진행하여 공식 채택을 목표로 해나가고 싶습니다!

이번에는 n8n을 이용한 커스텀 패키지를 만들어 보았습니다.

개인적으로 이용하기에는 매우 편리한 도구이지만, 상용 목적으로 운영 환경(Production)에서 가동하기에는,

• 셀프 호스팅(Self-hosting)하는 번거로움
• 보안 측면에서 고려해야 할 허들

등이 있기 때문에, 운영 환경에서 가볍게 이용하기에는 조금 조심스러운 분들은 New Relic 상에서도 GUI 기반으로 워크플로우를 구축할 수 있는 Workflow Automation이라는 기능이 있으니 꼭 한번 이용해 보세요!!