Cloud TPU audit logging

This document describes audit logging for Cloud TPU. Google Cloud services write audit logs that record administrative activities and accesses within your Google Cloud resources. For more information, see Cloud Audit Logs overview.

Service name

Cloud TPU audit logs use the service name tpu.googleapis.com.

Methods by permission type

Methods that check DATA_READ, DATA_WRITE, and ADMIN_READ permission types generate Data Access audit logs. Methods that check ADMIN_WRITE permission types generate Admin Activity audit logs.

Permission type Methods
ADMIN_READ google.cloud.tpu.v1.Tpu.GetNode
google.cloud.tpu.v1.Tpu.ListNodes
google.cloud.tpu.v1alpha1.Tpu.GetNode
google.cloud.tpu.v1alpha1.Tpu.ListNodes
google.cloud.tpu.v2.Tpu.GetGuestAttributes
google.cloud.tpu.v2.Tpu.GetNode
google.cloud.tpu.v2.Tpu.GetQueuedResource
google.cloud.tpu.v2.Tpu.ListNodes
google.cloud.tpu.v2.Tpu.ListQueuedResources
google.cloud.tpu.v2alpha1.Tpu.GetGuestAttributes
google.cloud.tpu.v2alpha1.Tpu.GetNode
google.cloud.tpu.v2alpha1.Tpu.GetQueuedResource
google.cloud.tpu.v2alpha1.Tpu.ListNodes
google.cloud.tpu.v2alpha1.Tpu.ListQueuedResources
google.cloud.tpu.v2alpha1.Tpu.ListReservations
ADMIN_WRITE google.cloud.tpu.v1.Tpu.CreateNode
google.cloud.tpu.v1.Tpu.DeleteNode
google.cloud.tpu.v1.Tpu.ReimageNode
google.cloud.tpu.v1.Tpu.StartNode
google.cloud.tpu.v1.Tpu.StopNode
google.cloud.tpu.v1alpha1.Tpu.CreateNode
google.cloud.tpu.v1alpha1.Tpu.DeleteNode
google.cloud.tpu.v1alpha1.Tpu.ReimageNode
google.cloud.tpu.v1alpha1.Tpu.StartNode
google.cloud.tpu.v1alpha1.Tpu.StopNode
google.cloud.tpu.v2.Tpu.CreateNode
google.cloud.tpu.v2.Tpu.CreateQueuedResource
google.cloud.tpu.v2.Tpu.DeleteNode
google.cloud.tpu.v2.Tpu.DeleteQueuedResource
google.cloud.tpu.v2.Tpu.ResetQueuedResource
google.cloud.tpu.v2.Tpu.StartNode
google.cloud.tpu.v2.Tpu.StopNode
google.cloud.tpu.v2.Tpu.UpdateNode
google.cloud.tpu.v2alpha1.Tpu.CreateNode
google.cloud.tpu.v2alpha1.Tpu.CreateQueuedResource
google.cloud.tpu.v2alpha1.Tpu.DeleteNode
google.cloud.tpu.v2alpha1.Tpu.DeleteQueuedResource
google.cloud.tpu.v2alpha1.Tpu.ResetQueuedResource
google.cloud.tpu.v2alpha1.Tpu.SimulateMaintenanceEvent
google.cloud.tpu.v2alpha1.Tpu.StartNode
google.cloud.tpu.v2alpha1.Tpu.StopNode
google.cloud.tpu.v2alpha1.Tpu.UpdateNode

Audit logs per API interface

For more information about which permissions are evaluated for each method, see the Identity and Access Management documentation for Cloud TPU.

google.cloud.tpu.v1.Tpu

The following section contains details about audit logs associated with methods belonging to google.cloud.tpu.v1.Tpu.

google.cloud.tpu.v1.Tpu.CreateNode

  • Method: google.cloud.tpu.v1.Tpu.CreateNode
  • Audit log Type: Admin activity
  • Permissions:
    • tpu.nodes.create - ADMIN_WRITE
  • Method is a long running or streaming operation: Long running operation
  • Filter for this method: protoPayload.methodName="google.cloud.tpu.v1.Tpu.CreateNode"

