감사 로그로 사용자 활동 추적하기

W&B 감사 로그를 사용하면 조직 내 사용자 활동을 추적하고 기업 거버넌스 요구 사항을 준수할 수 있습니다. 이 페이지는 W&B 배포 유형 전반에서 감사 로그 데이터에 액세스하고, 가져오고, 분석해야 하는 조직 수준 Admin을 위한 문서입니다. 감사 로그는 JSON 형식으로 제공됩니다. 자세한 내용은 감사 로그 스키마를 참고하세요. 감사 로그에 액세스하는 방법은 W&B Platform 배포 유형에 따라 다릅니다.

W&B Platform 배포 유형	감사 로그 액세스 방식
Dedicated Cloud	인스턴스 수준 BYOB: 10분마다 인스턴스 수준 버킷(BYOB)에 동기화됩니다. API로도 가져올 수 있습니다. 기본 인스턴스 수준 저장소: API로만 가져올 수 있습니다.
Multi-tenant Cloud	Enterprise 플랜에서만 사용할 수 있으며, API로만 가져올 수 있습니다.
Self-Managed	10분마다 인스턴스 수준 버킷에 동기화됩니다. API로도 가져올 수 있습니다.

감사 로그를 가져온 후에는 Pandas, Amazon Redshift, Google BigQuery, Microsoft Fabric 등의 도구로 분석할 수 있습니다. 일부 감사 로그 분석 도구는 JSON을 지원하지 않습니다. 분석 전에 JSON 형식의 감사 로그를 변환하는 데 필요한 지침과 요구 사항은 사용 중인 분석 도구의 문서를 참고하세요. 로그 형식에 대한 자세한 내용은 감사 로그 스키마 및 작업을 참고하세요.

감사 로그 보존

다음 권장 사항에 따라 감사 로그를 보존하면 조직의 거버넌스 및 규정 준수 의무를 충족할 수 있습니다.

감사 로그를 일정 기간 동안 보존해야 하는 경우, 저장소 버킷이나 Audit Logging API를 사용해 로그를 장기 저장소로 주기적으로 전송하는 것이 좋습니다.
1996년 건강보험 이전 및 책임에 관한 법률(HIPAA)의 적용을 받는 경우, 감사 로그를 최소 6년 동안 보존해야 하며, 의무 보존 기간이 끝나기 전까지 내부 또는 외부의 누구도 로그를 삭제하거나 수정할 수 없는 환경에 보관해야 합니다. BYOB를 사용하는 HIPAA 준수 Dedicated Cloud 인스턴스의 경우, 장기 보존용 저장소를 포함한 모든 관리형 저장소에 가드레일을 설정해야 합니다.

감사 로그 스키마

이 스키마를 참고하여 각 감사 로그 항목에 반환되는 필드를 해석하세요. 다음 표는 감사 로그 항목에 나타날 수 있는 모든 키를 알파벳순으로 정리한 것입니다. 액션과 상황에 따라 특정 로그 항목에는 전체 필드 중 일부만 포함될 수 있습니다.

키	정의
`action`	이벤트의 액션입니다.
`actor_email`	액션을 시작한 사용자의 이메일 주소입니다(해당하는 경우).
`actor_ip`	액션을 시작한 사용자의 IP 주소입니다.
`actor_user_id`	액션을 수행한 로그인 사용자의 ID입니다(해당하는 경우).
`artifact_asset`	액션과 연결된 아티팩트 ID입니다(해당하는 경우).
`artifact_digest`	액션과 연결된 아티팩트 다이제스트입니다(해당하는 경우).
`artifact_qualified_name`	액션과 연결된 아티팩트의 전체 이름입니다(해당하는 경우).
`artifact_sequence_asset`	액션과 연결된 아티팩트 시퀀스 ID입니다(해당하는 경우).
`cli_version`	액션을 시작한 Python SDK의 버전입니다(해당하는 경우).
`entity_asset`	액션과 연결된 entity 또는 팀 ID입니다(해당하는 경우).
`entity_name`	액션과 연결된 entity 또는 팀 이름입니다(해당하는 경우).
`project_asset`	액션과 연결된 프로젝트입니다(해당하는 경우).
`project_name`	액션과 연결된 프로젝트의 이름입니다(해당하는 경우).
`report_asset`	액션과 연결된 리포트 ID입니다(해당하는 경우).
`report_name`	액션과 연결된 리포트의 이름입니다(해당하는 경우).
`response_code`	액션에 대한 HTTP 응답 코드입니다(해당하는 경우).
`timestamp`	RFC3339 형식으로 표시된 이벤트 발생 시각입니다. 예를 들어 `2023-01-23T12:34:56Z`는 2023년 1월 23일 12:34:56 UTC를 나타냅니다.
`user_asset`	액션을 수행한 사용자가 아니라, 액션의 영향을 받는 사용자 에셋입니다(해당하는 경우).
`user_email`	액션을 수행한 사용자가 아니라, 액션의 영향을 받는 사용자의 이메일 주소입니다(해당하는 경우).

