핵심 요약OTel filelog 수신기를 사용해 MongoDB 서버 로그(4.4+ JSON 포맷)를 ClickStack에서 수집하고 시각화합니다. 데모 데이터세트와 사전 구축된 대시보드가 포함되어 있습니다.
- 실행 중인 ClickStack 인스턴스
- 기존 자가 관리형 MongoDB 설치 환경(버전 4.4 이상)
- MongoDB 로그 파일에 대한 접근 권한
MongoDB 로깅 구성 확인
MongoDB 4.4 이상에서는 기본적으로 구조화된 JSON 로그를 출력합니다. 로그 파일 위치를 확인하세요:cat /etc/mongod.conf | grep -A 5 systemLog
- Linux (apt/yum):
/var/log/mongodb/mongod.log
- macOS (Homebrew):
/usr/local/var/log/mongodb/mongo.log
- Docker: 일반적으로 stdout에 기록되지만,
/var/log/mongodb/mongod.log에 기록하도록 구성할 수 있습니다
MongoDB가 stdout으로 로깅하는 경우 mongod.conf를 업데이트하여 파일에 기록하도록 구성하십시오:systemLog:
destination: file
path: /var/log/mongodb/mongod.log
logAppend: true
# systemd의 경우
sudo systemctl restart mongod
# Docker의 경우
docker restart <mongodb-container>
MongoDB용 사용자 지정 OTel collector 구성 만들기
ClickStack에서는 사용자 지정 설정 파일을 마운트하고 환경 변수를 설정해 기본 OpenTelemetry Collector 구성을 확장할 수 있습니다. 사용자 지정 구성은 OpAMP를 통해 HyperDX가 관리하는 기본 구성과 머지됩니다.다음과 같은 내용으로 mongodb-monitoring.yaml 파일을 만드세요:receivers:
filelog/mongodb:
include:
- /var/log/mongodb/mongod.log
start_at: beginning
operators:
- type: json_parser
parse_from: body
parse_to: attributes
timestamp:
parse_from: attributes.t.$$date
layout: '2006-01-02T15:04:05.000-07:00'
layout_type: gotime
severity:
parse_from: attributes.s
overwrite_text: true
mapping:
fatal: F
error: E
warn: W
info: I
debug:
- D1
- D2
- D3
- D4
- D5
- type: move
from: attributes.msg
to: body
- type: add
field: attributes.source
value: "mongodb"
- type: add
field: resource["service.name"]
value: "mongodb-production"
service:
pipelines:
logs/mongodb:
receivers: [filelog/mongodb]
processors:
- memory_limiter
- transform
- batch
exporters:
- clickhouse
- 사용자 지정 구성에서는 새 수신기와 파이프라인만 정의합니다. processor(
memory_limiter, transform, batch)와 exporter(clickhouse)는 기본 ClickStack 구성에 이미 정의되어 있으므로 이름만 참조하면 됩니다.
- 이 구성은 collector가 시작될 때 기존 로그를 모두 읽도록
start_at: beginning을 사용합니다. 프로덕션 배포에서는 collector 재시작 시 로그를 다시 수집하지 않도록 start_at: end로 변경하세요.
사용자 지정 구성을 로드하도록 ClickStack 구성
기존 ClickStack 배포에서 사용자 지정 collector 구성을 활성화하려면 다음 작업을 수행해야 합니다.
- 사용자 지정 구성 파일을
/etc/otelcol-contrib/custom.config.yaml에 마운트합니다
- 환경 변수
CUSTOM_OTELCOL_CONFIG_FILE=/etc/otelcol-contrib/custom.config.yaml를 설정합니다
- collector가 MongoDB 로그를 읽을 수 있도록 MongoDB 로그 디렉터리를 마운트합니다
ClickStack 배포 구성을 업데이트합니다.services:
clickstack:
# ... 기존 구성 ...
environment:
- CUSTOM_OTELCOL_CONFIG_FILE=/etc/otelcol-contrib/custom.config.yaml
# ... 기타 환경 변수 ...
volumes:
- ./mongodb-monitoring.yaml:/etc/otelcol-contrib/custom.config.yaml:ro
- /var/log/mongodb:/var/log/mongodb:ro
# ... 기타 볼륨 ...
Docker와 함께 All-in-One image를 사용하는 경우 다음을 실행합니다.docker run --name clickstack \
-p 8080:8080 -p 4317:4317 -p 4318:4318 \
-e CUSTOM_OTELCOL_CONFIG_FILE=/etc/otelcol-contrib/custom.config.yaml \
-v "$(pwd)/mongodb-monitoring.yaml:/etc/otelcol-contrib/custom.config.yaml:ro" \
-v /var/log/mongodb:/var/log/mongodb:ro \
clickhouse/clickstack-all-in-one:latest
ClickStack collector에 MongoDB log file을 읽을 수 있는 적절한 권한이 있는지 확인하십시오. production 환경에서는 읽기 전용 마운트(:ro)를 사용하고 최소 권한 원칙을 따르십시오.
HyperDX에서 로그 확인
구성이 완료되면 HyperDX에 로그인하여 로그가 정상적으로 수집되는지 확인합니다:샘플 데이터세트 다운로드
샘플 로그 파일을 다운로드합니다.curl -O https://datasets-documentation.s3.eu-west-3.amazonaws.com/clickstack-integrations/mongodb/mongod.log
테스트용 collector 구성 생성
다음 구성으로 mongodb-demo.yaml 파일을 생성합니다.cat > mongodb-demo.yaml << 'EOF'
receivers:
filelog/mongodb:
include:
- /tmp/mongodb-demo/mongod.log
start_at: beginning
operators:
- type: json_parser
parse_from: body
parse_to: attributes
timestamp:
parse_from: attributes.t.$$date
layout: '2006-01-02T15:04:05.000-07:00'
layout_type: gotime
severity:
parse_from: attributes.s
overwrite_text: true
mapping:
fatal: F
error: E
warn: W
info: I
debug:
- D1
- D2
- D3
- D4
- D5
- type: move
from: attributes.msg
to: body
- type: add
field: attributes.source
value: "mongodb-demo"
- type: add
field: resource["service.name"]
value: "mongodb-demo"
service:
pipelines:
logs/mongodb-demo:
receivers: [filelog/mongodb]
processors:
- memory_limiter
- transform
- batch
exporters:
- clickhouse
EOF
데모 구성으로 ClickStack 실행
데모 로그와 구성을 사용해 ClickStack을 실행합니다.docker run --name clickstack-demo \
-p 8080:8080 -p 4317:4317 -p 4318:4318 \
-e CUSTOM_OTELCOL_CONFIG_FILE=/etc/otelcol-contrib/custom.config.yaml \
-v "$(pwd)/mongodb-demo.yaml:/etc/otelcol-contrib/custom.config.yaml:ro" \
-v "$(pwd)/mongod.log:/tmp/mongodb-demo/mongod.log:ro" \
clickhouse/clickstack-all-in-one:latest
HyperDX에서 로그 확인
ClickStack이 실행되면 다음을 수행합니다.
- HyperDX를 열고 계정에 로그인합니다(먼저 계정을 만들어야 할 수 있습니다)
- 검색 보기로 이동한 다음 소스를
Logs로 설정합니다
- 시간 범위에 **2026-03-09 00:00:00 - 2026-03-10 00:00:00 (UTC)**가 포함되도록 설정합니다
사전 구축된 대시보드 가져오기
- HyperDX를 열고 Dashboards 섹션으로 이동합니다.
- 오른쪽 상단의 줄임표 메뉴에서 “Import Dashboard”를 클릭합니다.
- mongodb-logs-dashboard.json 파일을 업로드한 다음 “Finish Import”를 클릭합니다.
대시보드가 생성되며 모든 시각화가 미리 구성됩니다
데모 데이터세트를 사용하는 경우 시간 범위에 **2026-03-09 00:00:00 - 2026-03-10 00:00:00 (UTC)**가 포함되도록 설정합니다.docker exec <container> cat /etc/otel/supervisor-data/effective.yaml | grep -A 10 filelog
docker exec <container> cat /etc/otel/supervisor-data/agent.log
tail -1 /var/log/mongodb/mongod.log | python3 -m json.tool
json_parser 연산자를 regex_parser로 대체하거나 MongoDB 4.4+로 업그레이드해야 합니다.
- 중요한 이벤트(오류 급증, 느린 쿼리 임계값 초과)에 대한 알림을 설정합니다
- 특정 사용 사례(레플리카 세트 모니터링, 연결 추적)에 맞는 추가 대시보드를 생성합니다
이 가이드는 빠르게 설정할 수 있도록 ClickStack에 내장된 OpenTelemetry Collector를 확장합니다. 프로덕션 배포에서는 자체 OTel Collector를 실행하고 데이터를 ClickStack의 OTLP 엔드포인트로 전송하는 것을 권장합니다. 프로덕션용 구성은 OpenTelemetry 데이터 전송을 참조하십시오.
