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

W&B 감사 로그를 사용하면 조직 내 사용자 활동을 추적하고 엔터프라이즈 거버넌스 요구 사항을 충족할 수 있습니다. 이 페이지는 W&B 배포 유형 전반에서 감사 로그 데이터에 액세스하고, 가져오고, 분석해야 하는 조직 수준 관리자용입니다. 감사 로그는 JSON 형식으로 사용 가능합니다. 감사 로그 스키마를 참고하세요. 감사 로그에 액세스하는 방법은 W&B 플랫폼 배포 유형에 따라 다릅니다.

W&B 플랫폼 배포 유형	감사 로그 액세스 방식
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 형식의 감사 로그를 변환하기 위한 지침과 요구 사항은 사용하는 분석 도구의 문서를 참고하세요. 로그 형식에 대한 자세한 내용은 감사 로그 스키마 및 작업을 참고하세요.

감사 로그 보존

다음 권장 사항은 조직의 거버넌스 및 규정 준수 의무를 충족할 수 있도록 감사 로그를 보존하는 데 도움이 됩니다.

감사 로그를 특정 기간 동안 보존해야 하는 경우, W&B는 저장소 버킷 또는 Audit Logging API를 사용해 로그를 장기 저장소로 주기적으로 전송할 것을 권장합니다.
Health Insurance Portability and Accountability Act of 1996 (HIPAA)의 적용을 받는 경우, 감사 로그는 의무 보존 기간이 끝나기 전에 내부 또는 외부의 어떤 주체도 삭제하거나 수정할 수 없는 환경에서 최소 6년 동안 보존되어야 합니다. BYOB를 사용하는 HIPAA 준수 Dedicated Cloud 인스턴스의 경우, 장기 보존 저장소를 포함한 관리형 저장소에 대해 가드레일을 구성해야 합니다.

감사 로그 스키마

각 감사 로그 항목에서 반환되는 필드를 해석하려면 이 스키마를 사용하세요. 다음 표는 감사 로그 항목에 나타날 수 있는 모든 키를 알파벳순으로 보여 줍니다. action 및 상황에 따라 특정 로그 항목에는 가능한 필드 중 일부만 포함될 수 있습니다.

Key	정의
`action`	이벤트의 action입니다.
`actor_email`	해당하는 경우, action을 시작한 사용자의 이메일 주소입니다.
`actor_ip`	action을 시작한 사용자의 IP 주소입니다.
`actor_user_id`	해당하는 경우, action을 수행한 로그인된 사용자의 ID입니다.
`artifact_asset`	해당하는 경우, action과 연결된 artifact ID입니다.
`artifact_digest`	해당하는 경우, action과 연결된 artifact digest입니다.
`artifact_qualified_name`	해당하는 경우, action과 연결된 artifact의 전체 이름입니다.
`artifact_sequence_asset`	해당하는 경우, action과 연결된 artifact sequence ID입니다.
`cli_version`	해당하는 경우, action을 시작한 Python SDK의 버전입니다.
`entity_asset`	해당하는 경우, action과 연결된 entity 또는 팀 ID입니다.
`entity_name`	해당하는 경우, action과 연결된 entity 또는 팀 이름입니다.
`project_asset`	해당하는 경우, action과 연결된 프로젝트입니다.
`project_name`	해당하는 경우, action과 연결된 프로젝트 이름입니다.
`report_asset`	해당하는 경우, action과 연결된 리포트 ID입니다.
`report_name`	해당하는 경우, action과 연결된 리포트 이름입니다.
`response_code`	해당하는 경우, action의 HTTP 응답 코드입니다.
`timestamp`	RFC3339 format의 이벤트 시간입니다. 예를 들어 `2023-01-23T12:34:56Z`는 UTC 기준 2023년 1월 23일 12:34:56을 나타냅니다.
`user_asset`	해당하는 경우, action을 수행한 사용자가 아니라 action의 영향을 받는 사용자 asset입니다.
`user_email`	해당하는 경우, action을 수행한 사용자의 이메일 주소가 아니라 action의 영향을 받는 사용자의 이메일 주소입니다.

개인 식별 정보 (PII)

이메일 주소, Projects, Teams, Reports의 이름과 같은 개인 식별 정보(PII)는 API 엔드포인트 옵션을 통해서만 확인할 수 있습니다:

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

시작하기 전에

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

조직 수준 관리자는 감사 로그를 가져올 수 있습니다. 403 오류가 발생하면 본인 또는 서비스 계정에 충분한 권한이 있는지 확인하세요.
Multi-tenant Cloud: 여러 Multi-tenant Cloud 조직의 멤버인 경우, 감사 로그 API 호출이 라우팅될 대상을 결정하는 Default API organization을 반드시 구성해야 합니다. 그렇지 않으면 다음 오류가 발생합니다:
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를 사용하여 감사 로그를 가져오세요. 엔드포인트, 쿼리 파라미터, 응답 형식은 배포 유형에 따라 다릅니다.

Dedicated Cloud 또는 Self-Managed
Multi-tenant Cloud

Dedicated Cloud 또는 Self-Managed 인스턴스를 사용하는 경우 이 탭을 참조하세요. Audit Logging API endpoint는 인스턴스 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 인코딩된 string입니다.
[NEXT-CURSOR]: 이전 응답의 next_cursor 값입니다.

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

