View Ray Operator logs on GKE

Autopilot Standard

This page shows you how to read Ray Operator logs on Google Kubernetes Engine (GKE) using Cloud Logging when you use the Ray Operator on GKE.

Before you begin

Before you start, make sure that you have performed the following tasks:

If you want to use the Google Cloud CLI for this task, install and then initialize the gcloud CLI. If you previously installed the gcloud CLI, get the latest version by running gcloud components update.
Note: For existing gcloud CLI installations, make sure to set the compute/region property. If you use primarily zonal clusters, set the compute/zone instead. By setting a default ___location, you can avoid errors in the gcloud CLI like the following: One of [--zone, --region] must be supplied: Please specify ___location. You might need to specify the ___location in certain commands if the ___location of your cluster differs from the default that you set.

Ray Operator logs are available on GKE cluster versions 1.33.1-gke.1231000 or later.

When enabling the Ray Operator on GKE, the operator logs are automatically available in Cloud Logging.

To view the logs, follow these steps:

In the Google Cloud console, go to the Logs Explorer page.

Open the Logs Explorer
Open the query editor. In the query editor, enter your expression and click Run query.

You can use the following example query in the Logs Explorer:
```
   resource.type="k8s_control_plane_component"
   resource.labels.cluster_name="CLUSTER_NAME"
   resource.labels.___location="CLUSTER_LOCATION"
   logName="projects/"PROJECT_NAME"/logs/container.googleapis.com%2Fray-operator"
```
Replace the following values:
- CLUSTER_NAME: the name of your GKE cluster.
- CLUSTER_LOCATION: the Compute Engine ___location of the control plane of your cluster. Provide a region for regional clusters, or a zone for zonal clusters.
- PROJECT_NAME: your Google Cloud project ID.
The query returns logs related to the Ray Operator addon, such as the status of the Ray cluster, the creation of the Ray resources, and the reconciliation of the Ray resources.