WorldMonitor: 실시간 글로벌 인텔리전스 대시보드

WorldMonitor는 뉴스, 지정학적 사건, 인프라 데이터를 통합된 상황 인식 인터페이스로 집계하는 오픈 소스 (open-source) 실시간 글로벌 인텔리전스 대시보드입니다. 59,524개의 GitHub stars를 기록하며, 지정학적 모니터링 및 OSINT (Open Source Intelligence) 분석을 위한 Palantir Gotham과 같은 상용 플랫폼의 선도적인 오픈 소스 대안으로 부상했습니다.

이 기사에서는 설치, 설정, 데이터 소스, API 사용법, 배포 옵션, 그리고 기자, 연구원, 보안 분석가를 위한 실질적인 활용법을 다룹니다.

요약 (TL;DR)

WorldMonitor는 파편화된 글로벌 데이터 스트림을 단일하고 실행 가능한 인텔리전스 대시보드로 변환합니다. 50개 이상의 소스로부터 뉴스를 수집하고, 지정학적 사건을 실시간으로 추적하며, 전 세계의 핵심 인프라를 모니터링하고, 맞춤형 알림 기능이 포함된 AI 기반 분석을 제공합니다. 기업용 가격을 지불하지 않고도 글로벌 사건에 대한 포괄적이고 실시간적인 시각이 필요한 모든 이들에게 완벽한 도구입니다.

WorldMonitor란 무엇인가?

WorldMonitor는 여러 데이터 소스를 결합하여 글로벌 사건에 대한 통합된 뷰를 제공하는 셀프 호스팅 (self-hosted) 인텔리전스 대시보드입니다. 단순히 헤드라인을 수집하는 전통적인 뉴스 애그리게이터 (news aggregator)와 달리, WorldMonitor는 AI 기반 분석을 적용하여 사건 간의 상관관계를 분석하고, 패턴을 탐지하며, 실행 가능한 인텔리전스를 도출합니다.

이 플랫폼은 여러 지리적 영역과 데이터 카테고리에 걸쳐 실시간 상황 인식이 필요한 기자, 연구원, 정책 분석가 및 보안 전문가를 위해 설계되었습니다. 개인 분석가를 위한 단일 인스턴스 (single-instance) 배포와 팀 단위 운영을 위한 분산 아키텍처 (distributed architectures)를 모두 지원합니다.

주요 기능은 다음과 같습니다:

• 50개 이상의 글로벌 뉴스 소스를 커버하는 RSS 피드, API 및 웹 스크레이퍼(web scrapers)를 통한 다중 소스 뉴스 집계 (Multi-source news aggregation)
• 실시간 매핑 및 타임라인 시각화를 포함한 지정학적 이벤트 추적 (Geopolitical event tracking)
• 전력망, 통신 타워, 교통 허브를 포함한 주요 시설에 대한 인프라 모니터링 (Infrastructure monitoring)
• 겉보기에 관련 없어 보이는 이벤트 간의 관계를 식별하는 AI 기반 상관관계 엔진 (AI-powered correlation engine)
• 키워드, 지역, 이벤트 유형 또는 심각도 임계값에 기반한 맞춤형 알림 (Customizable alerting)
• 수개월간 집계된 데이터를 검색 가능한 아카이브로 제공하는 과거 데이터 분석 (Historical analysis)
• 다른 인텔리전스 도구와의 프로그래밍 방식 통합을 위한 API 액세스 (API access)

설치 가이드 (Installation Guide)

사전 요구 사항 (Prerequisites)

WorldMonitor를 설치하기 전에 시스템이 다음 요구 사항을 충족하는지 확인하십시오:

• 운영 체제 (Operating System): Ubuntu 22.04 LTS, Debian 12 또는 macOS 14 이상
• CPU: 최소 4코어 (운영 환경(production)에서는 8코어 권장)
• RAM: 최소 8GB (16GB 권장)
• 저장 공간 (Storage): 50GB SSD (데이터 보관 기간에 따라 증가함)
• 네트워크 (Network): 데이터 수집을 위한 외부 인터넷 접속 가능 상태
• 의존성 (Dependencies): Node.js 20+, Python 3.11+, PostgreSQL 15+

옵션 1: Docker Compose 배포 (권장) (Option 1: Docker Compose Deployment (Recommended))

가장 빠르게 시작하는 방법은 제공된 Docker Compose 설정을 사용하는 것입니다:

git clone https://github.com/koala73/worldmonitor.git
cd worldmonitor

...

이 방식은 애플리케이션 서버, PostgreSQL 데이터베이스, Redis 캐시 및 웹 프론트엔드를 실행합니다. 기본 자격 증명은 .env 파일에 설정되어 있습니다 — 운영 환경에서 사용하려면 즉시 변경하십시오.

옵션 2: 수동 설치 (Option 2: Manual Installation)

배포에 대해 세밀한 제어가 필요한 사용자를 위한 방법입니다:

