> ## Documentation Index
> Fetch the complete documentation index at: https://control.datarelay.run/llms.txt
> Use this file to discover all available pages before exploring further.

# 활용 사례별 실습

> 데이터 수집부터 전송·보호·장애 처리까지 직접 실행할 수 있는 DataRelay Control 실습 매뉴얼입니다.

# 활용 사례별 실습

원하는 결과에 따라 안내서를 선택하세요. 모든 가이드는 **사전 조건 → 실제 화면에서 누를 항목 → 예시 입력 → 성공 확인 → 실패 시 조치** 순서로 작성했습니다. 기준 제품은 `datarelay-labs/datarelay-control` \*\*main-v2 @ f7ae7b35 (2026-10-18)\*\*입니다.

> [!WARNING]
>
> 실습은 비운영 환경에서 가상 이벤트로 진행하세요. 실제 API Token, 고객 개인정보, 운영 로그는 입력하지 마세요. 전체 사용자 브라우저 검증은 [제품 이슈 #413](https://github.com/datarelay-labs/datarelay-control/issues/413)에서 진행 중입니다. Preview 성공만으로 실제 전송 성공을 판단하지 않습니다.

**실제 화면을 보며 따라하려면:** [번호·설명이 표시된 Stream Wizard 스크린샷 가이드](https://control.datarelay.run/ko/use-cases/screen-walkthrough.md)에서 Connector 선택부터 배포·로그 확인까지 진행하세요.

## 커넥터별 따라하기: 먼저 준비하고 나중에 실행하기

**① Vendor API/연동 가이드 확인 → ② 접속·인증·권한·샘플 준비 → ③ 모르면 ChatGPT에 공개 문서와 비식별 샘플로 질문 → ④ Connector 생성·연결 테스트 → ⑤ Destination 생성 → ⑥ Stream/Record Selection/Checkpoint → ⑦ Mapping·Masking·지원되는 Tokenization → ⑧ Deploy → ⑨ Logs와 실제 수신 시스템 검증 → ⑩ 장애·Schema Drift 대응** 순서로 진행합니다.

각 Connector 페이지 첫 부분에 이 절차와 필요한 입력값, ChatGPT 질문 예시, 장애 대응을 추가했습니다. 실제 제품 화면으로 검증된 스크린샷만 사용하며, 인증된 내부 화면이 확보되지 않은 단계에 가짜 화면을 넣지 않습니다.

## 처음 시작하는 사용자

1. [실습 환경 준비](https://control.datarelay.run/ko/use-cases/lab-setup.md): 표준 라이브러리만 사용하는 Python 테스트 수신기와 샘플 데이터를 준비합니다.
2. [Webhook으로 첫 이벤트 전송](https://control.datarelay.run/ko/use-cases/webhook-first-flow.md): Connector, Destination, Stream, Route를 직접 만들고 수신 결과를 확인합니다.
3. [외부 HTTP API 수집](https://control.datarelay.run/ko/use-cases/http-api.md): API 연결, 샘플, 이벤트 선택 및 Checkpoint를 설정합니다.

## 수집 방식·연동 제품별 실습

| 업무 | 따라하기 |
| - | - |
| XDR/SIEM으로 Syslog UDP 전송 | [Syslog Destination](https://control.datarelay.run/ko/use-cases/syslog-delivery.md) |
| PostgreSQL 테이블에서 이벤트 수집 | [PostgreSQL](https://control.datarelay.run/ko/use-cases/postgresql-collection.md) |
| AWS S3/MinIO 객체 로그 수집 | [S3·MinIO](https://control.datarelay.run/ko/use-cases/s3-object-collection.md) |
| SFTP 서버의 JSONL 파일 수집 | [SFTP 원격 파일](https://control.datarelay.run/ko/use-cases/sftp-file-collection.md) |
| 매일 Dashboard에서 장애 점검 | [일일 운영 점검](https://control.datarelay.run/ko/use-cases/daily-operations.md) |

## 업무 목적별 시나리오

| 구현하려는 업무 | 따라하기 |
| - | - |
| 하나의 데이터를 서로 다른 두 시스템에 동시에 전송 | [2개 Destination과 Route](https://control.datarelay.run/ko/use-cases/multi-destination.md) |
| 외부 시스템으로 보낼 때만 이메일 등 개인정보 마스킹 | [Route별 개인정보 보호](https://control.datarelay.run/ko/use-cases/protect-pii.md) |
| API 응답의 필드가 추가되거나 타입이 변경됨 | [Schema 변경 확인 및 대응](https://control.datarelay.run/ko/use-cases/schema-change.md) |
| 민감 이벤트를 격리하고 검토한 후 처리 | [Quarantine·Release·Replay](https://control.datarelay.run/ko/use-cases/quarantine-replay.md) |
| Destination 장애로 전송이 실패함 | [전송 장애 진단과 복구](https://control.datarelay.run/ko/use-cases/delivery-incident.md) |
| 장애 로그를 필터링·저장·파일로 증빙 | [Logs·Saved View·Export](https://control.datarelay.run/ko/use-cases/logs-audit.md) |
| 기존 통합 패키지로 Connector 구성 | [Marketplace에서 Stream까지](https://control.datarelay.run/ko/use-cases/marketplace-install.md) |

## 제품 구성과 기본 순서

```text theme={null}
Source / Connector → Stream → Route A → Destination A
                            └→ Route B → Destination B
```

Stream은 실행 단위, Route는 목적지별 처리 단위입니다. 목적지별로 변환이나 보호 정책이 달라도 Stream을 여러 개 만들 필요가 없습니다.

**Connect → Sample & Record Selection → Destinations → Route Processing → Deploy** 순서로 구성합니다.

모든 실습의 완료 기준은 설정 저장만이 아니라 **실제 Run, Route 전달 로그, 수신 시스템의 데이터**까지 비교하는 것입니다. [첫 Stream](https://control.datarelay.run/ko/getting-started/first-stream.md), [Route Processing](https://control.datarelay.run/ko/processing/route-processing.md), [알려진 제한](https://control.datarelay.run/ko/reference/limitations.md)도 참고하세요.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.