google.cloud.tpu.v1.Tpu.DeleteNode

  • Method: google.cloud.tpu.v1.Tpu.DeleteNode
  • Audit log Type: Admin activity
  • Permissions:
    • tpu.nodes.delete - ADMIN_WRITE
  • Method is a long running or streaming operation: Long running operation
  • Filter for this method: protoPayload.methodName="google.cloud.tpu.v1.Tpu.DeleteNode"

google.cloud.tpu.v1.Tpu.GetNode

  • Method: google.cloud.tpu.v1.Tpu.GetNode
  • Audit log Type: Data access
  • Permissions:
    • tpu.nodes.get - ADMIN_READ
  • Method is a long running or streaming operation: No.
  • Filter for this method: protoPayload.methodName="google.cloud.tpu.v1.Tpu.GetNode"

google.cloud.tpu.v1.Tpu.ListNodes

  • Method: google.cloud.tpu.v1.Tpu.ListNodes
  • Audit log Type: Data access
  • Permissions:
    • tpu.nodes.list - ADMIN_READ
  • Method is a long running or streaming operation: No.
  • Filter for this method: protoPayload.methodName="google.cloud.tpu.v1.Tpu.ListNodes"

google.cloud.tpu.v1.Tpu.ReimageNode

  • Method: google.cloud.tpu.v1.Tpu.ReimageNode
  • Audit log Type: Admin activity
  • Permissions:
    • tpu.nodes.reimage - ADMIN_WRITE
  • Method is a long running or streaming operation: Long running operation
  • Filter for this method: protoPayload.methodName="google.cloud.tpu.v1.Tpu.ReimageNode"

google.cloud.tpu.v1.Tpu.StartNode

  • Method: google.cloud.tpu.v1.Tpu.StartNode
  • Audit log Type: Admin activity
  • Permissions:
    • tpu.nodes.start - ADMIN_WRITE
  • Method is a long running or streaming operation: Long running operation
  • Filter for this method: protoPayload.methodName="google.cloud.tpu.v1.Tpu.StartNode"

google.cloud.tpu.v1.Tpu.StopNode

  • Method: google.cloud.tpu.v1.Tpu.StopNode
  • Audit log Type: Admin activity
  • Permissions:
    • tpu.nodes.stop - ADMIN_WRITE
  • Method is a long running or streaming operation: Long running operation
  • Filter for this method: protoPayload.methodName="google.cloud.tpu.v1.Tpu.StopNode"

google.cloud.tpu.v1alpha1.Tpu

The following section contains details about audit logs associated with methods belonging to google.cloud.tpu.v1alpha1.Tpu.

google.cloud.tpu.v1alpha1.Tpu.CreateNode

  • Method: google.cloud.tpu.v1alpha1.Tpu.CreateNode
  • Audit log Type: Admin activity
  • Permissions:
    • tpu.nodes.create - ADMIN_WRITE
  • Method is a long running or streaming operation: Long running operation
  • Filter for this method: protoPayload.methodName="google.cloud.tpu.v1alpha1.Tpu.CreateNode"

google.cloud.tpu.v1alpha1.Tpu.DeleteNode

  • Method: google.cloud.tpu.v1alpha1.Tpu.DeleteNode
  • Audit log Type: Admin activity
  • Permissions:
    • tpu.nodes.delete - ADMIN_WRITE
  • Method is a long running or streaming operation: Long running operation
  • Filter for this method: protoPayload.methodName="google.cloud.tpu.v1alpha1.Tpu.DeleteNode"

google.cloud.tpu.v1alpha1.Tpu.GetNode

  • Method: google.cloud.tpu.v1alpha1.Tpu.GetNode
  • Audit log Type: Data access
  • Permissions:
    • tpu.nodes.get - ADMIN_READ
  • Method is a long running or streaming operation: No.
  • Filter for this method: protoPayload.methodName="google.cloud.tpu.v1alpha1.Tpu.GetNode"