개인 식별 정보(PII)

이메일 주소와 프로젝트, 팀, 리포트 이름 같은 개인 식별 정보(PII)는 API 엔드포인트 옵션에서만 사용할 수 있습니다.

Self-Managed 및 Dedicated Cloud에서는 조직 관리자가 감사 로그를 가져올 때 PII를 제외할 수 있습니다.
Multi-tenant Cloud에서는 API 엔드포인트가 PII를 포함한 감사 로그의 관련 필드를 항상 반환하며, 이 동작은 변경할 수 없습니다.

시작하기 전에

감사 로그를 가져오기 전에 배포 유형별로 다음 사전 요구 사항을 충족하는지 확인하세요.

감사 로그는 조직 수준 Admin이 가져올 수 있습니다. 403 오류가 발생하면 본인 또는 서비스 계정에 적절한 권한이 있는지 확인하세요.
Multi-tenant Cloud: 여러 Multi-tenant Cloud 조직에 속해 있다면 Default API organization을 설정해야 합니다. 이 설정에 따라 감사 로깅 API 호출이 라우팅될 조직이 결정됩니다. 설정하지 않으면 다음 오류가 발생합니다.
user is associated with multiple organizations but no valid org ID found in user info
기본 API 조직을 지정하려면 다음을 수행하세요.
1. 프로필 이미지를 클릭한 다음 User Settings를 클릭하세요.
2. Default API organization에서 조직을 선택하세요.
서비스 계정은 하나의 Multi-tenant Cloud 조직에만 속할 수 있으므로 이 설정이 적용되지 않습니다.

감사 로그 가져오기

W&B Audit Logging API를 사용하여 감사 로그를 조회하세요. 엔드포인트, 쿼리 매개변수, 응답 형식은 배포 유형에 따라 달라집니다.

Multi-tenant Cloud
Dedicated Cloud 및 Self-Managed

Multi-tenant Cloud를 사용하는 경우 이 탭을 참고하세요. Multi-tenant 감사 로그는 Enterprise 플랜에서만 사용 가능합니다. Audit Logging API 엔드포인트는 다음과 같습니다.

https://api.wandb.ai/audit_logs

다음 쿼리 매개변수를 지원합니다.

startDate: 날짜 범위의 첫 번째 날짜(UTC 기준)입니다. YYYY-MM-DD 형식을 사용하세요. startDate를 생략하면 범위는 오늘 UTC 자정부터 시작하며, numDays를 설정한 경우에는 오늘로부터 numDays일 전부터 시작합니다.
numDays: 0부터 7까지의 정수입니다. W&B는 startDate부터 이후 numDays일 동안의 로그를 가져옵니다. numDays를 생략하거나 0으로 설정하면 W&B는 하루치 로그를 가져옵니다.
limit: 반환할 감사 로그 항목의 최대 개수입니다. 1,000,000 이하의 양의 정수를 사용하세요. 기본값은 1,000,000입니다.
cursor: 이전 응답의 next_cursor 필드에서 가져온 불투명 커서입니다. 커서는 확정된 날짜 범위가 동일할 때만 재사용하세요.

Multi-tenant Cloud 엔드포인트는 PII를 포함하여 감사 로그 관련 필드를 항상 반환합니다. 이 동작은 설정으로 변경할 수 없습니다.응답은 다음 필드를 포함하는 JSON 객체입니다.

