Repository navigation
v2.5.0 — API updates: per-product adoption, lighter audit traffic, admin-only archived names
English
This release follows the latest Claude Enterprise Analytics and Compliance API changes. It adds per-product adoption and skill/connector detail, cuts the dashboard's own Compliance traffic by about 90%, and makes audit file and artifact names archived before 2026-09-24 visible to administrators only.
Added
- Trends: active users by product (Claude Code, Chat, Cowork, Claude Design, Office Agents, Claude Science) with a DAU/WAU/MAU switch. The data comes from per-product fields the summaries endpoint already returns. Products an organization doesn't report are not drawn.
- Adoption:
- skill display names
- a skill usage and spend table: invocations, share status, estimated overage spend, attributed list-price value
- a connector tool-call table: read, write and unclassified calls, write share, managed-auth users
- a labeled
third-partyplugin bucket
- Cost: Office Agents and Claude in Slack labels.
Changed
- Audit:
- Risk and login classification now follows the Compliance API's activity types. Before this, the Login KPI counted nothing.
- All 11 actor kinds are identified instead of "unknown", including admin keys, service accounts, SCIM, federated identities and Anthropic access.
- File and artifact events explain that names are no longer returned (2026-09-24).
- Audit: live walks request 1000-event pages with the documented
last_idcursor, about 10× fewer Compliance requests and self-generated audit events. Past custom windows use a server-sidecreated_atrange and now show their events. - Audit archive: file and artifact names (and published-artifact descriptions) archived before 2026-09-24 are visible to administrators (the unmasked group) only. Archive queries and the chatbot read
compliance_daily_redactedviews for everyone else. The stored data is unchanged. - Collector: the daily audit archive fetches each UTC day as a bounded query, about 3 requests per day instead of 110–150 per run. It writes a day only once it is complete and no longer overwrites pre-2026-09-24 partitions that may still hold file names.
- Chatbot:
- Follow-up suggestions use structured output, and answers can run to 16k tokens.
- The cost tool no longer claims per-user cost is unavailable.
- Tool routing lives in the tool descriptions only.
- The compliance schema hint covers actor kinds, the name removal and what
*_viewedevents mean.
Fixed
- Summaries: the exclusive
ending_datewas sent as inclusive, so every window dropped its newest day and the 1d preset sent a zero-width range. - Archive-served days reported 0 for Claude Chat project counts. User rows are now read from the raw sidecar.
- Cost totals and the daily trend skipped code-execution spend (rows with no product and model). Its execution-span counts stay out of the request KPI.
- Users pagination stopped after the first page because engagement responses carry no
has_more. - Archive query and chatbot SQL error messages are now email-masked like result rows. Athena errors can quote row values.
- Spend limits: a $0 cap counts as at-limit, and each member keeps one row (monthly first) even if other periods appear.
Validation
- Server and structure checks: 94 passed (SQL sanitizer suite: 30 passed).
- Frontend regression tests: 144 passed.
- Desktop/mobile browser checks: 62 passed against the production build with synthetic API responses.
- Production (2026-09-26):
- Audit prewarm cold walk dropped from 56–60 s to about 6 s.
- Name-redacted Athena views return 0 file names, titles or artifact descriptions across 939,634 archived events. Row counts are unchanged.
- The new collector archived two days per organization in 3 pages each, with unchanged event counts.
한국어
최신 Claude Enterprise Analytics·Compliance API 변경을 반영한 릴리스입니다. 제품별 도입 현황과 스킬·커넥터 상세를 추가했고, 대시보드 자체의 Compliance 요청을 약 90% 줄였습니다. 2026-09-24 이전에 보관된 감사 파일·아티팩트 이름은 관리자만 볼 수 있게 했습니다.
추가
- 추세: 제품별 활성 사용자 차트를 추가했습니다(Claude Code, Chat, Cowork, Claude Design, Office Agents, Claude Science). DAU/WAU/MAU를 전환할 수 있고, summaries가 이미 주던 제품별 필드를 씁니다. 조직에 보고되지 않는 제품은 그리지 않습니다.
- 도입:
- 스킬 표시 이름
- 스킬 사용·지출 표: 호출 수, 공유 범위, 초과 지출 추정, 정가 가치
- 커넥터 도구 호출 표: 읽기·쓰기·미분류 호출, 쓰기 비중, 관리형 인증 사용자
third-party플러그인 집계 버킷 표시
- 비용: Office Agents, Claude in Slack 라벨을 추가했습니다.
변경
- 감사:
- 위험·로그인 분류가 Compliance API의 활동 타입을 따릅니다. 이전에는 로그인 KPI가 한 건도 세지 못했습니다.
- 행위자 11종을 'unknown' 대신 각각 식별합니다(admin 키, 서비스 계정, SCIM, 페더레이션, Anthropic 접근 등).
- 파일·아티팩트 이벤트에는 이름이 더 이상 제공되지 않는다는 안내를 표시합니다(2026-09-24).
- 감사 조회: 라이브 워크가 1000건 페이지와 문서화된
last_id커서를 씁니다. Compliance 요청과 자체 감사 이벤트가 약 10분의 1로 줄었습니다. 과거 사용자 지정 기간은 서버측created_at범위로 조회해서 해당 기간의 이벤트가 표시됩니다. - 감사 아카이브: 2026-09-24 이전에 보관된 파일·아티팩트 이름(게시된 아티팩트 설명 포함)은 관리자(unmasked 그룹)만 봅니다. 그 밖의 사용자는 아카이브 질의와 챗봇에서
compliance_daily_redacted뷰를 읽습니다. 저장된 데이터는 바꾸지 않았습니다. - collector: 일일 감사 아카이브를 UTC 하루씩 경계 쿼리로 받습니다. 요청이 실행당 110~150건에서 하루 약 3건으로 줄었습니다. 완결된 날짜만 쓰고, 파일 이름이 남아 있을 수 있는 2026-09-24 이전 파티션은 덮어쓰지 않습니다.
- 챗봇:
- 후속 질문 제안에 structured output을 쓰고, 답변 최대 길이를 16k 토큰으로 늘렸습니다.
- 비용 도구가 더 이상 사용자별 비용이 없다고 답하지 않습니다.
- 도구 선택 기준은 도구 설명에만 둡니다.
- compliance 스키마 힌트에 행위자 종류, 이름 제공 중단,
*_viewed이벤트의 의미를 반영했습니다.
수정
- summaries: 배타 경계인
ending_date를 포함 경계로 보내서, 모든 기간에서 최신일이 빠지고 1d 프리셋은 폭이 0인 요청이 되던 문제를 고쳤습니다. - 아카이브에서 서빙하는 날짜의 Claude Chat 프로젝트 수가 0으로 나오던 문제를 고쳤습니다. 이제 사용자 행을 raw 사이드카에서 읽습니다.
- 비용 합계와 일별 추세에서 코드 실행 비용(제품·모델이 없는 행)이 빠지던 문제를 고쳤습니다. 실행 구간 수는 요청 수 KPI에 넣지 않습니다.
- 사용자 목록 페이지네이션이 engagement 응답에
has_more가 없어 첫 페이지에서 멈추던 문제를 고쳤습니다. - 아카이브 질의와 챗봇 SQL의 오류 메시지도 결과 행처럼 이메일을 마스킹합니다. Athena 오류에는 행 값이 인용될 수 있습니다.
- 지출 한도: $0 한도를 한도 도달로 집계하고, 다른 기간의 한도 행이 와도 멤버마다 한 행(월 단위 우선)만 남깁니다.
검증
- 서버·구조 검사 94개 통과(SQL 검사기 30개 통과).
- 프런트엔드 회귀 테스트 144개 통과.
- 프로덕션 빌드와 합성 API 응답으로 데스크톱·모바일 브라우저 검사 62개 통과.
- 운영 확인(2026-09-26):
- 감사 prewarm의 콜드 워크가 56~60초에서 약 6초로 줄었습니다.
- 이름 가림 Athena 뷰에서 보관 이벤트 939,634건 전체에 파일명·제목·아티팩트 설명이 0건입니다. 행 수는 원본과 같습니다.
- 새 collector가 org별 이틀치를 날짜당 3페이지로 아카이브했고, 이벤트 수는 그대로였습니다.