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

# Broadcast

> Broadcast로 AIHubMix API 요청의 Trace를 LangWatch에 전송하고 개인정보 보호 모드, 샘플링 비율 및 API Key 필터를 설정합니다.

Broadcast는 AIHubMix API 요청의 Trace를 설정된 외부 관측성 플랫폼으로 자동 전송합니다. 애플리케이션 코드에 별도의 계측을 추가하지 않고도 LangWatch에서 LLM 사용량을 모니터링하고 디버깅하며 분석할 수 있습니다.

AIHubMix는 현재 LangWatch를 Broadcast 목적지로 지원합니다. 설정 후 LangWatch에서 모델, token 사용량, 실제 청구 비용, 지연 시간, 세션 및 Trace 정보를 확인할 수 있습니다.

<h2 id="prerequisites">
  사전 준비
</h2>

* 사용 가능한 [AIHubMix API Key](https://console.aihubmix.com/token)
* LangWatch 계정과 대상 Project
* AIHubMix 콘솔 접근 권한

<Warning>
  이 연동에는 대상 Project의 기존 `Project API Key`가 필요합니다. 형식은 `sk-lw-*`입니다. 조직 또는 팀 범위 키와 Personal OTLP Endpoint의 `pkey_*`는 이 설정에서 사용할 수 없습니다. AIHubMix는 현재 LangWatch 공식 클라우드 엔드포인트를 사용하며 자체 호스팅 인스턴스는 지원하지 않습니다.
</Warning>

<h2 id="get-project-api-key">
  1. LangWatch Project API Key 가져오기
</h2>

1. [LangWatch](https://app.langwatch.ai/)에 로그인하고 AIHubMix Trace를 받을 Project를 선택합니다.
2. **Settings → API Keys**를 엽니다.
3. **Project API Key**를 찾고 Scope가 대상 Project인지 확인한 다음 복사 버튼을 선택합니다.

새 Secret Key를 만들 필요가 없습니다. AIHubMix는 Project에 기본 제공되는 Project API Key를 사용합니다.

<Frame>
  <img src="https://mintcdn.com/aihubmix/PiZJ1a0NTd3CcQSY/images/guides/langwatch/langwatch-project-api-key.png?fit=max&auto=format&n=PiZJ1a0NTd3CcQSY&q=85&s=e4f2c0e98769f3359b7c967118b4b2c8" alt="LangWatch Settings의 Project API Key" width="1729" height="777" data-path="images/guides/langwatch/langwatch-project-api-key.png" />
</Frame>

<h2 id="add-destination">
  2. LangWatch 목적지 추가
</h2>

1. [AIHubMix Broadcast](https://console.aihubmix.com/observability)를 엽니다.
2. **Add destination**에서 **LangWatch**를 선택합니다.

<Frame>
  <img src="https://mintcdn.com/aihubmix/FwRluLwfe9pqf0Wh/images/guides/langwatch/aihubmix-observability-overview.png?fit=max&auto=format&n=FwRluLwfe9pqf0Wh&q=85&s=df35c0e79db7f55c71bbc088fb486176" alt="AIHubMix Broadcast의 LangWatch 목적지" width="1729" height="777" data-path="images/guides/langwatch/aihubmix-observability-overview.png" />
</Frame>

3. 설정을 입력합니다.

| 설정                              | 설명                                                                                |
| ------------------------------- | --------------------------------------------------------------------------------- |
| **Name**                        | `Production tracing`과 같이 알아보기 쉬운 이름을 입력합니다.                                       |
| **API Key**                     | 이전 단계에서 복사한 LangWatch Project API Key를 붙여 넣습니다. 키는 암호화되어 저장되며 전달에만 사용됩니다.         |
| **Privacy**                     | 활성화하면 prompt와 completion 본문을 보내지 않습니다. token 사용량, 실제 청구 비용, 지연 시간 및 모델 정보는 전송됩니다. |
| **Sampling rate**               | 전달할 트래픽 비율을 설정합니다. 최초 확인에는 `100%`를 사용합니다.                                         |
| **Only forward these API keys** | 선택 사항입니다. 전달할 AIHubMix API Key를 지정합니다. 비워 두면 모든 Key의 기록을 전달합니다.                   |

`x-session-id` 요청 헤더와 `user` 필드도 함께 전달되며, LangWatch에서 세션이나 사용자를 연결하는 데 사용할 수 있습니다.

<Frame>
  <img src="https://mintcdn.com/aihubmix/PiZJ1a0NTd3CcQSY/images/guides/langwatch/aihubmix-add-destination.png?fit=max&auto=format&n=PiZJ1a0NTd3CcQSY&q=85&s=63f9c79da713529c9acc37e7e851198f" alt="AIHubMix의 LangWatch 목적지 설정" width="1729" height="1007" data-path="images/guides/langwatch/aihubmix-add-destination.png" />
</Frame>

<h3 id="test-and-save">
  테스트 및 저장
</h3>

1. **Test**를 선택합니다. 연결에 성공하면 **Connected**가 표시됩니다.
2. **Add destination**을 선택해 새 목적지를 저장합니다.
3. 목적지가 활성화되어 있고 상태가 **OK**인지 확인합니다.

이후 변경 사항은 **Save changes**로 저장합니다.

<Frame>
  <img src="https://mintcdn.com/aihubmix/PiZJ1a0NTd3CcQSY/images/guides/langwatch/aihubmix-connection-ok.png?fit=max&auto=format&n=PiZJ1a0NTd3CcQSY&q=85&s=590bea62d4671e867598ac0a2ec81588" alt="AIHubMix에서 상태가 OK인 LangWatch 목적지" width="1729" height="998" data-path="images/guides/langwatch/aihubmix-connection-ok.png" />
</Frame>

<h2 id="send-test-request">
  3. 확인 요청 보내기
</h2>

현재 셸에 `AIHUBMIX_API_KEY`가 설정되어 있는지 확인한 다음 일반 모델 요청을 보냅니다.

```bash cURL theme={null}
curl https://aihubmix.com/v1/chat/completions \
  -H "Authorization: Bearer $AIHUBMIX_API_KEY" \
  -H "Content-Type: application/json" \
  -H "x-session-id: langwatch-tutorial" \
  -d '{
    "model": "gpt-4o-mini",
    "messages": [{"role": "user", "content": "What is the meaning of life?"}],
    "user": "langwatch-tutorial"
  }'
```

<Note>기록은 비동기 전달됩니다. 요청 완료 후 Trace가 LangWatch에 나타나기까지 몇 초가 걸릴 수 있습니다.</Note>

<h2 id="verify-in-langwatch">
  4. LangWatch에서 확인
</h2>

1. 대상 Project의 **Traces**를 엽니다.
2. 요청에 사용한 모델, `x-session-id` 또는 `user` 값으로 기록을 찾습니다.
3. 지연 시간, 비용, token 및 모델 정보가 포함되어 있는지 확인합니다.

<Frame>
  <img src="https://mintcdn.com/aihubmix/PiZJ1a0NTd3CcQSY/images/guides/langwatch/langwatch-trace-result.png?fit=max&auto=format&n=PiZJ1a0NTd3CcQSY&q=85&s=f0bf5cb874edaa85ef4c414d40ef710b" alt="LangWatch Traces의 AIHubMix API 호출" width="1211" height="717" data-path="images/guides/langwatch/langwatch-trace-result.png" />
</Frame>

Privacy가 활성화되면 Prompt 같은 본문 열은 비어 있고 지연 시간, 비용, token 및 모델 정보는 유지됩니다.

<Frame>
  <img src="https://mintcdn.com/aihubmix/PiZJ1a0NTd3CcQSY/images/guides/langwatch/langwatch-privacy-columns.png?fit=max&auto=format&n=PiZJ1a0NTd3CcQSY&q=85&s=8459d00d51009145d7e74812cbfb75f2" alt="Privacy 활성화 후 LangWatch의 비어 있는 본문 열" width="1211" height="717" data-path="images/guides/langwatch/langwatch-privacy-columns.png" />
</Frame>

<h2 id="troubleshooting">
  문제 해결
</h2>

<h3 id="test-returns-401">
  Test가 401을 반환함
</h3>

대상 Project의 **Project API Key**를 사용했는지 확인합니다. Personal OTLP Endpoint의 `pkey_*`나 조직 또는 팀 범위 키는 사용하지 않습니다.

<h3 id="no-traces">
  저장했지만 Trace가 표시되지 않음
</h3>

목적지가 활성화되고 상태가 **OK**인지, Sampling rate가 `0%`보다 큰지, API Key 필터에 요청에 사용한 Key가 포함되는지 확인합니다. 몇 초 기다린 뒤 Traces를 새로 고칩니다.

<h3 id="privacy-metrics">
  Privacy가 메트릭에 영향을 주는지
</h3>

Privacy는 prompt와 completion 본문 전송만 중지합니다. token 사용량, 실제 청구 비용, 지연 시간 및 모델 정보는 계속 전송됩니다.

***

최종 업데이트: 2026-08-25