설정 구성

이 페이지에서는 Mainframe Assessment Tool의 일반 설정을 구성하고 새 평가의 기본 AI 기능을 수정하는 방법을 설명합니다.

수정된 설정은 기존 평가에 적용되지 않습니다. 수정된 설정을 사용하려면 새 평가를 만드세요.

일반 설정 구성

평가의 일반 설정을 구성하려면 다음 단계를 따르세요.

1. 설정설정 아이콘을 클릭합니다.

2. Cloud Logging 및 Google 애널리틱스의 환경설정을 수정하려면 일반 설정 섹션에서 다음을 수행합니다.

   • 로깅을 사용 중지하려면 Cloud Logging 사용 설정 전환 버튼을 사용 중지 위치로 클릭합니다. 기본적으로 이 설정은 사용 설정되어 있습니다.

     자세한 내용은 Cloud Logging 문서를 참조하세요.

     **참고:** 로깅을 사용하면 추가 비용이 발생할 수 있습니다.

   • Google 애널리틱스를 사용 중지하려면 Google 애널리틱스 사용 설정 전환 버튼을 사용 중지 위치로 클릭합니다. 기본적으로 Google 애널리틱스는 사용 설정되어 있습니다. 이 설정의 변경사항은 페이지를 다시 로드한 후에만 적용됩니다.

3. Google Cloud 프로젝트 필드를 보고 Google Cloud 프로젝트 ID를 확인합니다. UI에서는 이 필드를 수정할 수 없습니다. 다른 프로젝트를 사용하려면 프로젝트 Google Cloud 재정의를 참조하세요.

   참고: 이전 버전의 Mainframe Assessment Tool (버전 3.4.0 이하)에서 프로젝트 ID를 구성한 경우 인스턴스가 배포된 프로젝트 대신 저장된 설정이 기본적으로 사용됩니다.

4. 제공 등급에서 Gemini Enterprise Agent Platform 제공 등급을 선택합니다. 기본값은 표준입니다.

   제공 등급 설정은 메인프레임 평가 중에 Gemini 모델 호출에 적용되는 추론 및 가격 모델을 결정합니다. Gemini Enterprise Agent Platform 제공 등급에 대한 자세한 내용은 PayGo를 참조하세요.

5. 설정 저장 을 클릭합니다.

프로젝트 Google Cloud 재정의

기본적으로 Mainframe Assessment Tool은 인스턴스가 배포된 Google Cloud 프로젝트를 사용합니다. 평가에 사용되는 프로젝트를 재정의하려면 배포 환경의 안내를 따르세요.

시작하기 전에

프로젝트 Google Cloud 재정의를 준비하려면 다음 작업을 완료하세요.

• 필요한 권한을 부여합니다. 필요한 권한은 Mainframe Assessment Tool을 배포한 방법에 따라 다릅니다.
  • Compute Engine VM 인스턴스에서는 인스턴스에 커스텀 메타데이터를 설정할 수 있는 권한이 필요합니다. 필수 역할에 대한 자세한 내용은 커스텀 메타데이터 설정 및 삭제를 참조하세요.
  • GKE 클러스터에서는 클러스터에서 배포를 업데이트할 수 있는 권한이 필요하며 클러스터에 연결하도록 kubectl 명령줄 도구를 구성해야 합니다. 자세한 내용은 kubectl의 클러스터 액세스 구성을 참조하세요.
• 대상 프로젝트 액세스 권한을 제공합니다. Mainframe Assessment Tool에서 사용하는 서비스 계정에 대상 프로젝트의 필수 역할을 부여합니다.

Compute Engine VM 인스턴스에서 프로젝트 재정의

Compute Engine VM 인스턴스에서 Google Cloud 프로젝트를 재정의하려면 MAT_GCP_PROJECT_OVERRIDE 메타데이터 키를 추가하고 다음 gcloud 명령어를 실행하여 값을 대상 프로젝트 ID로 설정합니다.

