본문 바로가기
WIKI 기술 지식 베이스

감사 이벤트

원문 보기 위키 갱신

감사 이벤트 (Audit Events)

Catalog 백엔드가 다양한 작업에 대해 내보내는 감사(audit) 이벤트를 설명하는 문서예요.

출처: 문서

본문

Catalog 백엔드는 다양한 작업에 대해 감사 이벤트를 내보내요. 이벤트는 eventId로 논리적으로 그룹화되며, subEventId가 작업 그룹 내에서 더 세부적으로 구분을 제공해요.

엔티티 이벤트 (Entity Events)

  • entity-fetch: 엔티티를 조회해요.

  • 참고: 기본적으로 entity-fetch 같은 "low" 심각도 감사 이벤트는 "debug" 레벨에 매핑되므로 기록되지 않아요. 반면 Backstage는 기본적으로 "info" 레벨 로깅을 사용해요. entity-fetch 이벤트를 보려면 app-config.yaml에서 backend.auditor.severityLogLevelMappings.low: info를 설정해 업데이트하세요. 심각도 매핑에 대한 자세한 내용은 Auditor Service 문서를 참고하세요.

queryType으로 필터링해요.

  • all: 모든 엔티티 조회. (GET /entities)

  • by-id: UID를 사용해 단일 엔티티 조회. (GET /entities/by-uid/:uid)

  • by-name: kind, namespace, name을 사용해 단일 엔티티 조회. (GET /entities/by-name/:kind/:namespace/:name)

  • by-query: 필터 쿼리를 사용해 여러 엔티티 조회. (GET /entities/by-query)

  • by-refs: 엔티티 ref로 엔티티 배치(batch) 조회. (POST /entities/by-refs)

  • ancestry: 엔티티의 계보(ancestry) 조회. (GET /entities/by-name/:kind/:namespace/:name/ancestry)

  • entity-mutate: 엔티티를 수정해요.

actionType으로 필터링해요.

  • delete: 단일 엔티티 삭제. 참고: 이는 영구 삭제가 아니며, 부모 location이 여전히 카탈로그에 존재하면 엔티티는 복원돼요. (DELETE /entities/by-uid/:uid)

  • refresh: 엔티티 새로고침 예약. (POST /entities/refresh)

  • entity-validate: 엔티티를 검증해요. (POST /entities/validate)

  • entity-facets: 엔티티 facet을 조회해요. (GET /entity-facets)

Location 이벤트

  • location-fetch: location을 조회해요.

actionType으로 필터링해요.

  • all: 모든 location 조회. (GET /locations)

  • by-id: ID로 단일 location 조회. (GET /locations/:id)

  • by-entity: 엔티티 ref와 연결된 location 조회. (GET /locations/by-entity)

  • location-mutate: location을 수정해요.

  • create: 새 location 생성. (POST /locations)

  • delete: location과 그와 연결된 엔티티 삭제. (DELETE /locations/:id)

  • location-analyze: location을 분석해요. (POST /locations/analyze)

더 알아보기 (Learn more)