> ## Documentation Index > Fetch the complete documentation index at: https://docs.coreweave.com/llms.txt > Use this file to discover all available pages before exploring further. # 감사 로그로 사용자 활동 추적하기 > 배포 유형별로 W&B 감사 로그에 액세스하고, 가져오고, 분석하는 방법과 로그 스키마 및 추적되는 작업을 알아보세요. W\&B 감사 로그를 사용하면 조직 내 사용자 활동을 추적하고 기업 거버넌스 요구 사항을 준수할 수 있습니다. 이 페이지는 W\&B 배포 유형 전반에서 감사 로그 데이터에 액세스하고, 가져오고, 분석해야 하는 조직 수준 Admin을 위한 문서입니다. 감사 로그는 JSON 형식으로 제공됩니다. 자세한 내용은 [감사 로그 스키마](#audit-log-schema)를 참고하세요. 감사 로그에 액세스하는 방법은 W\&B Platform 배포 유형에 따라 다릅니다. | W\&B Platform 배포 유형 | 감사 로그 액세스 방식 | | - | - | | [Dedicated Cloud](/ko/products/wandb/platform/hosting/hosting-options/dedicated-cloud) | | | [Multi-tenant Cloud](/ko/products/wandb/platform/hosting/hosting-options/multi_tenant_cloud) | Enterprise 플랜에서만 사용할 수 있으며, [API](#fetch-audit-logs)로만 가져올 수 있습니다. | | [Self-Managed](/ko/products/wandb/platform/hosting/hosting-options/self-managed) | 10분마다 인스턴스 수준 버킷에 동기화됩니다. [API](#fetch-audit-logs)로도 가져올 수 있습니다. | 감사 로그를 가져온 후에는 [Pandas](https://pandas.pydata.org/docs/index.html), [Amazon Redshift](https://aws.amazon.com/redshift/), [Google BigQuery](https://cloud.google.com/bigquery), [Microsoft Fabric](https://www.microsoft.com/microsoft-fabric) 등의 도구로 분석할 수 있습니다. 일부 감사 로그 분석 도구는 JSON을 지원하지 않습니다. 분석 전에 JSON 형식의 감사 로그를 변환하는 데 필요한 지침과 요구 사항은 사용 중인 분석 도구의 문서를 참고하세요. 로그 형식에 대한 자세한 내용은 [감사 로그 스키마](#audit-log-schema) 및 [작업](#actions)을 참고하세요.

감사 로그 보존