gcloud compute instances add-metadata INSTANCE_NAME \
    --metadata=MAT_GCP_PROJECT_OVERRIDE=PROJECT_ID \
    --zone=ZONE

재정의를 삭제하려면 다음 gcloud 명령어를 실행하여 메타데이터 키를 삭제합니다.

gcloud compute instances remove-metadata INSTANCE_NAME \
    --keys=MAT_GCP_PROJECT_OVERRIDE \
    --zone=ZONE

다음을 바꿉니다.

• INSTANCE_NAME: VM 인스턴스의 이름입니다.
• PROJECT_ID: 대상 Google Cloud 프로젝트 ID입니다.
• ZONE: VM 인스턴스가 있는 영역입니다.

그러면 Mainframe Assessment Tool은 저장된 프로젝트 ID(있는 경우) 또는 인스턴스가 배포된 프로젝트로 대체됩니다. 실행 중인 VM에서 메타데이터 키를 설정하거나 삭제하는 경우 변경사항을 적용하려면 VM을 다시 시작해야 합니다.

GKE 클러스터에서 프로젝트 재정의

GKE 배포에서 Google Cloud 프로젝트를 재정의하려면 MAT_GCP_PROJECT_OVERRIDE 환경 변수를 backend 컨테이너에서 설정합니다.

kubectl set env deployment/mat-apps --containers=backend \
    MAT_GCP_PROJECT_OVERRIDE=PROJECT_ID --namespace=VERSION

재정의를 삭제하려면 하이픈 (-)을 추가하여 환경 변수를 설정 해제합니다.

kubectl set env deployment/mat-apps --containers=backend \
    MAT_GCP_PROJECT_OVERRIDE- --namespace=VERSION

다음을 바꿉니다.

• PROJECT_ID: 대상 Google Cloud 프로젝트 ID입니다.
• VERSION: 클러스터에 배포된 Mainframe Assessment Tool 버전입니다 (예: mainframe-assessment-3-5-0).

그러면 Mainframe Assessment Tool은 저장된 프로젝트 ID(있는 경우) 또는 인스턴스가 배포된 프로젝트로 대체됩니다. 환경 변수를 업데이트하면 프로젝트 재정의가 적용된 포드가 다시 시작됩니다. Mainframe Assessment Tool은 단일 포드로 실행되므로 새 포드가 시작되는 동안 일시적으로 사용할 수 없습니다.

새 평가의 기본 AI 기능 구성

Mainframe Assessment Tool을 사용하면 평가에서 AI 통계의 기본 매개변수를 맞춤설정할 수 있습니다. 기본적으로 AI 통계는 사용 설정되어 있습니다.

새 평가에서 AI 기능을 구성하려면 다음 단계를 따르세요.

1. 설정설정 아이콘을 클릭합니다.

2. COBOL 코드의 단락 수준 요약을 생성하려면 세부 요약 을 선택합니다.

   기본적으로 AI 분석이 사용 설정된 경우 이 옵션이 선택됩니다.

3. Gemini에서 생성한 평가 사양의 테스트 사례를 생성하려면 테스트 사례 를 선택합니다.

   기본적으로 AI 분석이 사용 설정된 경우 이 옵션은 선택되지 않습니다.

4. 추가 생성 안내에 AI 생성 중에 Gemini 프롬프트에 추가할 텍스트를 입력합니다.

5. 설정 저장 을 클릭합니다.

시스템 상태 확인

Mainframe Assessment Tool은 프로젝트에서 평가를 실행할 수 있는지 확인합니다. 이 검사를 통해 서비스 계정이 필요한 IAM 역할을 보유하고 있으며 모든 Gemini 모델이 평가에서 사용할 수 있는 각 엔드포인트에서 응답하는지 확인합니다. Mainframe Assessment Tool은 시작 시 검사를 실행합니다. 이 검사는 평가를 차단하지 않습니다.

검사 결과를 검토하려면 다음 단계를 따르세요.

1. 설정설정 아이콘을 클릭합니다.

