n8n 자체 호스팅 인스턴스 상태 및 DB 연결 확인을 위한 API 엔드포인트 활용

하루보탬 편집팀

서버 랙에 장착된 여러 대의 Cisco HyperFlex 서버 장비가 있는 데이터 센터 내부 모습

n8n 인스턴스의 도달 가능 여부는 /healthz 엔드포인트를, DB 연결 및 마이그레이션 완료를 포함한 서비스 준비 상태는 /healthz/readiness 엔드포인트를 통해 확인할 수 있습니다.

대표 참고 사진 출처: Btrs · 사진 원본 · CC-BY-SA-4.0 · 원본 변경 없음. 참고 사진이며 제품 사용·성능의 증거가 아닙니다.

인스턴스 도달 가능성 확인

인스턴스가 네트워크상에서 접근 가능한지 확인하려면 <your-instance-url>/healthz 엔드포인트를 호출합니다.

이 엔드포인트는 표준 HTTP 상태 코드를 반환하며, 200 코드는 인스턴스에 도달할 수 있음을 의미합니다.

해당 엔드포인트는 자체 호스팅 및 Cloud 사용자 모두에게 제공되나, 데이터베이스(DB) 상태는 반영하지 않습니다.

상태 확인 엔드포인트 요약: 인스턴스 도달 가능 여부 확인: /healthz DB 연결 및 서비스 준비 상태 확인: /healthz/readiness
상태 확인 엔드포인트 요약
설명 도해 · 하루보탬 Studio
엔드포인트별 확인 가능 정보 비교: 인스턴스 도달 가능성(/healthz) / 서비스 준비 상태(/healthz/readiness); HTTP 200 시 의미 / 인스턴스 도달 가능 (DB 상태 미확인); DB 연결 확인 여부 / 포함 (DB 연결 및 마이그레이션 완료 시 200)
엔드포인트별 확인 가능 정보 비교 — 공식 자료를 정리한 자체 제작 도해입니다.
설명 도해 · 하루보탬 Studio

근거: Monitor n8n

DB 연결 및 서비스 준비 상태 확인

실제 서비스 준비 상태를 확인하려면 <your-instance-url>/healthz/readiness 엔드포인트를 사용합니다.

이 엔드포인트는 DB가 연결되고 마이그레이션이 완료되어 인스턴스가 트래픽을 수용할 준비가 된 경우에만 200 상태 코드를 반환합니다.

상태 확인 절차: 1. /healthz 엔드포인트 호출 → 2. /healthz/readiness 엔드포인트 호출 → 3. 필요 시 N8N_ENDPOINT_HEALTH 환경 변수로 경로 수정
상태 확인 절차 — 공식 자료를 정리한 자체 제작 도해입니다.
설명 도해 · 하루보탬 Studio

근거: Monitor n8n

엔드포인트 경로 설정 변경

사용자의 환경에 맞게 상태 확인 엔드포인트 경로를 수정하려면 N8N_ENDPOINT_HEALTH 환경 변수를 활용합니다.

설정 및 환경 제약: 엔드포인트 경로 커스터마이징은 N8N_ENDPOINT_HEALTH 환경 변수 사용 백업 포함/제외 대상 및 운영 범위는 공식 문서 확인 필요
설정 및 환경 제약 — 공식 자료를 정리한 자체 제작 도해입니다.
설명 도해 · 하루보탬 Studio
모니터링 구성 시 고려사항: 단순 네트워크 연결 확인이 목적이라면 /healthz를, DB 상태를 포함한 가용성 확인이 필요하면 /healthz/readiness를 선택하여 모니터링 시스템에 등록하십시오.
모니터링 구성 시 고려사항 — 공식 자료를 정리한 자체 제작 도해입니다.
설명 도해 · 하루보탬 Studio

근거: Monitor n8n

적용 조건과 확인 범위
  • 공식 문서에 명시된 자체호스팅 운영 범위와 백업에 포함·제외되는 대상을 구분한다.
  • 실제 인스턴스 복구·성능·비용을 검증했다고 주장하지 않는다.
  • 자체 호스팅 운영 범위 및 백업 포함/제외 대상은 공식 문서 확인 필요
  • 실제 인스턴스 복구, 성능, 비용에 대한 검증은 포함되지 않음

확인일: 2026-09-30T23:55:17.095607+00:00