audit_logs: 감사 로그 항목의 배열입니다. 각 항목에는 Audit log schema에 설명된 필드가 포함됩니다.
range_start_time: 확정된 날짜 범위의 시작 시각(UTC)입니다.
range_end_time: 확정된 날짜 범위의 종료 시각(UTC, 해당 시각은 포함되지 않음)입니다.
count: 이 응답에서 반환된 감사 로그 항목의 개수입니다.
next_cursor: 다음 결과 페이지를 가져오기 위한 불투명 커서입니다. 이 필드가 null이면 선택한 날짜 범위에 더 이상 결과가 없습니다.

다음 예시에서 아래 값을 바꾸세요.

[BASE64-USERNAME-API-KEY]: [USERNAME]:[API-KEY] 형식을 base64로 인코딩한 문자열입니다.
[NEXT-CURSOR]: 이전 응답의 next_cursor 값입니다.

특정 범위의 감사 로그를 가져오려면 다음을 실행하세요.

curl -H "Authorization: Basic [BASE64-USERNAME-API-KEY]" \
  "https://api.wandb.ai/audit_logs?startDate=2026-08-01&numDays=2&limit=1000"

응답은 다음 예시와 비슷합니다.

{
  "audit_logs": [
    {
      "action": "project:read",
      "actor_email": "admin@example.com",
      ...
      "timestamp": "2026-08-01T13:12:14Z"
    }
  ],
  "range_start_time": "2026-08-01T00:00:00Z",
  "range_end_time": "2026-08-04T00:00:00Z",
  "count": 1,
  "next_cursor": "eyJyb3dfa2V5Ijoi..."
}

다음 페이지를 가져오려면 앞서 확정된 것과 동일한 날짜 범위로 요청을 다시 보내세요. 이때 cursor를 이전 응답의 next_cursor 값으로 설정하세요. next_cursor가 null이 될 때까지 이 과정을 반복하세요.

curl -H "Authorization: Basic [BASE64-USERNAME-API-KEY]" \
  "https://api.wandb.ai/audit_logs?startDate=2026-08-01&numDays=2&limit=1000&cursor=[NEXT-CURSOR]"

1: Multi-tenant Cloud에서는 다음 항목에 대한 감사 로그가 수집되지 않습니다.

Open 또는 Public 프로젝트
report:read 액션
특정 조직과 연결되지 않은 User 액션

Dedicated Cloud 또는 Self-Managed 인스턴스를 사용하는 경우 이 탭을 참고하세요. Audit Logging API 엔드포인트는 인스턴스 URL을 기반으로 합니다.

Dedicated Cloud: https://[INSTANCE-NAME].wandb.io/admin/audit_logs.
Self-Managed: https://[WANDB-PLATFORM-URL]/admin/audit_logs.

다음 예시에서 아래 항목을 바꾸세요.

[INSTANCE-NAME]: 사용 중인 Dedicated Cloud 인스턴스의 이름입니다.
[WANDB-PLATFORM-URL]: 사용 중인 Self-Managed 인스턴스의 URL입니다.
[API-ENDPOINT]: 인스턴스의 엔드포인트입니다.
[BASE64-USERNAME-API-KEY]: [USERNAME]:[API-KEY] 형식의 문자열을 base64로 인코딩한 값입니다.
[NEXT-CURSOR]: 이전 응답의 next_cursor 값입니다.

다음 쿼리 매개변수를 지원합니다.

