Skip to content

Rename Google Stackdriver task log handler to Cloud Logging - #73575

Open
shahar1 wants to merge 1 commit into
apache:mainfrom
shahar1:rename-google-stackdriver-logging
Open

shahar1 wants to merge 1 commit into
apache:mainfrom
shahar1:rename-google-stackdriver-logging

Conversation

@shahar1

@shahar1 shahar1 commented Sep 22, 2026

Copy link
Copy Markdown
Contributor

related: #61009

AI Summary

Renames the Google provider's task log handler from StackdriverTaskHandler / StackdriverRemoteLogIO (module airflow.providers.google.cloud.log.stackdriver_task_handler) to CloudLoggingTaskHandler / CloudLoggingRemoteLogIO (module airflow.providers.google.cloud.log.cloud_logging_task_handler), matching the API it calls (Cloud Logging API v2). Follow-up to #73354, which renamed the Cloud Monitoring hook, operators and links.

  • Old module and class names stay as deprecated aliases (subclasses that emit AirflowProviderDeprecationWarning on instantiation, planned removal March 31, 2027), with the same mechanics and date as Rename Google Stackdriver operators and hook to Cloud Monitoring #73354.
  • The stackdriver:// remote-logging scheme is unchanged, so existing remote_base_log_folder values keep working.
  • Docs page moved to logging/cloud_logging.rst with a redirect; the old Sphinx labels are preserved.
  • Observable deltas on the deprecated path: StackdriverTaskHandler().io is now a CloudLoggingRemoteLogIO, and LOG_NAME (the UI's external log label) reads "Google Cloud Logging".
  • Core's airflow_local_settings.py still instantiates StackdriverRemoteLogIO for stackdriver://, so a released core paired with this provider logs one deprecation warning at startup until a core follow-up switches that import to CloudLoggingRemoteLogIO.

Verification: providers/google/tests/unit/google/cloud/log/ (90 passed), airflow-core/tests/unit/config_templates/test_airflow_local_settings.py (24 passed), prek pre-commit and manual stages, breeze build-docs --package-filter apache-airflow-providers-google (0 warnings).


Was generative AI tooling used to co-author this PR?
  • Yes — Claude Code (Fable 5.1, with Sonnet 5 and Opus 5 subagents)

Generated-by: Claude Code (Fable 5.1, with Sonnet 5 and Opus 5 subagents) following the guidelines

@shahar1
shahar1 requested a review from potiuk September 22, 2026 20:11
Google retired the "Stackdriver" brand years ago. This handler only calls
the Cloud Logging API v2 (google.cloud.logging, LoggingServiceV2Client),
distinct from the Cloud Monitoring API v3 that the hook, operators and
links call, which were already renamed to CloudMonitoring* in a prior
change. Rename this handler to match, for the same reason.

StackdriverRemoteLogIO and StackdriverTaskHandler remain importable as
deprecated aliases of CloudLoggingRemoteLogIO and CloudLoggingTaskHandler
until March 31, 2027, per the provider's deprecation policy. The
stackdriver:// remote-logging scheme is unchanged, so existing
remote_base_log_folder configuration keeps working without edits.

Core's airflow_local_settings.py still imports and instantiates the
now-deprecated StackdriverRemoteLogIO for that scheme, so a released core
paired with this provider emits one deprecation warning at startup until a
follow-up core change switches to CloudLoggingRemoteLogIO.

Part of the rename tracked in apache#61009.
@shahar1
shahar1 force-pushed the rename-google-stackdriver-logging branch from 2e4dfdc to 8645487 Compare September 22, 2026 21:39

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant