Nest Engineering Docs
Watcher

Overview

Python 3.13 pipeline stall detector

Watcher is a Python 3.13 Cloud Run Job that checks Spanner pipeline metadata and logs warnings when pipelines appear stalled.

Job profile

FieldValue
Codejobs/watcher/
Packagewatcher
RuntimePython 3.13 (Cloud Run Job)
StatusActive
Primary ownerJoe Pardi
Secondary ownerNone
TriggerCloud Run Job (manual or scheduler)
Data sourceCloud Spanner (Pipelines)
OutputLogs + Sentry

Purpose

  • Detect pipelines that have not updated within their expected delay windows.
  • Provide lightweight monitoring for potential ingestion stalls.

Non-goals

  • Scheduling or repairing pipelines.
  • Publishing metrics beyond logs and Sentry.

Inputs and outputs

  • Inputs: Spanner Pipelines and Organizations.
  • Outputs: Logs and Sentry errors for stalled pipelines.

Last updated on