google.cloud.tpu.v1alpha1.Tpu.ListNodes

  • Method: google.cloud.tpu.v1alpha1.Tpu.ListNodes
  • Audit log Type: Data access
  • Permissions:
    • tpu.nodes.list - ADMIN_READ
  • Method is a long running or streaming operation: No.
  • Filter for this method: protoPayload.methodName="google.cloud.tpu.v1alpha1.Tpu.ListNodes"

google.cloud.tpu.v1alpha1.Tpu.ReimageNode

  • Method: google.cloud.tpu.v1alpha1.Tpu.ReimageNode
  • Audit log Type: Admin activity
  • Permissions:
    • tpu.nodes.reimage - ADMIN_WRITE
  • Method is a long running or streaming operation: Long running operation
  • Filter for this method: protoPayload.methodName="google.cloud.tpu.v1alpha1.Tpu.ReimageNode"

google.cloud.tpu.v1alpha1.Tpu.StartNode

  • Method: google.cloud.tpu.v1alpha1.Tpu.StartNode
  • Audit log Type: Admin activity
  • Permissions:
    • tpu.nodes.start - ADMIN_WRITE
  • Method is a long running or streaming operation: Long running operation
  • Filter for this method: protoPayload.methodName="google.cloud.tpu.v1alpha1.Tpu.StartNode"

google.cloud.tpu.v1alpha1.Tpu.StopNode

  • Method: google.cloud.tpu.v1alpha1.Tpu.StopNode
  • Audit log Type: Admin activity
  • Permissions:
    • tpu.nodes.stop - ADMIN_WRITE
  • Method is a long running or streaming operation: Long running operation
  • Filter for this method: protoPayload.methodName="google.cloud.tpu.v1alpha1.Tpu.StopNode"

google.cloud.tpu.v2.Tpu

The following section contains details about audit logs associated with methods belonging to google.cloud.tpu.v2.Tpu.

google.cloud.tpu.v2.Tpu.CreateNode

  • Method: google.cloud.tpu.v2.Tpu.CreateNode
  • Audit log Type: Admin activity
  • Permissions:
    • tpu.nodes.create - ADMIN_WRITE
  • Method is a long running or streaming operation: Long running operation
  • Filter for this method: protoPayload.methodName="google.cloud.tpu.v2.Tpu.CreateNode"

google.cloud.tpu.v2.Tpu.CreateQueuedResource

  • Method: google.cloud.tpu.v2.Tpu.CreateQueuedResource
  • Audit log Type: Admin activity
  • Permissions:
    • tpu.nodes.create - ADMIN_WRITE
  • Method is a long running or streaming operation: Long running operation
  • Filter for this method: protoPayload.methodName="google.cloud.tpu.v2.Tpu.CreateQueuedResource"

google.cloud.tpu.v2.Tpu.DeleteNode

  • Method: google.cloud.tpu.v2.Tpu.DeleteNode
  • Audit log Type: Admin activity
  • Permissions:
    • tpu.nodes.delete - ADMIN_WRITE
  • Method is a long running or streaming operation: Long running operation
  • Filter for this method: protoPayload.methodName="google.cloud.tpu.v2.Tpu.DeleteNode"

google.cloud.tpu.v2.Tpu.DeleteQueuedResource

  • Method: google.cloud.tpu.v2.Tpu.DeleteQueuedResource
  • Audit log Type: Admin activity
  • Permissions:
    • tpu.nodes.delete - ADMIN_WRITE
  • Method is a long running or streaming operation: Long running operation
  • Filter for this method: protoPayload.methodName="google.cloud.tpu.v2.Tpu.DeleteQueuedResource"

google.cloud.tpu.v2.Tpu.GetGuestAttributes

  • Method: google.cloud.tpu.v2.Tpu.GetGuestAttributes
  • Audit log Type: Data access
  • Permissions:
    • tpu.nodes.get - ADMIN_READ
  • Method is a long running or streaming operation: No.
  • Filter for this method: protoPayload.methodName="google.cloud.tpu.v2.Tpu.GetGuestAttributes"

