> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-8a08bda2.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 로컬 모드 전용

> 로컬 모드로만 ClickStack 배포 - ClickHouse Observability Stack

export const Image = ({img, alt, size}) => {
  return <Frame>
      <img src={img} alt={alt} />
    </Frame>;
};

[올인원 이미지](/ko/clickstack/deployment/docker-compose)와 마찬가지로, 이 포괄적인 Docker 이미지는 모든 ClickStack 구성 요소를 포함합니다:

* **ClickHouse**
* **HyperDX**
* **OpenTelemetry (OTel) collector** (포트 `4317` 및 `4318`에서 OTLP를 노출)
* **MongoDB** (애플리케이션 상태를 영구적으로 저장하기 위한 용도)

**다만, 이 HyperDX 배포판에서는 사용자 인증이 비활성화되어 있습니다**

<div id="suitable-for">
  ### 적합한 용도
</div>

* 데모
* 디버깅
* HyperDX를 사용하는 개발 환경

<div id="deployment-steps">
  ## 배포 단계
</div>

<br />

<Steps>
  <Step>
    ### Docker로 배포

    로컬 모드에서는 8080 포트에 HyperDX UI가 배포됩니다.

    ```shell theme={null}
    docker run -p 8080:8080 clickhouse/clickstack-local:latest
    ```
  </Step>

  <Step>
    ### HyperDX UI로 이동

    HyperDX UI에 접속하려면 [http://localhost:8080](http://localhost:8080)으로 이동하십시오.

    **이 배포 모드에서는 authentication이 활성화되어 있지 않으므로 사용자를 생성하라는 메시지가 표시되지 않습니다.**

    ClickHouse Cloud와 같은 외부 ClickHouse 클러스터에 연결하십시오.

    <Image img="https://mintcdn.com/private-7c7dfe99-mintlify-8a08bda2/16jdCy1HTWZ9Bvmz/images/use-cases/observability/hyperdx-2.png?fit=max&auto=format&n=16jdCy1HTWZ9Bvmz&q=85&s=45243f0126c49b735eb0f6aa3b8636ee" alt="로그인 생성" size="md" width="1966" height="1392" data-path="images/use-cases/observability/hyperdx-2.png" />

    소스를 생성하고 기본값은 모두 그대로 유지한 다음, `Table` 필드에 `otel_logs`를 입력하십시오. 나머지 설정은 모두 자동으로 감지되므로 `Save New Source`를 클릭하면 됩니다.

    <Image img="https://mintcdn.com/private-7c7dfe99-mintlify-8a08bda2/16jdCy1HTWZ9Bvmz/images/use-cases/observability/hyperdx-logs.png?fit=max&auto=format&n=16jdCy1HTWZ9Bvmz&q=85&s=32135e58b7ee1c4085b12b41ef2147ac" alt="로그 소스 생성" size="md" width="1944" height="1572" data-path="images/use-cases/observability/hyperdx-logs.png" />
  </Step>
</Steps>

<div id="schema-choice-map-vs-json">
  ## 스키마 선택: Map vs JSON
</div>

ClickStack는 기본적으로 속성을 `Map(LowCardinality(String), String)` 컬럼에 저장합니다. 이는 관측성 워크로드에 권장되는 스키마입니다. [버킷 기반 맵 직렬화](/ko/reference/data-types/map#bucketed-map-serialization)와 맵 키 및 값에 대한 텍스트 인덱스를 함께 사용하면, 동적 JSON 서브컬럼에서 발생하는 키별 수집 오버헤드 없이 필요한 항목만 선택적으로 조회할 수 있습니다.

`JSON` 타입 스키마는 속성 키 집합이 작고 안정적인 워크로드에서 평가할 수 있도록 베타로 제공됩니다. 기본값으로는 **권장되지 않습니다**. 전체 비교 내용과 JSON 지원을 활성화하는 데 필요한 환경 변수는 [Map vs JSON type](/ko/clickstack/ingesting-data/schema/map-vs-json)에서 확인하십시오.