Integrate Splunk Cloud Platform Monitoring

개요

파일 전송 작업과 기기 상태 변화를 Splunk Cloud Platform으로 전송하여 모니터링하려면 HTTP Event Collector(HEC) 연동을 설정할 수 있습니다.

연동을 완료하면 전송이 시작(Transfer Started), 완료(Transfer Completed) 되거나 기기가 연결(Device Connected), 해제(Device Disconnected) 되는 등 지정한 이벤트가 발생할 때마다 Splunk로 이벤트가 전송되어 모니터링할 수 있습니다.

전체 과정은 ① HEC Token 발급 및 URL 확인 → ② 제품에서 연동 설정 두 단계로 진행됩니다.

준비 사항

시작하기 전에 다음 사항을 확인하세요.

HEC Token 발급 및 URL 확인

Splunk Cloud Platform은 HTTP Event Collector(HEC)를 통해 이벤트를 수집합니다.

이벤트를 전송하려면 HEC Token과 HEC URL이 필요합니다.

Step 1. HEC Token 생성

Splunk Web에서 Settings → Data Inputs → HTTP Event Collector → New Token으로 이동합니다.

또는 Settings → Add Data → Monitor → HTTP Event Collector를 선택합니다.

토큰 이름을 입력하고 Source Type과 이벤트를 저장할 인덱스를 선택한 후 Token을 생성합니다.

생성된 Token을 복사하고 상태가 Enabled인지 확인합니다.

HEC Token은 비밀번호와 동일한 권한을 가지므로 공개 저장소나 외부 문서에 노출되지 않도록 주의합니다.

유출된 경우 HEC 설정에서 Token을 비활성화하거나 삭제한 후 새로 발급합니다.

Step 2. HEC URL 확인

Splunk Cloud Platform의 HEC URL을 확인합니다.

예)

이벤트 전송 경로는 /services/collector이며 HTTPS(443)를 사용합니다.

확인 사항

✔ HEC Token을 생성했습니다.

✔ HEC Token이 활성(Enabled) 상태입니다.

✔ HEC URL을 확인했습니다.

Splunk Cloud Platform 연동 설정

확인한 HEC URL과 Token을 제품에 입력합니다.

Monitoring 설정 창을 열면 아래와 같은 화면이 표시됩니다.

Step 1. Splunk HEC URL 입력

Splunk HEC URL 항목에 HEC URL을 입력합니다.

예)

Step 2. HEC Token 입력

HEC Token 항목에 발급한 Token을 입력합니다.

Step 3. 이벤트 선택

Events 항목에서 모니터링할 이벤트를 선택합니다.

여러 개를 선택할 수 있으며 선택한 이벤트가 발생할 때만 Splunk로 전송됩니다.

Step 4. 설정 저장

입력을 완료한 후 Add를 클릭하여 연동을 저장합니다.

확인 사항

✔ Splunk HEC URL이 입력되었습니다.

✔ HEC Token이 입력되었습니다.

✔ 모니터링할 이벤트가 선택되었습니다.

연동 확인

설정이 정상적으로 동작하는지 확인합니다.

Step 1. 테스트 이벤트 발생

실제 전송 작업을 실행하거나 선택한 이벤트를 발생시킵니다.

Step 2. Splunk 확인

Splunk Search에서 대상 인덱스를 조회하여 이벤트가 정상적으로 수집되었는지 확인합니다.

예)

확인 사항

✔ Splunk에 이벤트가 수집되었습니다.

✔ 발생한 이벤트가 정상적으로 전달되었습니다.

설정 완료

설정을 저장하면 연동이 적용됩니다.

이후 선택한 이벤트가 발생할 때마다 Splunk로 이벤트가 자동으로 전송됩니다.

문제 해결 (Troubleshooting)