> ## Documentation Index > Fetch the complete documentation index at: https://wb-21fd5541-workspaces-notebooks.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # 감사 로그로 사용자 활동 추적 > 로그 스키마와 추적되는 작업을 포함해, 다양한 배포 유형에서 W&B 감사 로그에 액세스하고 가져오고 분석합니다. W\&B 감사 로그를 사용하면 조직 내 사용자 활동을 추적하고 엔터프라이즈 거버넌스 요구 사항을 충족할 수 있습니다. 이 페이지는 W\&B 배포 유형 전반에서 감사 로그 데이터에 액세스하고, 가져오고, 분석해야 하는 조직 수준 관리자용입니다. 감사 로그는 JSON 형식으로 사용 가능합니다. [감사 로그 스키마](#audit-log-schema)를 참고하세요. 감사 로그에 액세스하는 방법은 W\&B 플랫폼 배포 유형에 따라 다릅니다. | W\&B 플랫폼 배포 유형 | 감사 로그 액세스 방식 | | ----------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | [Dedicated Cloud](/ko/platform/hosting/hosting-options/dedicated-cloud) | | | [Multi-tenant Cloud](/ko/platform/hosting/hosting-options/multi_tenant_cloud) | Enterprise 플랜에서만 사용할 수 있습니다. [API](#fetch-audit-logs)로만 사용할 수 있습니다. | | [Self-Managed](/ko/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)을 참고하세요.
## 감사 로그 보존
다음 권장 사항은 조직의 거버넌스 및 규정 준수 의무를 충족할 수 있도록 감사 로그를 보존하는 데 도움이 됩니다. * 감사 로그를 특정 기간 동안 보존해야 하는 경우, W\&B는 저장소 버킷 또는 Audit Logging API를 사용해 로그를 장기 저장소로 주기적으로 전송할 것을 권장합니다. * [Health Insurance Portability and Accountability Act of 1996 (HIPAA)](https://hhs.gov/hipaa/for-professionals/index.html)의 적용을 받는 경우, 감사 로그는 의무 보존 기간이 끝나기 전에 내부 또는 외부의 어떤 주체도 삭제하거나 수정할 수 없는 환경에서 최소 6년 동안 보존되어야 합니다. [BYOB](/ko/platform/hosting/data-security/secure-storage-connector)를 사용하는 HIPAA 준수 [Dedicated Cloud](/ko/platform/hosting/hosting-options/dedicated-cloud) 인스턴스의 경우, 장기 보존 저장소를 포함한 관리형 저장소에 대해 가드레일을 구성해야 합니다.
## 감사 로그 스키마
각 감사 로그 항목에서 반환되는 필드를 해석하려면 이 스키마를 사용하세요. 다음 표는 감사 로그 항목에 나타날 수 있는 모든 키를 알파벳순으로 보여 줍니다. action 및 상황에 따라 특정 로그 항목에는 가능한 필드 중 일부만 포함될 수 있습니다. | Key | 정의 | | ------------------------- | --------------------------------------------------------------------------------------------------------------------------------------- | | `action` | 이벤트의 [action](#actions)입니다. | | `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](https://www.rfc-editor.org/rfc/rfc3339)의 이벤트 시간입니다. 예를 들어 `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](/ko/platform/hosting/hosting-options/self-managed) 및 [Dedicated Cloud](/ko/platform/hosting/hosting-options/dedicated-cloud)의 경우, 조직 관리자는 감사 로그를 가져올 때 [PII 제외](#exclude-pii)를 설정할 수 있습니다. * [Multi-tenant Cloud](/ko/platform/hosting/hosting-options/multi_tenant_cloud)의 경우, API 엔드포인트는 PII를 포함한 감사 로그의 관련 필드를 항상 반환합니다. 이는 설정할 수 없습니다.
## 시작하기 전에
감사 로그를 가져오기 전에 배포 유형에 따라 다음 사전 요구 사항을 충족하는지 확인하세요: * 조직 수준 관리자는 감사 로그를 가져올 수 있습니다. `403` 오류가 발생하면 본인 또는 서비스 계정에 충분한 권한이 있는지 확인하세요. * **Multi-tenant Cloud**: 여러 Multi-tenant Cloud 조직의 멤버인 경우, 감사 로그 API 호출이 라우팅될 대상을 결정하는 **Default API organization**을 *반드시* 구성해야 합니다. 그렇지 않으면 다음 오류가 발생합니다: ```text theme={null} 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](/ko/platform/hosting/hosting-options/dedicated-cloud) 또는 [Self-Managed](/ko/platform/hosting/hosting-options/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 제외](#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`: 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](#audit-log-schema)에 설명된 필드가 포함되며, 이는 인스턴스 수준 버킷으로 동기화되는 로그와 동일합니다. 3일 범위에 대해 줄바꿈으로 구분된 스트리밍 JSON 응답을 가져오고 PII를 제외하려면 다음을 실행하세요. ```bash theme={null} 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`: 다음 결과 페이지를 가리키는 불투명(opaque) 커서입니다. 이 필드가 `null`이면 선택한 날짜 범위에 더 이상 결과가 없습니다. 두 시간 범위에 대해 페이지 매김된 응답을 가져오려면 다음을 실행하세요. ```bash theme={null} curl -H "Authorization: Basic [BASE64-USERNAME-API-KEY]" \ "[API-ENDPOINT]?startDate=2026-08-01T13:00&endDate=2026-08-01T15:00&limit=1000" ``` 응답은 다음 예시와 유사합니다. ```json theme={null} { "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={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](/ko/platform/hosting/hosting-options/self-managed) 및 [Dedicated Cloud](/ko/platform/hosting/hosting-options/dedicated-cloud)에서는 W\&B 조직 또는 instance admin이 audit logs를 가져올 때 PII를 제외할 수 있습니다. [Multi-tenant Cloud](/ko/platform/hosting/hosting-options/multi_tenant_cloud)에서는 API endpoint가 PII를 포함한 audit logs의 관련 필드를 항상 반환하며, 이 동작은 변경할 수 없습니다. PII를 제외하려면 `anonymize=true` URL 파라미터를 전달하세요. 예를 들어 최근 일주일간의 사용자 활동에 대한 audit logs를 PII 없이 조회하려면, W\&B 인스턴스 URL이 `https://mycompany.wandb.io`인 경우 다음과 같은 API endpoint를 사용하세요: ```text theme={null} https://mycompany.wandb.io/admin/audit_logs?anonymize=true&[ADDITIONAL-PARAMETERS]. ``` [Multi-tenant Cloud](/ko/platform/hosting/hosting-options/multi_tenant_cloud)를 사용하는 경우 이 탭을 참조하세요. Multi-tenant 감사 로그는 Enterprise 플랜에서만 사용 가능합니다. Audit Logging API endpoint는 다음과 같습니다: ```text theme={null} 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](#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` 값입니다. 특정 범위의 감사 로그를 가져오려면 다음을 실행하세요. ```bash theme={null} curl -H "Authorization: Basic [BASE64-USERNAME-API-KEY]" \ "https://api.wandb.ai/audit_logs?startDate=2026-08-01&numDays=2&limit=1000" ``` 응답은 다음 예시와 유사합니다: ```json theme={null} { "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`이 될 때까지 이 과정을 반복하세요. ```bash theme={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](/ko/platform/hosting/hosting-options/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` | 리포트가 조회됩니다. 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` | sweep 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 |