anonymize: URL에 anonymize=true가 포함되어 있으면 W&B는 감사 로그에 PII 필드를 추가하지 않습니다. 그렇지 않으면 PII가 포함됩니다. 자세한 내용은 감사 로그를 가져올 때 PII 제외를 참조하세요.
startDate: UTC 기준 날짜 범위의 시작 시점(포함)입니다. 지원되는 형식은 YYYY-MM-DD, YYYY-MM-DDTHH, YYYY-MM-DDTHH:mm, YYYY-MM-DDTHH:mm:ss입니다. 생략된 시간 부분은 기본값 0으로 처리됩니다. 예를 들어 2026-08-03T01은 2026-08-03T01:00:00Z를 의미합니다. startDate를 생략하면 범위는 오늘 UTC 자정부터 시작하며, numDays를 설정한 경우에는 오늘로부터 numDays일 전부터 시작합니다.
numDays: 음이 아닌 정수입니다. W&B는 startDate부터 이후 numDays일 동안의 로그를 가져옵니다. numDays를 생략하거나 0으로 설정하면 W&B는 startDate 당일의 로그만 가져옵니다. numDays는 endDate와 함께 사용할 수 없습니다.
endDate: UTC 기준 날짜 범위의 종료 시점(미포함)입니다. 지원되는 형식은 startDate와 같습니다. endDate를 설정하면 limit를 설정하지 않아도 페이지 매김된 JSON 응답이 반환됩니다. endDate는 numDays와 함께 사용할 수 없습니다.
limit: 페이지 매김된 응답에서 반환할 감사 로그 항목의 최대 개수입니다. 20,000 이하의 양의 정수를 지정하세요. limit를 설정하면 W&B는 페이지 매김된 JSON 응답을 반환합니다. 페이지 매김 요청의 기본값은 20,000입니다.
cursor: 이전 응답의 next_cursor 필드에서 받은 불투명(opaque) 커서입니다. 커서를 재사용할 때는 처음과 동일하게 확정된 날짜 범위와 anonymize 값을 사용하세요. cursor를 설정하는 경우 limit 또는 endDate도 함께 설정해야 합니다.

limit 또는 endDate를 설정하지 않으면 API는 기존 스트리밍 응답 형식을 그대로 유지합니다. 응답은 줄바꿈으로 구분된 JSON 객체로 구성됩니다. 각 객체에는 인스턴스 수준 버킷에 동기화된 로그와 동일하게 Audit log schema에 설명된 필드가 포함됩니다.PII를 제외하고 3일 동안의 로그를 줄바꿈으로 구분된 JSON 스트리밍 응답으로 가져오려면 다음 명령을 실행하세요.

curl -H "Authorization: Basic [BASE64-USERNAME-API-KEY]" \
  "[API-ENDPOINT]?startDate=2026-08-01&numDays=2&anonymize=true"

limit 또는 endDate를 설정하면 API는 다음 필드가 포함된 JSON 객체를 반환합니다.

audit_logs: 감사 로그 항목의 배열입니다. 각 항목에는 Audit log schema에 설명된 필드가 포함됩니다.
range_start_time: 확정된 날짜 범위의 시작 시각(UTC)입니다.
range_end_time: 확정된 날짜 범위의 종료 시각(UTC, 해당 시각은 포함되지 않음)입니다.
count: 이 응답에서 반환된 감사 로그 항목의 개수입니다.
next_cursor: 다음 결과 페이지를 가져오기 위한 불투명 커서입니다. 이 필드가 null이면 선택한 날짜 범위에 더 이상 결과가 없습니다.

2시간 범위의 응답을 페이지 매김 방식으로 가져오려면 다음 명령을 실행하세요.

curl -H "Authorization: Basic [BASE64-USERNAME-API-KEY]" \
  "[API-ENDPOINT]?startDate=2026-08-01T13:00&endDate=2026-08-01T15:00&limit=1000"

응답은 다음 예시와 비슷합니다.

{
  "audit_logs": [
    {
      "action": "project:read",
      "actor_email": "admin@example.com",
      ...
      "timestamp": "2026-08-01T14:00:00Z",
    }
  ],
  "range_start_time": "2026-08-01T13:00:00Z",
  "range_end_time": "2026-08-01T15:00:00Z",
  "count": 1,
  "next_cursor": "eyJ2ZXJzaW9uIjox..."
}

다음 페이지를 가져오려면 앞서 확정된 날짜 범위와 anonymize 값을 그대로 사용하여 요청을 다시 보내세요. 이때 cursor는 이전 응답의 next_cursor 값으로 설정합니다. next_cursor가 null이 될 때까지 이 과정을 반복하세요.

curl -H "Authorization: Basic [BASE64-USERNAME-API-KEY]" \
  "[API-ENDPOINT]?startDate=2026-08-01T13:00&endDate=2026-08-01T15:00&limit=1000&cursor=[NEXT-CURSOR]"

