BetterStack 구조화 로깅 서브 자동화 - n8n 워크플로우

자동화된 프로세스에 대한 중앙 집중식 로깅이 필요한 DevOps 엔지니어.
강력한 오류 모니터링이 필요한 수많은 n8n 템플릿을 운영하는 n8n 파워 유저.
n8n 워크플로우 설계 시 로깅 로직을 핵심 자동화 비즈니스 로직과 분리하고자 하는 개발자.
관측 가능성에 중점을 둔 전문 n8n 템플릿을 찾는 사용자.

복잡한 자동화 환경에서 포괄적인 관측 가능성을 유지하는 것은 매우 중요합니다. 이 특정 n8n 워크플로우 템플릿은 전용 로깅 서비스 역할을 수행하여 중앙 집중식 구조화 로깅의 필요성을 해결합니다. 모든 주 n8n 워크플로우에서 로깅 API 호출을 반복하는 대신, '워크플로우 실행(Execute Workflow)' n8n 노드를 사용하여 이 재사용 가능한 n8n 워크플로우를 호출하기만 하면 됩니다. 이 접근 방식은 주 n8n 템플릿을 더 깔끔하고 유지 관리가 용이하게 만들며 일관된 로그 형식을 보장합니다. 활성 상태인 n8n 워크플로우에서 오류나 주요 이벤트가 발생하면, 이 로깅 n8n 워크플로우가 로그 데이터(메시지 및 심각도 수준)를 BetterStack으로 안전하게 전송하는 작업을 처리하여 인시던트 대응 및 모니터링 기능을 획기적으로 개선합니다.

이 자동화는 광범위한 n8n 환경 내에서 주로 호출 가능한 서비스로 기능합니다. 플로우는 워크플로우 간 통신을 위해 설계된 특정 n8n 트리거에 의해 시작됩니다:

1. 트리거 수신: n8n 워크플로우는 '로그 메시지 수신(Recieve log message)' n8n 트리거(워크플로우 실행 트리거)로 시작됩니다. 이 트리거는 다른 활성 n8n 워크플로우나 n8n 템플릿에 의해 호출되기를 기다리며, level(예: 'error', 'info')과 message를 포함하는 구조화된 입력 데이터를 예상합니다.


2. 데이터 구조: n8n 트리거에 의해 캡처된 수신된 데이터는 동적으로 매핑됩니다.


3. API 전송: HTTP 요청으로 구성된 'BetterStack으로 로그 전송(Send Log to BetterStack)' n8n 노드는 구조화된 입력값(message 및 level)을 가져와 BetterStack Logs API에서 요구하는 필수 JSON 페이로드 형식으로 변환합니다.


4. 안전한 전송: 저장된 헤더 인증 자격 증명을 사용하여 n8n 노드는 BetterStack 엔드포인트로 POST 요청을 안전하게 수행하여 로깅 프로세스를 완료합니다.


5. 데모 경로: 포함된 '워크플로우 테스트(Test workflow)' n8n 노드(수동 트리거)와 '테스트 로그 메시지 전송(Send test log message)' n8n 노드는 다른 모든 n8n 워크플로우에서 이 로깅 서비스를 올바르게 호출하고 필수 입력 변수를 전달하는 방법을 시연합니다.

이 로깅 n8n 워크플로우 템플릿을 효과적으로 배포하고 사용하려면 다음 단계를 따르십시오:

1. n8n 워크플로우 가져오기: 제공된 JSON 데이터를 복사하여 '워크플로우(Workflows)' 보기를 통해 n8n 인스턴스에 직접 가져옵니다.


2. BetterStack 자격 증명 구성: 이 n8n 워크플로우는 BetterStack Logs API에 대한 보안 액세스를 위해 HTTP 헤더 인증을 요구합니다.

1. 엔드포인트 설정: 'BetterStack으로 로그 전송(Send Log to BetterStack)' n8n 노드를 편집하고 특정 BetterStack Logs 수집 엔드포인트 URL을 입력합니다.


2. 다른 n8n 템플릿에서의 사용법: 주 n8n 워크플로우에서 '워크플로우 실행(Execute Workflow)' n8n 노드를 사용합니다. 이 노드가 이 로깅 워크플로우의 ID를 호출하도록 설정하고, 예상되는 매개변수인 level과 message를 전달해야 합니다.

로그 메시지 수신 (Execute Workflow Trigger): 이 중요 n8n 트리거는 워크플로우를 다른 n8n 템플릿에서 호출 가능한 재사용 가능한 API 엔드포인트로 설정합니다. 필수 입력값인 level과 message를 정의합니다.
BetterStack으로 로그 전송 (HTTP Request n8n node): 이 n8n 노드는 로깅 서비스와의 실제 통신을 담당합니다.
기능: BetterStack Logs API로 POST 요청을 수행합니다.
주요 구성: 시작 n8n 트리거에서 동적으로 데이터를 가져오는 JSON 본문({"message":"{{ $json.message }}", "level": "{{ $json.level }}"})을 사용합니다. HTTP 헤더 인증 자격 증명을 사용하여 안전하게 전송합니다.
워크플로우 테스트 (Manual Trigger): 가져온 후 이 n8n 워크플로우 로직을 테스트할 때만 사용됩니다.
테스트 로그 메시지 전송 (Execute Workflow n8n node): 다른 모든 n8n 워크플로우가 이 로깅 서브 워크플로우를 호출하는 방법을 시연합니다. 로깅 n8n 노드의 기능을 테스트하기 위해 샘플 데이터(level: error, message: This is a test log message)를 전달합니다.