google.cloud.tpu.v2.Tpu.GetNode

  • Method: google.cloud.tpu.v2.Tpu.GetNode
  • Audit log Type: Data access
  • Permissions:
    • tpu.nodes.get - ADMIN_READ
  • Method is a long running or streaming operation: No.
  • Filter for this method: protoPayload.methodName="google.cloud.tpu.v2.Tpu.GetNode"

google.cloud.tpu.v2.Tpu.GetQueuedResource

  • Method: google.cloud.tpu.v2.Tpu.GetQueuedResource
  • Audit log Type: Data access
  • Permissions:
    • tpu.nodes.get - ADMIN_READ
  • Method is a long running or streaming operation: No.
  • Filter for this method: protoPayload.methodName="google.cloud.tpu.v2.Tpu.GetQueuedResource"

google.cloud.tpu.v2.Tpu.ListNodes

  • Method: google.cloud.tpu.v2.Tpu.ListNodes
  • Audit log Type: Data access
  • Permissions:
    • tpu.nodes.list - ADMIN_READ
  • Method is a long running or streaming operation: No.
  • Filter for this method: protoPayload.methodName="google.cloud.tpu.v2.Tpu.ListNodes"

google.cloud.tpu.v2.Tpu.ListQueuedResources

  • Method: google.cloud.tpu.v2.Tpu.ListQueuedResources
  • Audit log Type: Data access
  • Permissions:
    • tpu.nodes.list - ADMIN_READ
  • Method is a long running or streaming operation: No.
  • Filter for this method: protoPayload.methodName="google.cloud.tpu.v2.Tpu.ListQueuedResources"

google.cloud.tpu.v2.Tpu.ResetQueuedResource

  • Method: google.cloud.tpu.v2.Tpu.ResetQueuedResource
  • Audit log Type: Admin activity
  • Permissions:
    • tpu.nodes.reset - ADMIN_WRITE
  • Method is a long running or streaming operation: Long running operation
  • Filter for this method: protoPayload.methodName="google.cloud.tpu.v2.Tpu.ResetQueuedResource"

google.cloud.tpu.v2.Tpu.StartNode

  • Method: google.cloud.tpu.v2.Tpu.StartNode
  • Audit log Type: Admin activity
  • Permissions:
    • tpu.nodes.start - ADMIN_WRITE
  • Method is a long running or streaming operation: Long running operation
  • Filter for this method: protoPayload.methodName="google.cloud.tpu.v2.Tpu.StartNode"

google.cloud.tpu.v2.Tpu.StopNode

  • Method: google.cloud.tpu.v2.Tpu.StopNode
  • Audit log Type: Admin activity
  • Permissions:
    • tpu.nodes.stop - ADMIN_WRITE
  • Method is a long running or streaming operation: Long running operation
  • Filter for this method: protoPayload.methodName="google.cloud.tpu.v2.Tpu.StopNode"

google.cloud.tpu.v2.Tpu.UpdateNode

  • Method: google.cloud.tpu.v2.Tpu.UpdateNode
  • Audit log Type: Admin activity
  • Permissions:
    • tpu.nodes.update - ADMIN_WRITE
  • Method is a long running or streaming operation: Long running operation
  • Filter for this method: protoPayload.methodName="google.cloud.tpu.v2.Tpu.UpdateNode"

google.cloud.tpu.v2alpha1.Tpu

The following section contains details about audit logs associated with methods belonging to google.cloud.tpu.v2alpha1.Tpu.

google.cloud.tpu.v2alpha1.Tpu.CreateNode

  • Method: google.cloud.tpu.v2alpha1.Tpu.CreateNode
  • Audit log Type: Admin activity
  • Permissions:
    • tpu.nodes.create - ADMIN_WRITE
  • Method is a long running or streaming operation: Long running operation
  • Filter for this method: protoPayload.methodName="google.cloud.tpu.v2alpha1.Tpu.CreateNode"

google.cloud.tpu.v2alpha1.Tpu.CreateQueuedResource

  • Method: google.cloud.tpu.v2alpha1.Tpu.CreateQueuedResource
  • Audit log Type: Admin activity
  • Permissions:
    • tpu.nodes.create - ADMIN_WRITE
  • Method is a long running or streaming operation: Long running operation
  • Filter for this method: protoPayload.methodName="google.cloud.tpu.v2alpha1.Tpu.CreateQueuedResource"

