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

# 서비스 맵

> ClickStack 서비스 맵으로 서비스 간 종속성과 요청 흐름을 시각화합니다.

export const Video = ({src, width = '100%', autoPlay = true, loop = true, muted = true, playsInline = true, ...rest}) => {
  const base = typeof window !== 'undefined' && window.location.pathname.startsWith('/docs') ? '/docs' : '';
  const fullSrc = src && src.startsWith('/') ? base + src : src;
  return <video src={fullSrc} width={width} autoPlay={autoPlay} loop={loop} muted={muted} playsInline={playsInline} {...rest} />;
};

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

export const galaxyOnClick = eventName => () => {
  try {
    if (typeof window !== "undefined" && window.galaxy && eventName) {
      window.galaxy.track(eventName, {
        interaction: "click"
      });
    }
  } catch (e) {}
};

export const BetaBadge = ({link, galaxyTrack, galaxyEvent}) => {
  if (link) {
    return <a href={link} target="_blank" rel="noopener noreferrer" className="betaBadge" onClick={galaxyTrack && galaxyEvent ? galaxyOnClick(galaxyEvent) : undefined}>
                <Icon />
                <span>베타</span>
            </a>;
  }
  return <div className="betaBadge">
            <Icon />
            <span>
                베타 기능. 
                <u>
                    <a href="/docs/beta-and-experimental-features#beta-features">
                        자세히 보기.
                    </a>
                </u>
            </span>
        </div>;
};

서비스 맵은 서비스들이 서로 어떻게 상호작용하는지 시각화합니다. ClickStack은 동일한 트레이스 내에서 클라이언트 스팬(나가는 요청)과 서버 스팬(들어오는 요청)을 매칭해 서비스 간 요청 경로를 재구성하고 그래프를 생성합니다.

왼쪽 탐색 패널에서 **Service Map**을 클릭해 전체 그래프를 여세요. OpenTelemetry로 [트레이스 데이터를 수집](/ko/clickstack/ingesting-data)하면 서비스가 표시됩니다.

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-8c05c8a2/_TDydWLKO6Z3njo9/images/clickstack/service-maps/service-map-overview.png?fit=max&auto=format&n=_TDydWLKO6Z3njo9&q=85&s=6ab39c677d7363317f62b186ddfa1b11" alt="서비스 노드와 그 사이의 요청 흐름을 보여주는 서비스 맵" size="lg" width="1999" height="981" data-path="images/clickstack/service-maps/service-map-overview.png" />

<div id="exploring-the-service-map">
  ## 서비스 맵 살펴보기
</div>

각 노드는 서비스를 나타내며 `service.name` resource 속성으로 식별됩니다. 간선(점선)은 한 서비스의 클라이언트 스팬이 다른 서비스의 서버 스팬과 일치할 때 두 서비스를 연결합니다. 노드 크기는 상대적인 트래픽 양을 반영하며, 빨간색 노드는 선택한 시간 범위에서 오류가 발생한 서비스를 나타냅니다.

맵 위의 도구 모음에서 필터를 적용하고 보기를 조정할 수 있습니다.

**소스 셀렉터** — 맵을 특정 트레이스 소스(예: "ClickPy Traces")로 필터링합니다.

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-8c05c8a2/_TDydWLKO6Z3njo9/images/clickstack/service-maps/source-selector.png?fit=max&auto=format&n=_TDydWLKO6Z3njo9&q=85&s=a998e19c6d8bafaf94b37690279c4c0d" alt="서비스 맵 도구 모음에서 강조 표시된 소스 셀렉터" size="lg" width="3838" height="138" data-path="images/clickstack/service-maps/source-selector.png" />

**샘플링 슬라이더** — 성능과 정확성의 균형을 맞출 수 있도록 샘플링 비율을 조정합니다. 비율이 낮을수록 대용량 클러스터에서 더 빠르게 로드됩니다.

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-8c05c8a2/_TDydWLKO6Z3njo9/images/clickstack/service-maps/sampling.png?fit=max&auto=format&n=_TDydWLKO6Z3njo9&q=85&s=624f847e0ddf0717486719c687bc4d32" alt="서비스 맵 도구 모음에서 강조 표시된 샘플링 슬라이더" size="lg" width="3838" height="138" data-path="images/clickstack/service-maps/sampling.png" />

**날짜 범위 선택기** — 맵을 생성하는 데 사용하는 트레이스 데이터의 시간 범위를 설정합니다.

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-8c05c8a2/_TDydWLKO6Z3njo9/images/clickstack/service-maps/date-selector.png?fit=max&auto=format&n=_TDydWLKO6Z3njo9&q=85&s=8805b947c5eee06d445d184ab501a679" alt="서비스 맵 도구 모음에서 강조 표시된 날짜 범위 선택기" size="lg" width="3838" height="138" data-path="images/clickstack/service-maps/date-selector.png" />

맵 왼쪽 아래의 **+/-** 버튼을 사용하거나 스크롤하여 확대하거나 축소할 수 있습니다.

<div id="trace-level-service-maps">
  ## 트레이스 수준 서비스 맵
</div>

개별 트레이스를 살펴보면, 해당 요청이 서비스 간을 어떻게 이동했는지 보여 주는 서비스 맵이 표시됩니다. 이를 통해 트레이스 워터폴을 벗어나지 않고도 단일 요청의 토폴로지를 확인할 수 있습니다.

<Frame>
  <Video src="/images/clickstack/service-maps/service-map-demo.mp4" />
</Frame>
