요약OTel
filelog 수신기를 사용해 ClickStack에서 호스트 시스템 로그(syslog, auth, kernel)를 수집하고 시각화합니다. 데모 데이터세트와 사전 구축된 대시보드가 포함되어 있습니다.사전 요구 사항
- 실행 중인 ClickStack 인스턴스
- syslog 파일이 있는 시스템
- ClickStack 설정 파일을 수정할 수 있는 권한
1
syslog 파일이 존재하는지 확인
먼저 시스템에서 syslog 파일이 생성되고 있는지 확인하십시오:일반적인 syslog 경로:
- Ubuntu/Debian:
/var/log/syslog - RHEL/CentOS/Fedora:
/var/log/messages - macOS:
/var/log/system.log
2
사용자 정의 OTel collector 구성 만들기
ClickStack를 사용하면 사용자 정의 설정 파일을 마운트하고 환경 변수를 설정하여 기본 OpenTelemetry Collector 구성을 확장할 수 있습니다.시스템 구성을 담은
모든 구성:
host-logs-monitoring.yaml 파일을 생성하십시오:- 최신 Linux (Ubuntu 24.04+)
- 레거시 Linux (Ubuntu 20.04, RHEL, CentOS)
- macOS
모든 구성:
- 표준 경로에서 syslog 파일 읽기
- 구조화된 필드(timestamp, 호스트명, unit/service, PID, 메시지)를 추출할 수 있도록 syslog 포맷을 파싱하세요
- 원본 로그 타임스탬프를 유지
- HyperDX에서 필터링할 수 있도록
source: host-logs속성을 추가하십시오 - 전용 파이프라인을 통해 로그를 ClickHouse exporter로 전송
- 사용자 지정 구성에서는 새 수신기와 파이프라인만 정의합니다
- processor(
memory_limiter,transform,batch)와 exporter(clickhouse)는 기본 ClickStack 구성에 이미 정의되어 있으므로 이름만 참조하면 됩니다 - regex parser는 syslog 포맷에서 systemd 유닛 이름, PID, 기타 메타데이터를 추출합니다
- 이 구성은 collector가 다시 시작될 때 로그를 재수집하지 않도록
start_at: end를 사용합니다. 테스트하려면start_at: beginning으로 변경해 과거 로그를 즉시 확인하십시오.
3
ClickStack가 사용자 지정 구성을 불러오도록 구성하기
기존 ClickStack 배포에서 사용자 지정 collector 구성을 활성화하려면 다음 작업을 수행해야 합니다.
- 사용자 지정 구성 파일을
/etc/otelcol-contrib/custom.config.yaml에 마운트합니다 - 환경 변수
CUSTOM_OTELCOL_CONFIG_FILE=/etc/otelcol-contrib/custom.config.yaml를 설정합니다 - collector가 syslog 디렉터리를 읽을 수 있도록 해당 디렉터리를 마운트합니다
옵션 1: Docker Compose
ClickStack 배포 구성을 업데이트합니다:옵션 2: Docker Run(올인원 이미지)
docker run으로 올인원 이미지를 사용하는 경우:ClickStack collector에 syslog 파일을 읽을 수 있는 적절한 권한이 부여되어 있는지 확인하세요. 프로덕션 환경에서는 읽기 전용 마운트(
:ro)를 사용하고 최소 권한 원칙을 준수하십시오.4
HyperDX에서 로그 확인하기
구성이 완료되면 HyperDX에 로그인한 후 로그가 정상적으로 유입되는지 확인합니다:

- Search view로 이동합니다
- source를 Logs로 설정합니다
source:host-logs로 필터링하여 호스트별 로그를 확인합니다unit,hostname,pid,message등의 필드가 포함된 구조화된 로그 항목이 표시되어야 합니다


1
샘플 데이터세트 다운로드
샘플 로그 파일을 다운로드하세요:데이터세트에는 다음이 포함되어 있습니다:
- 시스템 부팅 시퀀스
- SSH 로그인 활동(성공 및 실패 시도)
- 보안 사고(
fail2ban대응이 포함된 무차별 대입 공격) - 예약된 유지 관리(
cron작업,anacron) - 서비스 재시작(
rsyslog) - 커널 메시지 및 방화벽 활동
- 일반적인 운영 작업과 주목할 만한 이벤트가 혼합된 로그
2
테스트 collector 구성 만들기
다음 구성으로
host-logs-demo.yaml 파일을 만드세요:3
데모 구성으로 ClickStack 실행
데모 로그와 구성을 사용해 ClickStack을 실행하세요:
이 방법은 로그 파일을 컨테이너에 직접 마운트합니다. 이는 고정된 데모 데이터로 테스트하기 위한 것입니다.
4
HyperDX에서 로그 확인
ClickStack이 실행되면 다음을 수행하세요:

- HyperDX를 열고 계정에 로그인하세요(먼저 계정을 만들어야 할 수 있습니다)
- Search view로 이동한 다음 source를
Logs로 설정하세요 - 시간 범위를 2025-11-10 00:00:00 - 2025-11-13 00:00:00으로 설정하세요


시간대 표시HyperDX는 브라우저의 로컬 시간대를 기준으로 timestamp를 표시합니다. 데모 데이터는 2025-11-11 00:00:00 - 2025-11-12 00:00:00 (UTC) 범위를 포함합니다. 넉넉한 시간 범위를 설정하면 위치와 관계없이 데모 로그를 확인할 수 있습니다. 로그가 표시되면 더 명확한 시각화를 위해 범위를 24시간으로 좁힐 수 있습니다.
1
대시보드 구성 다운로드
.
2
사전 구축된 대시보드 가져오기
- HyperDX를 열고 Dashboards 섹션으로 이동합니다
- 오른쪽 상단의 줄임표 메뉴에서 Import Dashboard를 클릭합니다

host-logs-dashboard.json파일을 업로드한 다음 Finish Import를 클릭합니다

3
대시보드 보기
모든 시각화가 미리 구성된 상태로 대시보드가 생성됩니다.
주요 시각화는 다음과 같습니다:

- 심각도별 시간대별 로그 볼륨
- 로그를 가장 많이 생성하는 상위 systemd 유닛
- SSH 로그인 활동(성공 대비 실패)
- 방화벽 활동(차단 대비 허용)
- 보안 이벤트(로그인 실패, ban, block)
- 서비스 재시작 활동
데모 데이터세트의 경우 시간 범위를 **2025-11-11 00:00:00 - 2025-11-12 00:00:00 (UTC)**로 설정하십시오(로컬 시간대에 맞게 조정). 가져온 대시보드에는 기본적으로 시간 범위가 지정되어 있지 않습니다.
- 중요한 시스템 이벤트(서비스 장애, 인증 실패, 디스크 경고)에 대한 알림을 설정하세요
- 특정 서비스를 모니터링하려면 특정 유닛으로 필터링하세요
- 종합적인 문제 해결을 위해 호스트 로그를 애플리케이션 로그와 연관시키세요
- 보안 모니터링(SSH 시도, sudo 사용, 방화벽 차단)을 위한 사용자 지정 대시보드를 만드세요