Audit logging information

This page does not describe audit logs for user actions performed on CCAI Platform. For example, when contact center users (admins, managers, agents) sign in, or make changes to settings. To get audit logs for user actions, contact Cloud Support and provide the following:

  • Google Cloud project of the CCAI Platform contact center.

  • CCAI Platform URL for the contact center

  • The region for the CCAI Platform contact center, for example, us-central1.

  • The Cloud Storage bucket (gs://bucketname) where you want Cloud Support to upload the logs. You will need to grant write access to Cloud Support on this bucket, so they can upload the logs.

    The start and end time and date with the time zone (preferably in UTC) within the last 30 days for the window that you want the logs for. Logs older than 30 days are deleted and cannot be provided.

This document describes audit logging for Contact Center AI Platform. 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:

Service name

Contact Center AI Platform audit logs use the service name contactcenteraiplatform.googleapis.com. Filter for this service: 

    protoPayload.serviceName="contactcenteraiplatform.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, Contact Center AI Platform 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.

Permission type Methods
ADMIN_READ google.cloud.contactcenteraiplatform.v1alpha1.ContactCenterAiPlatform.GetContactCenter
google.cloud.contactcenteraiplatform.v1alpha1.ContactCenterAiPlatform.ListContactCenters
google.cloud.contactcenteraiplatform.v1alpha1.ContactCenterAiPlatform.QueryContactCenterQuota
google.longrunning.Operations.GetOperation
google.longrunning.Operations.ListOperations
ADMIN_WRITE google.cloud.contactcenteraiplatform.v1alpha1.ContactCenterAiPlatform.CreateContactCenter
google.cloud.contactcenteraiplatform.v1alpha1.ContactCenterAiPlatform.DeleteContactCenter
google.cloud.contactcenteraiplatform.v1alpha1.ContactCenterAiPlatform.UpdateContactCenter
google.longrunning.Operations.CancelOperation
google.longrunning.Operations.DeleteOperation

API interface audit logs

For information about how and which permissions are evaluated for each method, see the Identity and Access Management documentation for Contact Center AI Platform.

google.cloud.contactcenteraiplatform.v1alpha1.ContactCenterAiPlatform

The following audit logs are associated with methods belonging to google.cloud.contactcenteraiplatform.v1alpha1.ContactCenterAiPlatform.

CreateContactCenter

  • Method: google.cloud.contactcenteraiplatform.v1alpha1.ContactCenterAiPlatform.CreateContactCenter
  • Audit log type: Admin activity
  • Permissions:
    • contactcenteraiplatform.contactCenters.create - ADMIN_WRITE
  • Method is a long-running or streaming operation: Long-running operation
  • Filter for this method: protoPayload.methodName="google.cloud.contactcenteraiplatform.v1alpha1.ContactCenterAiPlatform.CreateContactCenter"

DeleteContactCenter

  • Method: google.cloud.contactcenteraiplatform.v1alpha1.ContactCenterAiPlatform.DeleteContactCenter
  • Audit log type: Admin activity
  • Permissions:
    • contactcenteraiplatform.contactCenters.delete - ADMIN_WRITE
  • Method is a long-running or streaming operation: Long-running operation
  • Filter for this method: protoPayload.methodName="google.cloud.contactcenteraiplatform.v1alpha1.ContactCenterAiPlatform.DeleteContactCenter"

GetContactCenter

  • Method: google.cloud.contactcenteraiplatform.v1alpha1.ContactCenterAiPlatform.GetContactCenter
  • Audit log type: Data access
  • Permissions:
    • contactcenteraiplatform.contactCenters.get - ADMIN_READ
  • Method is a long-running or streaming operation: No.
  • Filter for this method: protoPayload.methodName="google.cloud.contactcenteraiplatform.v1alpha1.ContactCenterAiPlatform.GetContactCenter"

ListContactCenters

  • Method: google.cloud.contactcenteraiplatform.v1alpha1.ContactCenterAiPlatform.ListContactCenters
  • Audit log type: Data access
  • Permissions:
    • contactcenteraiplatform.contactCenters.list - ADMIN_READ
  • Method is a long-running or streaming operation: No.
  • Filter for this method: protoPayload.methodName="google.cloud.contactcenteraiplatform.v1alpha1.ContactCenterAiPlatform.ListContactCenters"

QueryContactCenterQuota

  • Method: google.cloud.contactcenteraiplatform.v1alpha1.ContactCenterAiPlatform.QueryContactCenterQuota
  • Audit log type: Data access
  • Permissions:
    • contactcenteraiplatform.contactCenters.queryQuota - ADMIN_READ
  • Method is a long-running or streaming operation: No.
  • Filter for this method: protoPayload.methodName="google.cloud.contactcenteraiplatform.v1alpha1.ContactCenterAiPlatform.QueryContactCenterQuota"

UpdateContactCenter

  • Method: google.cloud.contactcenteraiplatform.v1alpha1.ContactCenterAiPlatform.UpdateContactCenter
  • Audit log type: Admin activity
  • Permissions:
    • contactcenteraiplatform.contactCenters.update - ADMIN_WRITE
  • Method is a long-running or streaming operation: Long-running operation
  • Filter for this method: protoPayload.methodName="google.cloud.contactcenteraiplatform.v1alpha1.ContactCenterAiPlatform.UpdateContactCenter"

google.longrunning.Operations

The following audit logs are associated with methods belonging to google.longrunning.Operations.

CancelOperation

  • Method: google.longrunning.Operations.CancelOperation
  • Audit log type: Admin activity
  • Permissions:
    • contactcenteraiplatform.operations.cancel - ADMIN_WRITE
  • Method is a long-running or streaming operation: No.
  • Filter for this method: protoPayload.methodName="google.longrunning.Operations.CancelOperation"

DeleteOperation

  • Method: google.longrunning.Operations.DeleteOperation
  • Audit log type: Admin activity
  • Permissions:
    • contactcenteraiplatform.operations.delete - ADMIN_WRITE
  • Method is a long-running or streaming operation: No.
  • Filter for this method: protoPayload.methodName="google.longrunning.Operations.DeleteOperation"

GetOperation

  • Method: google.longrunning.Operations.GetOperation
  • Audit log type: Data access
  • Permissions:
    • contactcenteraiplatform.operations.get - ADMIN_READ
  • Method is a long-running or streaming operation: No.
  • Filter for this method: protoPayload.methodName="google.longrunning.Operations.GetOperation"

ListOperations

  • Method: google.longrunning.Operations.ListOperations
  • Audit log type: Data access
  • Permissions:
    • contactcenteraiplatform.operations.list - ADMIN_READ
  • Method is a long-running or streaming operation: No.
  • Filter for this method: protoPayload.methodName="google.longrunning.Operations.ListOperations"

Methods that don't produce audit logs

A method might not produce audit logs for one or more of the following reasons:

  • It is a high volume method involving signifcant log generation and storage costs.
  • It has low auditing value.
  • Another audit or platform log already provides method coverage.

The following methods don't produce audit logs:

  • google.cloud.location.Locations.GetLocation
  • google.cloud.location.Locations.ListLocations
  • google.longrunning.Operations.WaitOperation