# 리포지토리 클론 (Clone the repository)
git clone https://github.com/koala73/worldmonitor.git
cd worldmonitor
...

옵션 3: Kubernetes 배포 (Option 3: Kubernetes Deployment)

여러 노드에 걸친 운영 규모의 배포를 위한 방법입니다:

apiVersion: apps/v1
kind: Deployment
metadata:
...

구성 심층 분석 (Configuration Deep Dive)

데이터 소스 구성 (Data Sources Configuration)

WorldMonitor는 여러 데이터 소스 유형을 지원합니다. config.yaml에서 이를 구성할 수 있습니다:

data_sources:
  rss_feeds:
    enabled: true
...

python
from worldmonitor.ai.pipeline import AnalysisPipeline
from worldmonitor.ai.models import EventClassifier, CorrelationEngine

분석 파이프라인 초기화

pipeline = AnalysisPipeline(
classifier=EventClassifier(model="worldmonitor/classifier-v3"),
correlation=CorrelationEngine(model="worldmonitor/correlation-v2"),
embedding_model="worldmonitor/embedding-multilingual"
)

뉴스 기사 배치 처리

results = await pipeline.process_batch(
articles=batch_data,
min_confidence=0.7,
include_correlations=True
)

특정 지역의 상관관계 이벤트 가져오기

correlated = await pipeline.get_correlated_events(
region="east_asia",
time_window="24h",
event_types=["political", "economic"]
)

### 경고 설정 (Alert Configuration)

...

yaml
alerts:
rules:

• name: "Major Conflict Detection"
  conditions:
• field: "event_type"
  operator: "eq"
  value: "armed_conflict"
• field: "severity"
  operator: "gte"
  value: 7
  actions:
• type: "notification"
  channels: ["email", "telegram"]
  template: "high_severity_conflict"
• type: "dashboard_highlight"
  duration: "3600"

- name: "Infrastructure Disruption"
  conditions:
    - field: "infrastructure_type"
...

핵심 기능 상세 (Core Features in Detail)

...

  
bash

# 필터링된 집계 뉴스 조회
curl -X GET "[https://your-worldmonitor/api/v1/news](https://your-worldmonitor/api/v1/news)" \  
-H "Authorization: Bearer ${WM_API_KEY}" \  
-d "region=east_asia&categories=politics,economy&min_severity=5&hours=24"

# 중복 제거된 스토리 가져오기
curl -X GET "[https://your-worldmonitor/api/v1/news/deduplicated](https://your-worldmonitor/api/v1/news/deduplicated)" \  
-H "Authorization: Bearer ${WM_API_KEY}" \  
-d "cluster_window=3600&language=en"  

지정학적 이벤트 매핑 (Geopolitical Event Mapping)

...

지정학적 이벤트 매핑 (Geopolitical Event Mapping)

...

from worldmonitor.correlation import CorrelationEngine

engine = CorrelationEngine()

최근 이벤트 간의 상관관계 찾기

correlations = engine.find_correlations(
events=event_list,
max_lag_hours=72,
min_strength=0.6,
correlation_types=["temporal", "geographic", "thematic"]
)

for corr in correlations:
print(f"Strength: {corr.strength:.2f}")
print(f"Type: {corr.type}")
print(f"Events: {corr.event_ids}")
print(f"Explanation: {corr.explanation}")

API Reference

...

bash

API 토큰 얻기

curl -X POST "https://your-worldmonitor/api/v1/auth/login" \
-H "Content-Type: application/json" \
-d '{"username": "admin", "password": "${WM_PASSWORD}"}'

### News API

bash

페이지네이션을 사용하여 최근 뉴스 목록 가져오기

curl "https://your-worldmonitor/api/v1/news?page=1&per_page=50" \
-H "Authorization: Bearer ${WM_TOKEN}"

지역별 뉴스 가져오기

curl "https://your-worldmonitor/api/v1/news?region=south_asia&date_from=2026-06-01" \
-H "Authorization: Bearer ${WM_TOKEN}"

키워드로 검색하기

curl "https://your-worldmonitor/api/v1/news/search?q=trade+sanctions" \
-H "Authorization: Bearer ${WM_TOKEN}"

### Events API

bash

지정학적 이벤트 목록 가져오기

curl "https://your-worldmonitor/api/v1/events?type=political&severity_gte=6" \
-H "Authorization: Bearer ${WM_TOKEN}"

이벤트 상세 정보 가져오기

curl "https://your-worldmonitor/api/v1/events/EVT-2026-0625-001" \
-H "Authorization: Bearer ${WM_TOKEN}"

이벤트 타임라인 가져오기

curl "https://your-worldmonitor/api/v1/events/EVT-2026-0625-001/timeline" \
-H "Authorization: Bearer ${WM_TOKEN}"

### Alerts API

bash

활성 알림 목록 가져오기 (List active alerts)

curl "https://your-worldmonitor/api/v1/alerts?status=active" \
-H "Authorization: Bearer ${WM_TOKEN}"

알림 확인 (Acknowledge an alert)

