This page describes Google Cloud platform logs created by
Cloud Workstations.

## Overview

Cloud Logging receives, indexes, and stores platform log entries from
Google Cloud services, such as Cloud Workstations. Platform logs are
system-defined, service-specific logs that can help you debug and troubleshoot
issues, as well as better understand the Google Cloud
services you're using.

User-defined
[audit logging](https://docs.cloud.google.com/workstations/docs/audit-logging)
is chargeable and logs activity when a user updates resources.
[Platform logging](https://docs.cloud.google.com/logging/docs/api/platform-logs),
however, is non-chargeable and logs activity when Cloud Workstations assigns
resources to a workstation.

Cloud Workstations creates the following types of platform logs:

- **Disk assignments:** Logs when Cloud Workstations assigns a persistent disk
  to a workstation. The `logName` field of this platform log ends with
  `disk_assignments` and can be selected by updating the Logs Explorer
  with the query `logName=projects/$PROJECT/logs/workstations.googleapis.com%2Fdisk_assignments`.

- **Instance assignments:** Logs when Cloud Workstations assigns a VM instance
  to a workstation. These logs contain the VM name, VM ID, internal IP address,
  and external IP address (if present). The `logName` field of this platform
  log ends with `vm_assignments` and can be selected by updating the
  Logs Explorer with the query
  `logName=projects/$PROJECT/logs/workstations.googleapis.com%2Fvm_assignments`.

- **Workstation shutdowns:** Logs when Cloud Workstations shuts down a workstation
  and unassigns the VM instance. These logs contain the VM name, VM ID, internal IP address,
  and external IP address (if present). The `logName` field of this platform
  log ends with `workstation_shutdowns` and can be selected by updating the
  Logs Explorer with the query
  `logName=projects/$PROJECT/logs/workstations.googleapis.com%2Fworkstation_shutdowns`.

For information about how to view Cloud Workstations logs in
[Logs Explorer](https://docs.cloud.google.com/logging/docs/view/logs-explorer-interface),
see
[View logs](https://docs.cloud.google.com/workstations/docs/audit-logging#viewing_logs).

## What's next

- Learn more about
  [Cloud Workstations logging API](https://docs.cloud.google.com/logging/docs/api/platform-logs#workstations).

- Understand and manage
  [Google Cloud platform logs](https://docs.cloud.google.com/logging/docs/api/platform-logs#managing-logs).

- Learn more about
  [Cloud Workstations audit logging](https://docs.cloud.google.com/workstations/docs/audit-logging).