AI Commerce Search audit logging

This page breaks down AI Commerce Search audit logging procedures by service, methods, and API interfaces. The audit logs generated vary depending on the AI Commerce Search product (including Recommendations AI) and product component, such as user events and models.

Recommendations AI audit logging

There are key Recommendations AI methods that generate various types of audit logs.

For data access:

• PredictionService.Predict: This method, used to get recommendations, is categorized as a DATA_READ operation and will appear in the data access audit logs.

• ModelService.GetModel and ModelService.ListModels: These methods for retrieving model information are also logged as DATA_READ operations.

For data modification:

• Model management: CreateModel, DeleteModel, PauseModel, ResumeModel, TuneModel, UpdateModel. Methods that don't produce audit logs:

• The google.longrunning.Operations.GetOperation and google.longrunning.Operations.ListOperations methods, which are used to check the status of long-running operations like model training don't produce audit logs.

This document describes audit logging for Agent Search. Google Cloud services generate audit logs that record administrative and access activities within your Google Cloud resources. For more information about Cloud Audit Logs, see the following:

• Types of audit logs
• Audit log entry structure
• Storing and routing audit logs
• Cloud Logging pricing summary
• Enable Data Access audit logs

Service name

Agent Search audit logs use the service name retail.googleapis.com. Filter for this service:

    protoPayload.serviceName="retail.googleapis.com"
  

Methods by permission type

Each IAM permission has a type property, whose value is an enum that can be one of four values: ADMIN_READ, ADMIN_WRITE, DATA_READ, or DATA_WRITE. When you call a method, Agent Search generates an audit log whose category is dependent on the type property of the permission required to perform the method. Methods that require an IAM permission with the type property value of DATA_READ, DATA_WRITE, or ADMIN_READ generate Data Access audit logs. Methods that require an IAM permission with the type property value of ADMIN_WRITE generate Admin Activity audit logs.