Cortex Framework의 원격 분석

Cortex Framework는 배포 및 동기화 프로세스 중에 익명처리된 사용 통계를 수집합니다.

데이터 수집 목적

  • 기능 도입 평가: 프레임워크 모듈 및 데이터 제품 배포 빈도를 모니터링하면 개발 우선순위를 알 수 있습니다.
  • 통합 패턴 식별: 연결된 소스 시스템 변형 (예: SAP ECC, SAP S/4HANA)을 추적하면 호환성을 확인하고 이러한 통합의 유지보수 우선순위를 지정할 수 있습니다.

원격 분석은 기본적으로 사용 설정 되어 있습니다. 사용 중지하려면 '원격 분석 사용 중지' 섹션을 참고하세요.

수집된 데이터

프레임워크는 데이터 세트 ID, 데이터 제품 인스턴스 ID, 저장소 ID와 같은 구성 식별자를 수집합니다. 이름, 이메일, IP 주소와 같은 사용자 ID 속성은 수집되지 않습니다.

  • Google Cloud 프로젝트 번호: 배포를 실행하는 프로젝트를 식별하며, 사용량을 집계하기 위해 X-Goog-User-Project 헤더에서 전송됩니다.
  • 배포 리전 또는 위치: 대상 리소스가 배포되는 리전으로, 지리적 분포를 추적하는 데 사용됩니다.
  • 프레임워크 버전: 사용 중인 Cortex Framework 코드베이스 버전입니다 (예: 7.0.0).
  • 구성요소 이름: 작업이 실행되는 최상위 아키텍처 구성요소입니다 (예: platform, data-product, foundation).
  • 도구 유형: 실행된 특정 CLI 명령어 또는 유틸리티입니다 (예: deployer 또는 knowledge-catalog).
  • 타겟 변형: 배포된 모듈의 소스 시스템 또는 도메인 카테고리입니다 (예: sap 또는 marketing).
  • 사용 설정된 모듈 유형: 구성에서 사용 설정된 개별 모듈의 디렉터리 이름 또는 경로입니다.
  • Dataform 저장소 ID: 사용자가 구성한 타겟 Dataform 저장소의 이름입니다.
  • BigQuery 데이터 세트 ID: 사용자가 구성한 타겟 BigQuery 데이터 세트 이름입니다.
  • 데이터 제품 인스턴스 ID: Knowledge Catalog 등록 단계에서 등록된 데이터 제품을 식별하는 데 사용되는 사용자 제공 ID입니다.
  • 실행 상태: 배포 단계의 성공 또는 실패 상태입니다 (예: deployed, post-deploy-success, error, registered, updated).

User-Agent 헤더 구조

원격 분석 매개변수는 다음 패턴을 사용하여 동적으로 형식이 지정되는 특수 HTTP User-Agent 헤더를 사용하여 Google Cloud API 요청에 삽입됩니다.

gcp-cortex-eng/framework/<version>/<component>/<tool_type>/<variant>[/<optional_extension>]/<status>

예를 들어 SAP ERP 기반을 성공적으로 배포하는 경우 다음과 같습니다.

gcp-cortex-eng/framework/7.0.0/platform/deployer/sap/cortex/sap/foundations/sap/deployed

데이터 전송

Cortex Framework는 수동적이고 페이로드 없는 메타데이터 로깅 메커니즘을 활용합니다. 명시적 로그 페이로드를 외부 엔드포인트로 전송하는 대신 원격 분석 이벤트는 Google Cloud 서비스와의 표준 상호작용을 사용하여 기록됩니다.

배포, 동기화 또는 데모 명령어를 실행하는 동안 프레임워크는 표준 Google Cloud API와 통신합니다. 여기에는 BigQuery 및 Dataform이 포함됩니다.

원격 분석 데이터는 이러한 API 요청의 본문에 전송되지 않습니다. 대신 원격 분석 데이터는 Google Cloud's API 트래픽 로깅에 의해 기본적으로 캡처되며, 이 로깅은 커스텀 User-Agent 및 프로젝트 번호 헤더를 파싱하여 솔루션의 도입률과 성공률을 측정합니다.

원격 분석 사용 중지

Cortex Framework는 개인 정보 보호 설정을 준수하고 영구적인 수신 거부 정책을 구현합니다. cortex-config 도구를 사용하거나 실행 중에 CLI 플래그를 전달하여 원격 분석을 전역적으로 관리할 수 있습니다.

전역적으로 사용 중지

~/.cortex/cortex-framework-consent.properties에 있는 영구 사용자 환경설정 파일을 업데이트하여 원격 분석을 관리할 수 있습니다. 이 파일에 enable_telemetry=false가 포함되어 있으면 런타임에 원격 분석 API 호출이 완전히 건너뜁니다.

  • 영구적으로 수신 거부 (전역적으로 사용 중지):
uv run cortex-config telemetry disable
  • 영구적으로 수신 설정 (전역적으로 사용 설정):
uv run cortex-config telemetry enable
  • 현재 상태 확인:
uv run cortex-config telemetry status

단일 실행에 사용 중지

--disable-telemetry 플래그를 실행 명령어에 전달할 수 있습니다. --disable-telemetry가 한 번 실행되면 프레임워크는 enable_telemetry=false가 포함된 영구 구성 파일을 ~/.cortex/cortex-framework-consent.properties에 자동으로 만듭니다.

## Cortex Framework-deploy
uv run cortex-deploy --config config/config.yaml --disable-telemetry

## Cortex Framework-build-and-deploy
uv run cortex-build-and-deploy --config config/config.yaml --disable-telemetry

## Cortex Framework-demo
uv run cortex-demo --config config/config.yaml --disable-telemetry

## Cortex Framework-kc-sync
uv run cortex-kc-sync --config config/config.yaml --disable-telemetry

이러한 명령어 및 해당 매개변수에 대한 자세한 내용은 다음 CLI 참조를 참고하세요.