이 문서에서는 트레이스 내의 Model Armor 스팬과 세부정보를 보는 방법을 설명합니다. trace에 대한 자세한 내용은 에이전트 trace 보기를 참고하세요.
Cloud Trace 및 에이전트 모니터링 가능성 정보
trace는 요청이 분산 애플리케이션의 여러 부분을 통과하는 경로를 나타냅니다. 즉, 각 트레이스는 단일 엔드 투 엔드 작업을 나타냅니다. 트레이스는 단일 함수 또는 작업의 레코드인 스팬으로 구성되므로 요청의 흐름을 따라가고 지연 시간 데이터를 검사할 수 있습니다. 이 정보는 문제의 근본 원인을 파악하는 데 도움이 됩니다.
Cloud Trace는 Cloud de Confiance by S3NS의 분산 추적 시스템으로, 트레이스를 탐색하거나 SQL로 트레이스 데이터를 분석하는 기능을 제공합니다. 하지만 애플리케이션 모니터링, 에이전트 레지스트리 등 많은Cloud de Confiance 서비스에서 Cloud Trace로 관리되는 데이터를 표시할 수 있습니다. 이러한 서비스를 사용하면 사용 중인 서비스의 컨텍스트에서 추적 데이터를 볼 수 있습니다.
시작하기 전에
-
아직 사용 설정되지 않은 API가 있으면 Cloud Trace, Cloud Logging, Telemetry, Model Armor API를 사용 설정합니다.
API 사용 설정에 필요한 역할
API를 사용 설정하려면
serviceusage.services.enable권한이 필요합니다. 프로젝트를 만든 경우 소유자 역할 (roles/owner)을 통해 이 권한이 이미 있을 수 있습니다. 그렇지 않으면 서비스 사용량 관리자 역할 (roles/serviceusage.serviceUsageAdmin)을 통해 이 권한을 얻을 수 있습니다. 역할을 부여하는 방법 알아보기 - 에이전트의 추적을 설정합니다.
- 게이트웨이에서 Model Armor 구성 또는 Cloud de ConfianceMCP 서버에서 Model Armor 구성
필요한 역할
trace 데이터를 보는 데 필요한 권한을 얻으려면 관리자에게 프로젝트에 대한 다음 IAM 역할을 부여해 달라고 요청하세요.
- Cloud Trace 사용자(
roles/cloudtrace.user) - 로그 뷰어(
roles/logging.viewer)
역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.
커스텀 역할이나 다른 사전 정의된 역할을 통해 필요한 권한을 얻을 수도 있습니다.
필요할 수 있는 다른 역할에 대한 자세한 내용은 Cloud Trace 액세스 제어 및 Cloud Logging 액세스 제어를 참고하세요.
지원되는 페이로드
지원되는 페이로드 목록은 지원되는 페이로드 및 지원되지 않는 페이로드를 참고하세요.
지원되지 않는 페이로드가 포함된 요청의 경우 Model Armor는 오류가 있는 스팬을 생성합니다.
Model Armor 스팬 이름 및 속성
다음 Model Armor 범위를 사용할 수 있습니다.
- 상위 스팬:
apply_guardrail "Google Cloud Model Armor" - 하위 스팬:
Request Path - 하위 스팬:
Response Path
다음 섹션에는 Model Armor 스팬의 가능한 모든 속성이 나열되어 있습니다. 모든 스팬에 속성이 있는 것은 아닙니다. 이러한 속성 이름은 변경될 수 있습니다.
상위 스팬 속성
상위 스팬 apply_guardrail "Google Cloud Model Armor"에는 다음과 같은 속성이 있습니다.
cloud.provider: 작업과 연결된 클라우드 제공업체입니다.cloud.region: 작업이 발생한 Cloud de Confiance by S3NS 리전gcp.project_id: 작업이 발생한 프로젝트의 ID입니다.rpc.system: 작업에 사용된 기본 리모트 프러시저 콜(RPC) 프레임워크 또는 프로토콜입니다(예:grpc).service.name: 작업과 연결된 Cloud de Confiance 서비스입니다. Model Armor 범위의 경우 이 필드의 값은modelarmor입니다.
요청 경로 속성
Request Path 하위 스팬에는 다음과 같은 속성이 있습니다.
gen_ai.security.target.type: 가이드라인이 적용되는 콘텐츠 또는 작업의 유형입니다.Request Path스팬에서 이는 항상input입니다.gen_ai.security.decision.type: Model Armor가 적용한 처리 결과 또는 작업입니다.modify값은 Model Armor가 제공된 템플릿에 따라 콘텐츠에서 민감한 정보를 수정 (익명화)했음을 나타냅니다.gen_ai.security.decision.code: 보안 결정의 숫자 코드입니다.gen_ai.security.decision.reason: 사용자가 읽을 수 있는 결정 이유입니다.gen_ai.security.policy.id:projects/PROJECT_ID/locations/LOCATION/templates/MODEL_ARMOR_TEMPLATE_ID형식의 Model Armor 템플릿의 전체 리소스 이름입니다.gen_ai.security.policy.name: 작업에 사용된 Model Armor 템플릿의 이름입니다.gcp.modelarmor.filter.match.state: 콘텐츠가 Model Armor 필터 (감지기라고도 함)를 위반했는지 여부입니다.gcp.modelarmor.violations: 콘텐츠가 위반한 Model Armor 필터입니다.deidentified값은 Model Armor가 제공된 템플릿에 따라 콘텐츠에서 민감한 정보를 수정했음을 나타냅니다.gcp.modelarmor.rai.violations: 콘텐츠가 위반한 책임감 있는 AI 카테고리입니다. 자세한 내용은 책임감 있는 AI 안전 필터를 참고하세요.gcp.modelarmor.sdp.info_types: Sensitive Data Protection 필터로 식별된 민감한 정보 유형 (예:EMAIL_ADDRESS또는PHONE_NUMBER)입니다.error.type: 발생한 오류의 식별자입니다.
응답 경로 속성
Response Path 하위 스팬에는 다음과 같은 속성이 있습니다.
gen_ai.security.target.type: 가이드라인이 적용되는 콘텐츠 또는 작업의 유형입니다.Response Path스팬에서 이는 항상output입니다.gen_ai.security.decision.type: Model Armor가 적용한 평결 또는 작업입니다.modify값은 Model Armor가 제공된 템플릿에 따라 콘텐츠에서 민감한 정보를 수정 (익명처리)했음을 나타냅니다.gen_ai.security.decision.code: 보안 결정의 숫자 코드입니다.gen_ai.security.decision.reason: 사용자가 읽을 수 있는 결정 이유입니다.gen_ai.security.policy.id:projects/PROJECT_ID/locations/LOCATION/templates/MODEL_ARMOR_TEMPLATE_ID형식의 Model Armor 템플릿의 전체 리소스 이름입니다.gen_ai.security.policy.name: 작업에 사용된 Model Armor 템플릿의 이름입니다.gcp.modelarmor.filter.match.state: 콘텐츠가 Model Armor 필터 (감지기라고도 함)를 위반했는지 여부입니다.gcp.modelarmor.violations: 콘텐츠가 위반한 Model Armor 필터입니다.deidentified값은 Model Armor가 제공된 템플릿에 따라 콘텐츠에서 민감한 정보를 수정했음을 나타냅니다.gcp.modelarmor.rai.violations: 콘텐츠가 위반한 책임감 있는 AI 카테고리입니다. 자세한 내용은 책임감 있는 AI 안전 필터를 참고하세요.gcp.modelarmor.sdp.info_types: Sensitive Data Protection 필터에서 식별한 민감한 정보 유형 (예:EMAIL_ADDRESS또는PHONE_NUMBER)입니다.error.type: 발생한 오류의 식별자입니다.
Model Armor 범위의 세부정보 보기
Model Armor 스팬과 속성, DAG 등의 세부정보를 보려면 다음 단계를 따르세요.
- Cloud de Confiance 콘솔에서 Agent Registry로 이동합니다.
- 프로젝트를 선택합니다.
- 에이전트 이름을 클릭합니다.
- Trace 탭을 클릭합니다.
- 확인하려는 트레이스의 ID를 클릭합니다. 트레이스에 Model Armor 스팬이 포함된 경우 트레이스에는
apply_guardrail "Google Cloud Model Armor"스팬이 포함됩니다. 트레이스를 살펴봅니다.
- 트레이스를 방향성 비순환 그래프 (DAG)로 보려면 그래프 뷰를 클릭합니다. 이 뷰는 에이전트의 실행 추적을 노드 링크 다이어그램으로 나타냅니다. DAG는 다양한 트레이스 스팬 간의 인과 관계와 종속 항목을 강조하고 한 작업이 다음 작업을 트리거하는 방식을 보여줍니다. 그래프의 각 노드는 스팬입니다.
- 트레이스를 타임라인으로 보려면 타임라인 보기를 클릭합니다. 타임라인의 각 막대는 스팬을 나타냅니다.
스팬을 클릭하여 속성을 확인합니다.
또는 Cloud Trace에서 보기를 클릭하여 Trace 탐색기를 통해 프로젝트의 모든 스팬을 볼 수 있습니다. 스팬 필터를 적용하여 apply_guardrail "Google Cloud Model Armor" 스팬을 검색합니다.