Model Armor 审核和平台日志记录

本文档介绍了 Model Armor 的审核日志记录。 Google Cloud 服务会生成审核日志，以记录 Google Cloud 资源中的管理和访问活动。如需详细了解 Cloud Audit Logs，请参阅以下内容：

• 审核日志类型
• 审核日志条目结构
• 存储和路由审核日志
• Cloud Logging 价格摘要
• 启用数据访问审核日志

服务名称

Model Armor 审核日志使用服务名称 modelarmor.googleapis.com。 针对此服务的过滤条件：

    protoPayload.serviceName="modelarmor.googleapis.com"
  

方法（按权限类型）

每个 IAM 权限都有一个 type 属性，该属性的值是一个枚举，可以是以下四个值之一：ADMIN_READ、ADMIN_WRITE、DATA_READ 或 DATA_WRITE。当您调用某个方法时，Model Armor 会生成一个审核日志，其类别取决于执行该方法所需权限的 type 属性。需要 IAM 权限且 type 属性值为 DATA_READ、DATA_WRITE 或 ADMIN_READ 的方法会生成数据访问审核日志。需要 IAM 权限且 type 属性值为 ADMIN_WRITE 的方法会生成管理员活动审核日志。

权限类型	方法
ADMIN_READ	google.cloud.modelarmor.v1.ModelArmor.GetFloorSetting google.cloud.modelarmor.v1.ModelArmor.GetTemplate google.cloud.modelarmor.v1.ModelArmor.ListTemplates google.cloud.modelarmor.v1alpha.ModelArmor.GetFloorSetting google.cloud.modelarmor.v1alpha.ModelArmor.GetTemplate google.cloud.modelarmor.v1alpha.ModelArmor.ListTemplates
ADMIN_WRITE	google.cloud.modelarmor.v1.ModelArmor.CreateTemplate google.cloud.modelarmor.v1.ModelArmor.DeleteTemplate google.cloud.modelarmor.v1.ModelArmor.UpdateFloorSetting google.cloud.modelarmor.v1.ModelArmor.UpdateTemplate google.cloud.modelarmor.v1alpha.ModelArmor.CreateTemplate google.cloud.modelarmor.v1alpha.ModelArmor.DeleteTemplate google.cloud.modelarmor.v1alpha.ModelArmor.UpdateFloorSetting google.cloud.modelarmor.v1alpha.ModelArmor.UpdateTemplate
DATA_READ	google.cloud.modelarmor.v1.ModelArmor.SanitizeModelResponse google.cloud.modelarmor.v1.ModelArmor.SanitizeUserPrompt google.cloud.modelarmor.v1alpha.ModelArmor.SanitizeModelResponse google.cloud.modelarmor.v1alpha.ModelArmor.SanitizeUserPrompt

API 接口审核日志

如需了解如何评估每种方法的权限以及评估哪些权限，请参阅 Model Armor 的 Identity and Access Management 文档。

google.cloud.modelarmor.v1.ModelArmor

以下审核日志与属于 google.cloud.modelarmor.v1.ModelArmor 的方法相关联。

CreateTemplate

• 方法：google.cloud.modelarmor.v1.ModelArmor.CreateTemplate
  
• 审核日志类型：管理员活动
  
• 权限：
  • modelarmor.templates.create - ADMIN_WRITE
• 方法是长时间运行的操作或流式传输操作：否。
  
• 此方法的过滤条件： protoPayload.methodName="google.cloud.modelarmor.v1.ModelArmor.CreateTemplate"
  

DeleteTemplate

• 方法：google.cloud.modelarmor.v1.ModelArmor.DeleteTemplate
  
• 审核日志类型：管理员活动
  
• 权限：
  • modelarmor.templates.delete - ADMIN_WRITE
• 方法是长时间运行的操作或流式传输操作：否。
  
• 此方法的过滤条件： protoPayload.methodName="google.cloud.modelarmor.v1.ModelArmor.DeleteTemplate"
  

GetFloorSetting

• 方法：google.cloud.modelarmor.v1.ModelArmor.GetFloorSetting
  
• 审核日志类型：数据访问
  
• 权限：
  • modelarmor.floorSettings.get - ADMIN_READ
• 方法是长时间运行的操作或流式传输操作：否。
  