다음 권장 사항에 따라 감사 로그를 보존하면 조직의 거버넌스 및 규정 준수 의무를 충족할 수 있습니다. * 감사 로그를 일정 기간 동안 보존해야 하는 경우, 저장소 버킷이나 Audit Logging API를 사용해 로그를 장기 저장소로 주기적으로 전송하는 것이 좋습니다. * [1996년 건강보험 이전 및 책임에 관한 법률(HIPAA)](https://hhs.gov/hipaa/for-professionals/index.html)의 적용을 받는 경우, 감사 로그를 최소 6년 동안 보존해야 하며, 의무 보존 기간이 끝나기 전까지 내부 또는 외부의 누구도 로그를 삭제하거나 수정할 수 없는 환경에 보관해야 합니다. [BYOB](/ko/products/wandb/platform/hosting/data-security/secure-storage-connector)를 사용하는 HIPAA 준수 [Dedicated Cloud](/ko/products/wandb/platform/hosting/hosting-options/dedicated-cloud) 인스턴스의 경우, 장기 보존용 저장소를 포함한 모든 관리형 저장소에 가드레일을 설정해야 합니다.

감사 로그 스키마

이 스키마를 참고하여 각 감사 로그 항목에 반환되는 필드를 해석하세요. 다음 표는 감사 로그 항목에 나타날 수 있는 모든 키를 알파벳순으로 정리한 것입니다. 액션과 상황에 따라 특정 로그 항목에는 전체 필드 중 일부만 포함될 수 있습니다. | 키 | 정의 | | - | - | | `action` | 이벤트의 [액션](#actions)입니다. | | `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 형식](https://www.rfc-editor.org/rfc/rfc3339)으로 표시된 이벤트 발생 시각입니다. 예를 들어 `2023-01-23T12:34:56Z`는 2023년 1월 23일 12:34:56 UTC를 나타냅니다. | | `user_asset` | 액션을 수행한 사용자가 아니라, 액션의 영향을 받는 사용자 에셋입니다(해당하는 경우). | | `user_email` | 액션을 수행한 사용자가 아니라, 액션의 영향을 받는 사용자의 이메일 주소입니다(해당하는 경우). |

개인 식별 정보(PII)

이메일 주소와 프로젝트, 팀, 리포트 이름 같은 개인 식별 정보(PII)는 API 엔드포인트 옵션에서만 사용할 수 있습니다. * [Self-Managed](/ko/products/wandb/platform/hosting/hosting-options/self-managed) 및 [Dedicated Cloud](/ko/products/wandb/platform/hosting/hosting-options/dedicated-cloud)에서는 조직 관리자가 감사 로그를 가져올 때 [PII를 제외](#exclude-pii)할 수 있습니다. * [Multi-tenant Cloud](/ko/products/wandb/platform/hosting/hosting-options/multi_tenant_cloud)에서는 API 엔드포인트가 PII를 포함한 감사 로그의 관련 필드를 항상 반환하며, 이 동작은 변경할 수 없습니다.

시작하기 전에

감사 로그를 가져오기 전에 배포 유형별로 다음 사전 요구 사항을 충족하는지 확인하세요. * 감사 로그는 조직 수준 Admin이 가져올 수 있습니다. `403` 오류가 발생하면 본인 또는 서비스 계정에 적절한 권한이 있는지 확인하세요. * **Multi-tenant Cloud**: 여러 Multi-tenant Cloud 조직에 속해 있다면 **Default API organization**을 설정해야 합니다. 이 설정에 따라 감사 로깅 API 호출이 라우팅될 조직이 결정됩니다. 설정하지 않으면 다음 오류가 발생합니다. ```text theme={"system"} 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](/ko/products/wandb/platform/hosting/hosting-options/multi_tenant_cloud)를 사용하는 경우 이 탭을 참고하세요. Multi-tenant 감사 로그는 Enterprise 플랜에서만 사용 가능합니다. Audit Logging API 엔드포인트는 다음과 같습니다. ```text theme={"system"} 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](#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` 값입니다. 특정 범위의 감사 로그를 가져오려면 다음을 실행하세요. ```bash theme={"system"} curl -H "Authorization: Basic [BASE64-USERNAME-API-KEY]" \ "https://api.wandb.ai/audit_logs?startDate=2026-08-01&numDays=2&limit=1000" ``` 응답은 다음 예시와 비슷합니다. ```json theme={"system"} { "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`이 될 때까지 이 과정을 반복하세요. ```bash theme={"system"} 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](/ko/products/wandb/platform/hosting/hosting-options/multi_tenant_cloud)에서는 다음 항목에 대한 감사 로그가 수집되지 않습니다. * Open 또는 Public 프로젝트 * `report:read` 액션 * 특정 조직과 연결되지 않은 `User` 액션 [Dedicated Cloud](/ko/products/wandb/platform/hosting/hosting-options/dedicated-cloud) 또는 [Self-Managed](/ko/products/wandb/platform/hosting/hosting-options/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 제외](#exclude-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](#audit-log-schema)에 설명된 필드가 포함됩니다. PII를 제외하고 3일 동안의 로그를 줄바꿈으로 구분된 JSON 스트리밍 응답으로 가져오려면 다음 명령을 실행하세요. ```bash theme={"system"} 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](#audit-log-schema)에 설명된 필드가 포함됩니다. * `range_start_time`: 확정된 날짜 범위의 시작 시각(UTC)입니다. * `range_end_time`: 확정된 날짜 범위의 종료 시각(UTC, 해당 시각은 포함되지 않음)입니다. * `count`: 이 응답에서 반환된 감사 로그 항목의 개수입니다. * `next_cursor`: 다음 결과 페이지를 가져오기 위한 불투명 커서입니다. 이 필드가 `null`이면 선택한 날짜 범위에 더 이상 결과가 없습니다. 2시간 범위의 응답을 페이지 매김 방식으로 가져오려면 다음 명령을 실행하세요. ```bash theme={"system"} curl -H "Authorization: Basic [BASE64-USERNAME-API-KEY]" \ "[API-ENDPOINT]?startDate=2026-08-01T13:00&endDate=2026-08-01T15:00&limit=1000" ``` 응답은 다음 예시와 비슷합니다. ```json theme={"system"} { "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`이 될 때까지 이 과정을 반복하세요. ```bash theme={"system"} 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](/ko/products/wandb/platform/hosting/hosting-options/self-managed) 및 [Dedicated Cloud](/ko/products/wandb/platform/hosting/hosting-options/dedicated-cloud)에서는 W\&B 조직 관리자 또는 인스턴스 관리자가 감사 로그를 가져올 때 PII를 제외할 수 있습니다. [Multi-tenant Cloud](/ko/products/wandb/platform/hosting/hosting-options/multi_tenant_cloud)에서는 API 엔드포인트가 PII를 포함한 감사 로그의 관련 필드를 항상 반환하며, 이 동작은 변경할 수 없습니다. PII를 제외하려면 `anonymize=true` URL 매개변수를 전달하세요. 예를 들어 W\&B 인스턴스 URL이 `https://mycompany.wandb.io`이고, 지난 1주일간의 사용자 활동 감사 로그를 PII 없이 조회하려면 다음과 같은 API 엔드포인트를 사용하세요. ```text theme={"system"} 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` | 리포트가 조회됩니다. 1 | | `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 키가 생성됩니다. 1 | | `user:create` | 사용자가 생성됩니다. 1 | | `user:deactivate` | 사용자가 비활성화됩니다. 1 | | `user:delete_api_key` | 사용자 또는 서비스 계정의 API 키가 삭제됩니다. 1 | | `user:initiate_login` | 사용자가 로그인을 시작합니다. 1 | | `user:login` | 사용자가 로그인합니다. 1 | | `user:logout` | 사용자가 로그아웃합니다. 1 | | `user:permanently_delete` | 사용자가 영구 삭제됩니다. 1 | | `user:reactivate` | 사용자가 다시 활성화됩니다. 1 | | `user:read` | 사용자 프로필이 조회됩니다. 1 | | `user:update` | 사용자 정보가 업데이트됩니다. 1 | ## Related topics - [Dedicated Cloud](/ko/products/wandb/platform/hosting/hosting-options/dedicated-cloud.md)