google.cloud.tpu.v2alpha1.Tpu.DeleteNode

  • Method: google.cloud.tpu.v2alpha1.Tpu.DeleteNode
  • Audit log Type: Admin activity
  • Permissions:
    • tpu.nodes.delete - ADMIN_WRITE
  • Method is a long running or streaming operation: Long running operation
  • Filter for this method: protoPayload.methodName="google.cloud.tpu.v2alpha1.Tpu.DeleteNode"

google.cloud.tpu.v2alpha1.Tpu.DeleteQueuedResource

  • Method: google.cloud.tpu.v2alpha1.Tpu.DeleteQueuedResource
  • Audit log Type: Admin activity
  • Permissions:
    • tpu.nodes.delete - ADMIN_WRITE
  • Method is a long running or streaming operation: Long running operation
  • Filter for this method: protoPayload.methodName="google.cloud.tpu.v2alpha1.Tpu.DeleteQueuedResource"

google.cloud.tpu.v2alpha1.Tpu.GetGuestAttributes

  • Method: google.cloud.tpu.v2alpha1.Tpu.GetGuestAttributes
  • Audit log Type: Data access
  • Permissions:
    • tpu.nodes.get - ADMIN_READ
  • Method is a long running or streaming operation: No.
  • Filter for this method: protoPayload.methodName="google.cloud.tpu.v2alpha1.Tpu.GetGuestAttributes"

google.cloud.tpu.v2alpha1.Tpu.GetNode

  • Method: google.cloud.tpu.v2alpha1.Tpu.GetNode
  • Audit log Type: Data access
  • Permissions:
    • tpu.nodes.get - ADMIN_READ
  • Method is a long running or streaming operation: No.
  • Filter for this method: protoPayload.methodName="google.cloud.tpu.v2alpha1.Tpu.GetNode"

google.cloud.tpu.v2alpha1.Tpu.GetQueuedResource

  • Method: google.cloud.tpu.v2alpha1.Tpu.GetQueuedResource
  • Audit log Type: Data access
  • Permissions:
    • tpu.nodes.get - ADMIN_READ
  • Method is a long running or streaming operation: No.
  • Filter for this method: protoPayload.methodName="google.cloud.tpu.v2alpha1.Tpu.GetQueuedResource"

google.cloud.tpu.v2alpha1.Tpu.ListNodes

  • Method: google.cloud.tpu.v2alpha1.Tpu.ListNodes
  • Audit log Type: Data access
  • Permissions:
    • tpu.nodes.list - ADMIN_READ
  • Method is a long running or streaming operation: No.
  • Filter for this method: protoPayload.methodName="google.cloud.tpu.v2alpha1.Tpu.ListNodes"

google.cloud.tpu.v2alpha1.Tpu.ListQueuedResources

  • Method: google.cloud.tpu.v2alpha1.Tpu.ListQueuedResources
  • Audit log Type: Data access
  • Permissions:
    • tpu.nodes.list - ADMIN_READ
  • Method is a long running or streaming operation: No.
  • Filter for this method: protoPayload.methodName="google.cloud.tpu.v2alpha1.Tpu.ListQueuedResources"

google.cloud.tpu.v2alpha1.Tpu.ListReservations

  • Method: google.cloud.tpu.v2alpha1.Tpu.ListReservations
  • Audit log Type: Data access
  • Permissions:
    • tpu.nodes.get - ADMIN_READ
  • Method is a long running or streaming operation: No.
  • Filter for this method: protoPayload.methodName="google.cloud.tpu.v2alpha1.Tpu.ListReservations"

google.cloud.tpu.v2alpha1.Tpu.ResetQueuedResource

  • Method: google.cloud.tpu.v2alpha1.Tpu.ResetQueuedResource
  • Audit log Type: Admin activity
  • Permissions:
    • tpu.nodes.reset - ADMIN_WRITE
  • Method is a long running or streaming operation: Long running operation
  • Filter for this method: protoPayload.methodName="google.cloud.tpu.v2alpha1.Tpu.ResetQueuedResource"