• 此方法的过滤条件： protoPayload.methodName="google.cloud.modelarmor.v1.ModelArmor.GetFloorSetting"
  

GetTemplate

• 方法：google.cloud.modelarmor.v1.ModelArmor.GetTemplate
  
• 审核日志类型：数据访问
  
• 权限：
  • modelarmor.templates.get - ADMIN_READ
• 方法是长时间运行的操作或流式传输操作：否。
  
• 此方法的过滤条件： protoPayload.methodName="google.cloud.modelarmor.v1.ModelArmor.GetTemplate"
  

ListTemplates

• 方法：google.cloud.modelarmor.v1.ModelArmor.ListTemplates
  
• 审核日志类型：数据访问
  
• 权限：
  • modelarmor.templates.list - ADMIN_READ
• 方法是长时间运行的操作或流式传输操作：否。
  
• 此方法的过滤条件： protoPayload.methodName="google.cloud.modelarmor.v1.ModelArmor.ListTemplates"
  

SanitizeModelResponse

• 方法：google.cloud.modelarmor.v1.ModelArmor.SanitizeModelResponse
  
• 审核日志类型：数据访问
  
• 权限：
  • modelarmor.templates.useToSanitizeModelResponse - DATA_READ
• 方法是长时间运行的操作或流式传输操作：否。
  
• 此方法的过滤条件： protoPayload.methodName="google.cloud.modelarmor.v1.ModelArmor.SanitizeModelResponse"
  

SanitizeUserPrompt

• 方法：google.cloud.modelarmor.v1.ModelArmor.SanitizeUserPrompt
  
• 审核日志类型：数据访问
  
• 权限：
  • modelarmor.templates.useToSanitizeUserPrompt - DATA_READ
• 方法是长时间运行的操作或流式传输操作：否。
  
• 此方法的过滤条件： protoPayload.methodName="google.cloud.modelarmor.v1.ModelArmor.SanitizeUserPrompt"
  

UpdateFloorSetting

• 方法：google.cloud.modelarmor.v1.ModelArmor.UpdateFloorSetting
  
• 审核日志类型：管理员活动
  
• 权限：
  • modelarmor.floorSettings.update - ADMIN_WRITE
• 方法是长时间运行的操作或流式传输操作：否。
  
• 此方法的过滤条件： protoPayload.methodName="google.cloud.modelarmor.v1.ModelArmor.UpdateFloorSetting"
  

UpdateTemplate

• 方法：google.cloud.modelarmor.v1.ModelArmor.UpdateTemplate
  
• 审核日志类型：管理员活动
  
• 权限：
  • modelarmor.templates.update - ADMIN_WRITE
• 方法是长时间运行的操作或流式传输操作：否。
  
• 此方法的过滤条件： protoPayload.methodName="google.cloud.modelarmor.v1.ModelArmor.UpdateTemplate"
  

google.cloud.modelarmor.v1alpha.ModelArmor

以下审核日志与属于 google.cloud.modelarmor.v1alpha.ModelArmor 的方法相关联。

CreateTemplate

• 方法：google.cloud.modelarmor.v1alpha.ModelArmor.CreateTemplate
  
• 审核日志类型：管理员活动
  
• 权限：
  • modelarmor.templates.create - ADMIN_WRITE
• 方法是长时间运行的操作或流式传输操作：否。
  
• 此方法的过滤条件： protoPayload.methodName="google.cloud.modelarmor.v1alpha.ModelArmor.CreateTemplate"
  

DeleteTemplate

• 方法：google.cloud.modelarmor.v1alpha.ModelArmor.DeleteTemplate
  
• 审核日志类型：管理员活动
  
• 权限：
  • modelarmor.templates.delete - ADMIN_WRITE
• 方法是长时间运行的操作或流式传输操作：否。
  
• 此方法的过滤条件： protoPayload.methodName="google.cloud.modelarmor.v1alpha.ModelArmor.DeleteTemplate"
  

GetFloorSetting

• 方法：google.cloud.modelarmor.v1alpha.ModelArmor.GetFloorSetting
  
• 审核日志类型：数据访问
  
• 权限：
  • modelarmor.floorSettings.get - ADMIN_READ
• 方法是长时间运行的操作或流式传输操作：否。
  