감사 로그를 가져올 때 PII 제외하기

Self-Managed 및 Dedicated Cloud에서는 W&B 조직 관리자 또는 인스턴스 관리자가 감사 로그를 가져올 때 PII를 제외할 수 있습니다. Multi-tenant Cloud에서는 API 엔드포인트가 PII를 포함한 감사 로그의 관련 필드를 항상 반환하며, 이 동작은 변경할 수 없습니다.PII를 제외하려면 anonymize=true URL 매개변수를 전달하세요. 예를 들어 W&B 인스턴스 URL이 https://mycompany.wandb.io이고, 지난 1주일간의 사용자 활동 감사 로그를 PII 없이 조회하려면 다음과 같은 API 엔드포인트를 사용하세요.

https://mycompany.wandb.io/admin/audit_logs?anonymize=true&[ADDITIONAL-PARAMETERS].

기본 인증 사용하기

감사 로그 API에 보내는 모든 요청은 인증을 거쳐야 합니다. API 키로 기본 인증을 사용해 감사 로그 API에 액세스하려면 HTTP 요청의 Authorization 헤더 값을 문자열 Basic, 공백 한 칸, 그리고 [USERNAME]:[API-KEY] 형식의 문자열을 base64로 인코딩한 값을 차례로 이어 붙여 설정하세요. 즉, 사용자 이름과 API 키를 실제 값으로 바꾸고 : 문자로 구분한 다음, 그 결과를 base64로 인코딩하면 됩니다. 예를 들어 demo:p@55w0rd로 인증하려면 헤더를 Authorization: Basic ZGVtbzpwQDU1dzByZA==로 설정하세요.

작업

각 감사 로그 항목에는 다음 액션 중 하나가 기록됩니다. 로그 항목의 action 필드를 해석할 때 이 레퍼런스를 참고하세요. 다음 표는 W&B가 기록할 수 있는 액션을 알파벳순으로 정리한 것입니다.

액션	정의
`artifact:create`	아티팩트가 생성됩니다.
`artifact:delete`	아티팩트가 삭제됩니다.
`artifact:read`	아티팩트가 조회됩니다.
`project:delete`	프로젝트가 삭제됩니다.
`organization:update_member`	멤버의 조직 역할 또는 시트가 업데이트됩니다.
`project:read`	프로젝트가 조회됩니다.
`report:read`	리포트가 조회됩니다. ¹
`run:delete_many`	여러 run이 일괄 삭제됩니다.
`run:delete`	run이 삭제됩니다.
`run:stop`	run이 중단됩니다.
`run:undelete_many`	여러 run이 휴지통에서 일괄 복원됩니다.
`run:update_many`	여러 run이 일괄 업데이트됩니다.
`run:update`	run이 업데이트됩니다.
`sweep:create_agent`	스윕 에이전트가 생성됩니다.
`team:create_service_account`	팀의 서비스 계정이 생성됩니다.
`team:create`	팀이 생성됩니다.
`team:delete`	팀이 삭제됩니다.
`team:invite_user`	사용자가 팀에 초대됩니다.
`team:uninvite`	사용자 또는 서비스 계정의 팀 초대가 취소됩니다.
`user:create_api_key`	사용자 또는 서비스 계정의 API 키가 생성됩니다. ¹
`user:create`	사용자가 생성됩니다. ¹
`user:deactivate`	사용자가 비활성화됩니다. ¹
`user:delete_api_key`	사용자 또는 서비스 계정의 API 키가 삭제됩니다. ¹
`user:initiate_login`	사용자가 로그인을 시작합니다. ¹
`user:login`	사용자가 로그인합니다. ¹
`user:logout`	사용자가 로그아웃합니다. ¹
`user:permanently_delete`	사용자가 영구 삭제됩니다. ¹
`user:reactivate`	사용자가 다시 활성화됩니다. ¹
`user:read`	사용자 프로필이 조회됩니다. ¹
`user:update`	사용자 정보가 업데이트됩니다. ¹

​감사 로그 보존

​감사 로그 스키마

​개인 식별 정보(PII)

​시작하기 전에

​감사 로그 가져오기

​감사 로그를 가져올 때 PII 제외하기

​기본 인증 사용하기

​작업