anonymize: URL에 anonymize=true가 포함되어 있으면 W&B는 audit logs에 PII 필드를 추가하지 않습니다. 포함되어 있지 않으면 PII가 포함됩니다. 자세한 내용은 audit logs를 가져올 때 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: 0 이상의 정수입니다. W&B는 startDate부터 이후 numDays일까지의 로그를 가져옵니다. numDays를 생략하거나 0으로 설정하면 startDate 당일의 로그만 가져옵니다. numDays는 endDate와 함께 사용할 수 없습니다.
endDate: UTC 기준 날짜 범위의 종료 시점(제외)입니다. 지원되는 형식은 startDate와 동일합니다. endDate를 설정하면 limit을 설정하지 않아도 페이지 매김된 JSON 응답이 반환됩니다. endDate는 numDays와 함께 사용할 수 없습니다.
limit: 페이지 매김된 응답에서 반환할 audit log 항목의 최대 개수입니다. 20,000 이하의 양의 정수를 사용하세요. limit을 설정하면 W&B는 페이지 매김된 JSON 응답을 반환합니다. 페이지 매김 요청에서 기본값은 20,000입니다.
cursor: 이전 응답의 next_cursor 필드에서 받은 불투명(opaque) 커서입니다. 커서는 동일하게 해석된 날짜 범위와 동일한 anonymize 값으로 재사용하세요. cursor를 설정하는 경우 limit 또는 endDate도 함께 설정해야 합니다.

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

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: 다음 결과 페이지를 가리키는 불투명(opaque) 커서입니다. 이 필드가 null이면 선택한 날짜 범위에 더 이상 결과가 없습니다.

두 시간 범위에 대해 페이지 매김된 응답을 가져오려면 다음을 실행하세요.

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]"

audit log을 가져올 때 PII 제외하기

Self-Managed 및 Dedicated Cloud에서는 W&B 조직 또는 instance admin이 audit logs를 가져올 때 PII를 제외할 수 있습니다. Multi-tenant Cloud에서는 API endpoint가 PII를 포함한 audit logs의 관련 필드를 항상 반환하며, 이 동작은 변경할 수 없습니다.PII를 제외하려면 anonymize=true URL 파라미터를 전달하세요. 예를 들어 최근 일주일간의 사용자 활동에 대한 audit logs를 PII 없이 조회하려면, W&B 인스턴스 URL이 https://mycompany.wandb.io인 경우 다음과 같은 API endpoint를 사용하세요:

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

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

https://api.wandb.ai/audit_logs

지원되는 쿼리 파라미터는 다음과 같습니다.

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

Multi-tenant Cloud 엔드포인트는 PII를 포함하여 감사 로그와 관련된 필드를 항상 반환하며, 이 동작은 설정할 수 없습니다.응답은 다음 필드로 구성된 JSON 오브젝트입니다.

audit_logs: 감사 로그 항목의 배열입니다. 각 항목에는 Audit log schema에 설명된 필드가 포함됩니다.
range_start_time: 확정된 날짜 범위의 시작 시각(UTC)입니다.
range_end_time: 확정된 날짜 범위의 종료 시각(UTC, 해당 시각 미포함)입니다.
count: 이 응답에서 반환된 감사 로그 항목의 개수입니다.
next_cursor: 다음 결과 페이지를 가리키는 불투명(opaque) 커서입니다. 이 필드가 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..."
}

다음 페이지를 가져오려면 동일하게 확정된 date range로 요청을 다시 보내세요. 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에서는 다음에 대해 audit logs가 수집되지 않습니다.

Open 또는 Public projects
report:read 액션
특정 조직에 연결되지 않은 User 작업

기본 인증 사용

감사 로그 API에 대한 각 요청은 반드시 인증해야 합니다. API 키로 감사 로그 API에 액세스하기 위해 기본 인증을 사용하려면 HTTP 요청의 Authorization 헤더를 Basic 문자열 뒤에 공백 하나와 [USERNAME]:[API-KEY] 형식의 base64 인코딩 문자열이 오도록 설정합니다. 즉, 사용자 이름과 API 키를 : 문자로 구분해 실제 값으로 바꾼 다음 그 결과를 base64로 인코딩합니다. 예를 들어 demo:p@55w0rd로 인증하려면 헤더를 Authorization: Basic ZGVtbzpwQDU1dzByZA==로 설정합니다.

작업

각 감사 로그 항목에는 다음 작업 중 하나가 기록됩니다. 이 레퍼런스를 사용하여 로그 항목의 action 필드를 해석하세요. 다음 표는 W&B에서 기록할 수 있는 작업을 알파벳순으로 설명합니다.

Action	Definition
`artifact:create`	Artifact가 생성됩니다.
`artifact:delete`	Artifact가 삭제됩니다.
`artifact:read`	Artifact가 조회됩니다.
`project:delete`	프로젝트가 삭제됩니다.
`organization:update_member`	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`	sweep 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`	사용자가 업데이트됩니다. ¹

Weights & Biases

CoreWeave 제공

플랫폼 정보

리소스

감사 로그 보존

감사 로그 스키마

개인 식별 정보 (PII)

시작하기 전에

감사 로그 가져오기

audit log을 가져올 때 PII 제외하기

기본 인증 사용

작업

​감사 로그 보존

​감사 로그 스키마

​개인 식별 정보 (PII)

​시작하기 전에

​감사 로그 가져오기

​audit log을 가져올 때 PII 제외하기

​기본 인증 사용

​작업

감사 로그 보존

감사 로그 스키마

개인 식별 정보 (PII)

시작하기 전에

감사 로그 가져오기

audit log을 가져올 때 PII 제외하기

기본 인증 사용

작업