이 문서에서는 OpenTelemetry(OTel)를 사용하여 조직 전체에서 Claude Cowork 활동을 모니터링하는 방법을 설명합니다. OTel을 사용하면 보안 및 운영 팀이 Cowork 이벤트를 이미 사용 중인 관찰성 도구로 스트리밍하여 사용량을 추적하고, 사건을 조사하며, 성능을 분석할 수 있습니다.
가용성
Claude Cowork용 OpenTelemetry 모니터링은 Team 및 Enterprise 플랜에서 사용 가능합니다. 클라우드에서 실행되는 Cowork 세션(데스크톱, 웹, 모바일)과 로컬 데스크톱 세션을 모두 포함합니다. 클라우드에서 세션을 모니터링하려면 Claude Desktop 버전 1.22209.3 이상이 필요하고, 로컬 데스크톱 세션을 모니터링하려면 Claude Desktop 버전 1.1.4173 이상이 필요합니다.
채팅과 Cowork을 결합한 새로운 Claude 환경이 Pro, Max, Ultra 플랜에 출시되고 있습니다. Team 플랜(베타)과 Enterprise 플랜에서는 Chat and Cowork unified가 켜져 있는 경우 사용 가능합니다. 이를 켜지 않은 조직은 채팅과 Cowork을 별도 옵션으로 유지하므로 이 문서가 계속 적용됩니다. Enterprise 소유자는 Enterprise 조직을 위한 새로운 통합 Claude 환경 설정 및 관리에서 자세히 알아볼 수 있습니다.
모니터링할 수 있는 항목
Claude Cowork을 OpenTelemetry 수집기에 연결하면 Cowork은 다음을 포함하는 이벤트를 스트리밍합니다:
사용자 프롬프트. 콘텐츠 캡처에 사용자 프롬프트가 포함된 경우 사용자가 Cowork에 제출한 프롬프트의 전체 텍스트입니다. 그렇지 않으면 각 프롬프트는 텍스트 없이 기록됩니다.
도구 및 MCP 호출. 세션 중에 Claude가 수행하는 모든 도구 호출(도구 이름, 성공 또는 실패, 실행 시간 포함). 콘텐츠 캡처에 도구 세부 정보가 포함된 경우 이벤트는 도구의 매개변수(MCP 도구의 경우 MCP 서버 및 도구 이름 포함)와 도구 실패 시 오류 메시지도 포함합니다.
파일 액세스. 사용자가 세션에 연결한 폴더입니다. 콘텐츠 캡처에 도구 세부 정보가 포함된 경우 이벤트는 Claude가 읽거나, 수정하거나, 그 외 다른 방식으로 접근한 파일 경로(MCP를 통해 액세스한 파일 포함)도 포함합니다.
스킬 및 플러그인. 세션 내에서 Claude가 사용하는 스킬 및 플러그인입니다. 콘텐츠 캡처에 도구 세부 정보가 포함되지 않으면 Anthropic에서 제공하지 않는 스킬 및 플러그인은 자리 표시자 이름으로 표시됩니다.
사용자 승인 결정. 각 도구 작업이 사용자에 의해 승인되었는지, 사용자에 의해 거부되었는지, 또는 기존 권한에 따라 자동으로 시작되었는지 여부입니다.
API 요청 및 오류. 요청별 모델, 토큰 수, 예상 비용, 기간 및 반환된 오류입니다.
공유 prompt.id 속성은 단일 사용자 프롬프트로 인해 트리거된 모든 이벤트를 연결하므로 하나의 입력에 대해 Claude가 수행한 모든 작업을 재구성할 수 있습니다.
전체 이벤트 유형 및 속성 목록은 claude.com/docs의 Cowork 모니터링 참조를 참조하세요.
OpenTelemetry를 사용하는 경우
OpenTelemetry는 기존 SIEM 및 관찰성 도구로 라우팅할 수 있는 구조화된 Cowork 이벤트의 실시간 스트림을 제공합니다. 보안 모니터링 및 사건 조사, 조직 전체의 도구 및 파일 액세스 패턴 추적, 비용 및 성능 분석, 기존 파이프라인에서 대시보드 및 경고 구축에 적합한 선택입니다.
호환 가능한 대상
Cowork의 OpenTelemetry 출력은 모든 표준 OTel 수집기와 호환됩니다. 일반적인 대상은 다음과 같습니다:
SIEM 플랫폼(예: Splunk 및 Cribl)
로그 집계 시스템(예: Elasticsearch 및 Loki)
칼럼형 저장소(예: ClickHouse)
관찰성 플랫폼(예: Honeycomb 및 Datadog)
수집기를 적절히 구성하여 여러 대상으로 동시에 이벤트를 라우팅할 수 있습니다.
OpenTelemetry 모니터링 설정
Cowork을 구성하여 이벤트를 수집기로 내보내려면:
Organization settings > Cowork으로 이동합니다.
OTLP 엔드포인트(OpenTelemetry 수집기 URL)를 입력합니다.
수집기가 사용하는 OTLP 프로토콜을 선택합니다: HTTP/JSON 또는 HTTP/protobuf.
인증에 필요한 OTLP 헤더(예: 베어러 토큰)를 추가합니다.
설정을 저장합니다.
이벤트는 즉시 수집기로 흐르기 시작합니다. 인증 헤더는 Anthropic 서버에서 저장 시 암호화됩니다.
보안 및 개인정보 보호 고려사항
OpenTelemetry 내보내기를 켜기 전에 알아야 할 몇 가지 사항:
프롬프트 텍스트, Claude의 응답 및 도구 입력은 현재 Claude Desktop 버전에서 기본적으로 꺼져 있습니다. 이벤트는
otlpContentCapture디바이스 정책으로 콘텐츠 캡처를 켜지 않으면 메타데이터만 포함합니다. 이 정책은 디바이스 관리 도구로 배포합니다. 이를 켜면 이벤트를 조직의 해당 콘텐츠 로깅 정책을 충족하는 수집기를 통해 라우팅합니다. Cowork 모니터링 참조의 콘텐츠 캡처에서 자세히 알아보세요.일부 이전 버전의 Claude Desktop은 정책이 설정되지 않으면 콘텐츠를 전송합니다. 해당 콘텐츠에는 프롬프트 텍스트, Claude의 응답 및 도구 입력이 포함될 수 있습니다. 이러한 버전은 업데이트되면 메타데이터만으로 전환됩니다. 정책을 지원하는 버전에서는
otlpContentCapture를 두 문자[]로 작성된 빈 목록으로 설정하여 그 전에 콘텐츠를 끌 수 있습니다.정책은 Claude Desktop에서 시작된 Cowork 세션에 적용되며, 사용자의 컴퓨터에서 실행되든 클라우드에서 실행되든 상관없습니다. 클라우드에서 실행되는 예약된 작업이나 채팅과 Cowork이 통합된 경우 Claude가 클라우드로 이동하는 채팅에는 적용되지 않습니다. 이러한 세션은 메타데이터만 포함합니다. 웹 또는 모바일 앱에서 시작된 Cowork 세션은 메타데이터만 포함하며 정책이 이를 변경하지 않습니다.
도구 매개변수에는 민감한 값이 포함될 수 있습니다. 콘텐츠 캡처에 도구 세부 정보가 포함된 경우 파일 경로, 명령 인수 및 기타 도구 입력은
tool_input및tool_parameters필드에서 내보내집니다. 보존 및 액세스 정책을 적절히 계획하세요.사용자 이메일 주소, 연결된 폴더의 경로 및 API 오류 메시지는 콘텐츠 캡처 설정과 관계없이 포함됩니다. API 오류 메시지는 때때로 이를 야기한 요청의 일부를 반복할 수 있으므로 필요한 경우 수집기에서 필터링하거나 수정하세요.
이벤트는 관리자가 OTLP 엔드포인트를 구성할 때만 내보내집니다. 기본적으로 데이터는 흐르지 않습니다.
OpenTelemetry 데이터를 Compliance API와 결합
Compliance API는 Claude 채팅과 함께 Cowork(Claude, Claude Desktop 및 Claude Mobile을 통해)과 Claude Code(CLI 및 Claude Desktop을 통해)를 포함하므로 모든 세션이 개별 사용자에게 귀속되는 하나의 감사 추적을 제공합니다. 이미 OpenTelemetry를 사용 중인 조직은 둘 다 병렬로 실행할 수 있으며 OTel 범위에는 웹 및 모바일의 Cowork도 포함됩니다. Compliance API에서 원격 세션 검색에서 자세히 알아보세요.