2. 시스템 상태 섹션에서 다음을 검토합니다.

   • 확인된 ID: 검사가 실행된 서비스 계정입니다.

   • IAM 권한: 서비스 계정이 필요한 각 역할을 보유하고 있는지 여부입니다.

   • 모델: 각 모델이 응답하는 엔드포인트입니다. 응답하지 않는 모델의 경우 Mainframe Assessment Tool은 엔드포인트, 원인, 취할 조치를 지정합니다.

3. 선택사항: 역할을 부여하거나 네트워크 구성을 변경한 후와 같이 검사를 다시 실행하려면 다시 확인 을 클릭합니다.

검사에서 문제를 발견하면 Mainframe Assessment Tool은 문제를 해결하거나 무시할 때까지 모든 페이지에 알림을 표시합니다.

프로젝트에서 Cloud Resource Manager API가 사용 설정되어 있지 않으면 Mainframe Assessment Tool에서 IAM 권한을 확인할 수 없으며 시스템 상태 섹션에 이를 보고합니다. API를 사용 설정하려면 API 사용 설정을 참조하세요.

선택사항: 작업 수행

이 섹션에서는 Gemini 캐시 지우기 및 로그 다운로드와 같은 작업을 수행하는 방법을 설명합니다.

작업을 수행하려면 다음 단계를 따르세요.

1. 설정설정 아이콘을 클릭합니다.

2. Gemini 캐시를 지우려면 모델 캐시 지우기 를 클릭합니다.

   참고: 동일한 파일에 대한 후속 평가의 성능과 정확성을 개선하려면 캐시를 지우지 마세요. Gemini는 후속 평가에 캐시 데이터를 사용합니다.

3. Mainframe Assessment Tool 로그를 다운로드하려면 지원 번들 다운로드 를 클릭합니다.

   지원 번들에는 Mainframe Assessment Tool 로그가 zip 파일로 포함되어 있으며, 이 파일을 Google Cloud 지원팀과 공유하여 문제를 해결할 수 있습니다.

평가의 AI 통계 사용 중지

AI 분석을 사용 중지하여 평가 페이지에 AI 통계가 표시되지 않도록 할 수 있습니다.

평가의 AI 분석을 사용 중지하려면 다음 단계를 따르세요.

1. 새 평가의 기본 AI 기능 섹션에서 AI 통계 사용 설정 을 선택 취소합니다.

2. 설정 저장 을 클릭합니다.

커스텀 메타데이터 라벨을 사용하여 Agent Platform 비용 추적

Mainframe Assessment Tool은 비용을 추적하고 분석하는 데 도움이 되도록 모든 Agent Platform 요청에 커스텀 메타데이터 라벨을 자동으로 추가합니다. 결제 보고서에서 이러한 라벨을 사용하여 비용을 필터링하여 Agent Platform 사용량을 더 잘 이해하고 최적화할 수 있습니다. 비용은 사용 후 24시간 이내에 결제 보고서에서 업데이트되지만 경우에 따라 더 오래 걸릴 수 있습니다.

다음 라벨을 사용하여 결제 보고서에서 비용을 필터링합니다.

• mat-version: Mainframe Assessment Tool 버전입니다.
• mat-host: Mainframe Assessment Tool 인스턴스의 호스트 환경입니다. 예를 들어 Compute Engine VM 또는 Google Kubernetes Engine입니다.
• mat-action-type: Mainframe Assessment Tool에서 수행한 작업 유형입니다.
• mat-schema: 처리된 애셋 유형입니다. 예를 들어 COBOL 또는 JCL입니다.
• mat-target: Mainframe Assessment Tool 인스턴스의 배포 대상입니다.
• mat-run-id: 평가의 고유 ID입니다.

결제 보고서에서 이러한 필터 중 하나 이상을 사용하여 사용량을 추적하려면 필터를 사용하여 데이터 미세 조정을 참조하세요.

Agent Platform의 라벨에 대한 자세한 내용은 커스텀 메타데이터 라벨을 참조하세요.

다음 단계

• 평가 생성 방법을 알아보세요.