Maintenance notifications and logs

Managed Lustre provides email notifications and Cloud Logging records to help you track automated maintenance events across your instances.

Email notifications

You can subscribe to email notifications for upcoming automated maintenance events to plan for potential disruption. Subscriptions to maintenance notifications are managed through your Google Cloud console Communication page:

Go to the Communication page

Once subscribed, email notifications are sent based on whether a maintenance policy is configured for the instance.

Instances with a maintenance policy receive the following notifications:

  • Advance notification: Sent 7 to 14 days before a scheduled maintenance event, or after a maintenance event has been rescheduled.
  • Canceled: Sent if a scheduled maintenance event is canceled by Google, rescheduled, or automatically canceled following a successful self-service upgrade.
  • In progress: Sent when a scheduled maintenance event starts.
  • Completed: Sent when a scheduled maintenance event is completed.

Instances without a maintenance policy receive In progress and Completed notifications when automated maintenance occurs.

Self-service maintenance doesn't send email notifications or write maintenance logs. See Track maintenance progress for how to monitor self-service maintenance progress.

View maintenance logs

Managed Lustre uses Cloud Logging to log maintenance events, including the following activity types:

  • LustreAdvancedNotification: Maintenance has been scheduled for the instance. Only sent for instances with a maintenance policy.
  • LustreOngoingNotification: Maintenance has started on the instance. Once complete, another LustreOngoingNotification event is logged with is_completed=true.
  • LustreCancelledNotification: Maintenance has been cancelled. Only sent for instances with a maintenance policy.

You can view maintenance logs using Logs Explorer or by using gcloud CLI.

Logs Explorer

To view Managed Lustre maintenance logs using Logs Explorer, do the following:

  1. In the Google Cloud console, go to the Cloud Logging > Logs Explorer page:

    Go to Logs Explorer

  2. Enter the following filter into the query editor and click Run query:

    resource.type="lustre.googleapis.com/Instance"
resource.labels.instance_id="INSTANCE_ID"
resource.labels.location="LOCATION"
logName="projects/PROJECT_ID/logs/lustre.googleapis.com%2Fmaintenance"

    Replace the following:

    • INSTANCE_ID: The ID of your Managed Lustre instance.
    • LOCATION: The location of your Managed Lustre instance.
    • PROJECT_ID: The ID of your Google Cloud project.

gcloud CLI

To view maintenance logs with gcloud CLI, run the gcloud logging read command:

gcloud logging read 'resource.type="lustre.googleapis.com/Instance" resource.labels.instance_id="INSTANCE_ID" resource.labels.location="LOCATION" logName="projects/PROJECT_ID/logs/lustre.googleapis.com%2Fmaintenance"' --project=PROJECT_ID

Replace the following:

  • INSTANCE_ID: The ID of the Managed Lustre instance.
  • LOCATION: The zone where the instance is located.
  • PROJECT_ID: The project ID of the project where the instance is located.

What's next