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