• 此方法的过滤条件： protoPayload.methodName="google.cloud.modelarmor.v1alpha.ModelArmor.GetFloorSetting"
  

GetTemplate

• 方法：google.cloud.modelarmor.v1alpha.ModelArmor.GetTemplate
  
• 审核日志类型：数据访问
  
• 权限：
  • modelarmor.templates.get - ADMIN_READ
• 方法是长时间运行的操作或流式传输操作：否。
  
• 此方法的过滤条件： protoPayload.methodName="google.cloud.modelarmor.v1alpha.ModelArmor.GetTemplate"
  

ListTemplates

• 方法：google.cloud.modelarmor.v1alpha.ModelArmor.ListTemplates
  
• 审核日志类型：数据访问
  
• 权限：
  • modelarmor.templates.list - ADMIN_READ
• 方法是长时间运行的操作或流式传输操作：否。
  
• 此方法的过滤条件： protoPayload.methodName="google.cloud.modelarmor.v1alpha.ModelArmor.ListTemplates"
  

SanitizeModelResponse

• 方法：google.cloud.modelarmor.v1alpha.ModelArmor.SanitizeModelResponse
  
• 审核日志类型：数据访问
  
• 权限：
  • modelarmor.templates.useToSanitizeModelResponse - DATA_READ
• 方法是长时间运行的操作或流式传输操作：否。
  
• 此方法的过滤条件： protoPayload.methodName="google.cloud.modelarmor.v1alpha.ModelArmor.SanitizeModelResponse"
  

SanitizeUserPrompt

• 方法：google.cloud.modelarmor.v1alpha.ModelArmor.SanitizeUserPrompt
  
• 审核日志类型：数据访问
  
• 权限：
  • modelarmor.templates.useToSanitizeUserPrompt - DATA_READ
• 方法是长时间运行的操作或流式传输操作：否。
  
• 此方法的过滤条件： protoPayload.methodName="google.cloud.modelarmor.v1alpha.ModelArmor.SanitizeUserPrompt"
  

UpdateFloorSetting

• 方法：google.cloud.modelarmor.v1alpha.ModelArmor.UpdateFloorSetting
  
• 审核日志类型：管理员活动
  
• 权限：
  • modelarmor.floorSettings.update - ADMIN_WRITE
• 方法是长时间运行的操作或流式传输操作：否。
  
• 此方法的过滤条件： protoPayload.methodName="google.cloud.modelarmor.v1alpha.ModelArmor.UpdateFloorSetting"
  

UpdateTemplate

• 方法：google.cloud.modelarmor.v1alpha.ModelArmor.UpdateTemplate
  
• 审核日志类型：管理员活动
  
• 权限：
  • modelarmor.templates.update - ADMIN_WRITE
• 方法是长时间运行的操作或流式传输操作：否。
  
• 此方法的过滤条件： protoPayload.methodName="google.cloud.modelarmor.v1alpha.ModelArmor.UpdateTemplate"
  

不会生成审核日志的方法

由于以下一个或多个原因，方法可能不会生成审核日志：

• 这是一种高容量方法，涉及较高的日志生成和存储费用。
• 它的审核价值较低。
• 其他审核或平台日志已提供方法。

以下方法不会生成审核日志：

• envoy.service.ext_proc.v3.ExternalProcessor.Process
• google.cloud.location.Locations.GetLocation
• google.cloud.location.Locations.ListLocations

日志记录配置

您可以配置 Model Armor 来记录以下操作：

• 创建、更新、读取和删除模板
• 对用户提示和模型响应进行排错

curl -X POST \
  -d "{filter_config: {}, 'template_metadata': { 'log_template_operations': 'true', 'log_sanitize_operations': 'true'} }" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    "https://modelarmor.LOCATION.rep.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/templates?template_id=TEMPLATE_ID"

• log_template_operations：一个布尔值，用于确定是否应将创建、更新、读取和删除模板的操作记录在平台日志中。

• log_sanitize_operations：一个布尔值，用于确定是否应在平台日志中记录清理操作。日志包括问题和回答、Model Armor 的评估结果以及其他元数据字段。

  替换以下内容：

  • PROJECT_ID - 模板所属的项目的 ID。
  • LOCATION - 模板的位置。
  • TEMPLATE_ID - 模板的 ID。