curl -X PUT "https://your-worldmonitor/api/v1/alerts/ALT-001/acknowledge" \
-H "Authorization: Bearer ${WM_TOKEN}" \
-H "Content-Type: application/json" \
-d '{"acknowledged_by": "analyst@example.com", "notes": "Investigating"}'

사용자 지정 알림 규칙 생성 (Create custom alert rule)

curl -X POST "https://your-worldmonitor/api/v1/alerts/rules" \
-H "Authorization: Bearer ${WM_TOKEN}" \
-H "Content-Type: application/json" \
-d '{
"name": "Custom Rule",
"conditions": {
"regions": ["east_asia"],
"event_types": ["political"],
"severity_min": 5
},
"actions": {
"channels": ["email"],
"recipients": ["team@example.com"]
} '

## 배포 옵션 (Deployment Options)

...

plaintext
Server: 4 vCPU, 8GB RAM, 100GB SSD
비용: ~$20/month (DigitalOcean / HTStack)
용량: ~1,000 이벤트/일, 30일 보존 기간

### 팀 배포 (Team Deployment)

...

plaintext
App 서버: 3x 4 vCPU, 16GB RAM (로드 밸런서 뒤)
데이터베이스: PostgreSQL Primary + 읽기 복제본 2개
캐시: Redis Cluster (3 노드)
저장 공간: 500GB SSD + S3 아카이빙
비용: ~$200/month
용량: ~10,000 이벤트/일, 90일 보존 기간

### 엔터프라이즈/분산 (Enterprise/Distributed)

...

데이터 주권 (Data sovereignty) 제어를 포함한 멀티 리전 배포 (Multi-region deployment)
10개 이상의 애플리케이션 노드에 걸친 수평적 확장 (Horizontal scaling)
자동 장애 조치 (Automatic failover)를 위한 Patroni 기반 PostgreSQL
과거 데이터 아카이빙을 위한 객체 스토리지 (Object storage)
기존 SIEM/SOC 플랫폼과의 통합
비용: 맞춤형 가격 책정 (Custom pricing)
용량: 지리적으로 분산된 데이터 수집을 통한 무제한 용량

## 다른 도구와의 통합 (Integration with Other Tools)

...

# Slack 앱 설치

curl -X POST "https://your-worldmonitor/api/v1/integrations/slack" \\  
-H "Authorization: Bearer ${WM_TOKEN}" \\  
-H "Content-Type: application/json" \\  
-d '{  
"channel": "#global-events",  
"alert_rules": ["major_conflict", "infrastructure_disruption"],  
"digest_frequency": "hourly"  
}'  

Telegram Bot

# Telegram 봇 통합 생성

curl -X POST "https://your-worldmonitor/api/v1/integrations/telegram" \\  
-H "Authorization: Bearer ${WM_TOKEN}" \\  
-H "Content-Type: application/json" \\  
-d '{  
"bot_token": "${TELEGRAM_BOT_TOKEN}",  
"chat_id": "${TELEGRAM_CHAT_ID}",  
"alert_rules": ["all_high_severity"]  
}'  

Grafana Dashboard

# Grafana용 메트릭 (Metrics) 내보내기

curl -X POST "https://your-worldmonitor/api/v1/metrics/grafana" \\  
-H "Authorization: Bearer ${WM_TOKEN}" \\  
-H "Content-Type: application/json" \\  
-d '{  
"datasource": "prometheus",  
"dashboard_template": "worldmonitor-overview"  
}'  

ELK Stack / Elasticsearch

# WorldMonitor Elasticsearch 출력 설정

output:  
elasticsearch:  
hosts: ["https://es-cluster.internal:9200"]  
index: "worldmonitor-%{+yyyy.MM.dd}"  
username: "${ES_USER}"  
password: "${ES_PASS}"  
template_overwrite: true  
bulk_size: 500  
flush_interval: 5  

비교: WorldMonitor vs 상용 대안 (Comparison: WorldMonitor vs Commercial Alternatives)

...

bash

# 1. 클론 및 설정 (Clone and configure)

git clone https://github.com/koala73/worldmonitor.git 
cd worldmonitor  
cp config.example.yaml config.yaml

# 2. 데이터 소스 API 키 설정 (Set API keys for data sources)

export GDELT_API_KEY="your-gdelt-key"  
export ACLED_API_KEY="your-acled-key"

# 3. Docker로 시작하기 (Start with Docker)

docker compose up -d

# 4. 설치 확인 (Verify installation)

curl http://localhost:8000/api/v1/status

# 5. 첫 번째 알림 규칙 추가 (Add your first alert rule)

curl -X POST http://localhost:8000/api/v1/alerts/rules \  
-H "Content-Type: application/json" \  
-d '{"name": "Test Alert", "conditions": {"severity_gte": 8}, "actions": {"channels": ["email"]}}'

# 6. 대시보드 접속 (Access the dashboard)

# 브라우저에서 http://localhost:3000을 열어주세요.

## 결론 (Conclusion)