google.cloud.tpu.v2alpha1.Tpu.SimulateMaintenanceEvent

  • Method: google.cloud.tpu.v2alpha1.Tpu.SimulateMaintenanceEvent
  • Audit log Type: Admin activity
  • Permissions:
    • tpu.nodes.simulateMaintenanceEvent - ADMIN_WRITE
  • Method is a long running or streaming operation: Long running operation
  • Filter for this method: protoPayload.methodName="google.cloud.tpu.v2alpha1.Tpu.SimulateMaintenanceEvent"

google.cloud.tpu.v2alpha1.Tpu.StartNode

  • Method: google.cloud.tpu.v2alpha1.Tpu.StartNode
  • Audit log Type: Admin activity
  • Permissions:
    • tpu.nodes.start - ADMIN_WRITE
  • Method is a long running or streaming operation: Long running operation
  • Filter for this method: protoPayload.methodName="google.cloud.tpu.v2alpha1.Tpu.StartNode"

google.cloud.tpu.v2alpha1.Tpu.StopNode

  • Method: google.cloud.tpu.v2alpha1.Tpu.StopNode
  • Audit log Type: Admin activity
  • Permissions:
    • tpu.nodes.stop - ADMIN_WRITE
  • Method is a long running or streaming operation: Long running operation
  • Filter for this method: protoPayload.methodName="google.cloud.tpu.v2alpha1.Tpu.StopNode"

google.cloud.tpu.v2alpha1.Tpu.UpdateNode

  • Method: google.cloud.tpu.v2alpha1.Tpu.UpdateNode
  • Audit log Type: Admin activity
  • Permissions:
    • tpu.nodes.update - ADMIN_WRITE
  • Method is a long running or streaming operation: Long running operation
  • Filter for this method: protoPayload.methodName="google.cloud.tpu.v2alpha1.Tpu.UpdateNode"

System events

System Event audit logs are generated by GCP systems, not direct user action. For more information, see System Event audit logs.

Method Name Filter For This Event Notes
tpu.nodes.restart protoPayload.methodName="tpu.nodes.restart" Occurs when a terminated node is repaired and restarted.
tpu.nodes.terminate protoPayload.methodName="tpu.nodes.terminate" Occurs when a node has been terminated involuntarily, such as due to a maintenance event. The reason for termination is available in protoPayload.metadata.terminateReason.

Methods that don't produce audit logs

Generally methods don't produce audit logs because they are high volume and doing so would be very expensive to store, or because the method has low auditing value, or because another audit or platform log already provides coverage for what the method does.

The following methods don't produce audit logs:

  • google.cloud.location.Locations.GetLocation
  • google.cloud.location.Locations.ListLocations
  • google.cloud.tpu.v1.Tpu.GetAcceleratorType
  • google.cloud.tpu.v1.Tpu.GetTensorFlowVersion
  • google.cloud.tpu.v1.Tpu.ListAcceleratorTypes
  • google.cloud.tpu.v1.Tpu.ListTensorFlowVersions
  • google.cloud.tpu.v1alpha1.Tpu.GetAcceleratorType
  • google.cloud.tpu.v1alpha1.Tpu.GetTensorFlowVersion
  • google.cloud.tpu.v1alpha1.Tpu.ListAcceleratorTypes
  • google.cloud.tpu.v1alpha1.Tpu.ListTensorFlowVersions
  • google.cloud.tpu.v2.Tpu.GetAcceleratorType
  • google.cloud.tpu.v2.Tpu.GetRuntimeVersion
  • google.cloud.tpu.v2.Tpu.ListAcceleratorTypes
  • google.cloud.tpu.v2.Tpu.ListRuntimeVersions
  • google.cloud.tpu.v2alpha1.Tpu.GetAcceleratorType
  • google.cloud.tpu.v2alpha1.Tpu.GetRuntimeVersion
  • google.cloud.tpu.v2alpha1.Tpu.ListAcceleratorTypes
  • google.cloud.tpu.v2alpha1.Tpu.ListRuntimeVersions
  • google.longrunning.Operations.WaitOperation