STK-OBS-03 SigNoz 스택 compose 구성

작업 내용

SigNoz 스택을 별도 docker-compose.signoz.yml로 구성한다(ADR-006). SigNoz(query-service + frontend)와 ClickHouse 백엔드를 띄우고, SigNoz의 OTLP 수신 엔드포인트를 노출한다. SigNoz UI 포트는 Grafana(3000)와 충돌하지 않게 3301로 둔다.

이 티켓은 SigNoz UI 기동과 OTLP 수신 대기까지 완료한다(중앙 Collector가 SigNoz로 fan-out하는 라우팅은 STK-OBS-04).

롤백: docker compose -f docker-compose.signoz.yml down -v. 다른 compose 파일 무영향.

다이어그램

처리 흐름

sequenceDiagram
    participant Compose as docker-compose.signoz
    participant CH as ClickHouse
    participant SN as SigNoz
    Compose->>CH: up (스토리지)
    Compose->>SN: up (query + frontend)
    SN->>CH: 스키마 초기화·연결
    SN->>SN: OTLP 수신 포트 listen

컨테이너 의존

flowchart LR
    SN["SigNoz UI (3301)"]
    QS["SigNoz query-service"]
    CH["ClickHouse"]
    SN --> QS
    QS --> CH

테스트 케이스

• SigNoz UI(3301)가 기동하고 ClickHouse 연결이 정상이다.
• SigNoz OTLP 수신 포트가 listen 상태다.
• ClickHouse 스키마 초기화가 첫 기동 시 완료된다.
• 포트 충돌 케이스 — SigNoz UI 3301이 Grafana 3000과 겹치지 않는다.
• ClickHouse 볼륨 영속 — 재기동 후 기존 데이터가 유지된다.