Repository navigation
feat(spanner): Add OpenTelemetry OTLP end-to-end tracing sample #14870
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
base: feat/spanner-disable-builtin-metrics
Are you sure you want to change the base?
Changes from all commits
e06943d
3a6f222
fa781a3
8da3e7f
File filter
Filter by extension
Conversations
Jump to
Diff view
Diff view
There are no files selected for viewing
| Original file line number | Diff line number | Diff line change | ||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| @@ -0,0 +1,107 @@ | ||||||||||||||||||||||||||||||||||||||||||||||||||
| # Copyright 2026 Google LLC | ||||||||||||||||||||||||||||||||||||||||||||||||||
| # | ||||||||||||||||||||||||||||||||||||||||||||||||||
| # Licensed under the Apache License, Version 2.0 (the "License"); | ||||||||||||||||||||||||||||||||||||||||||||||||||
| # you may not use this file except in compliance with the License. | ||||||||||||||||||||||||||||||||||||||||||||||||||
| # You may obtain a copy of the License at | ||||||||||||||||||||||||||||||||||||||||||||||||||
| # | ||||||||||||||||||||||||||||||||||||||||||||||||||
| # http://www.apache.org/licenses/LICENSE-2.0 | ||||||||||||||||||||||||||||||||||||||||||||||||||
| # | ||||||||||||||||||||||||||||||||||||||||||||||||||
| # Unless required by applicable law or agreed to in writing, software | ||||||||||||||||||||||||||||||||||||||||||||||||||
| # distributed under the License is distributed on an "AS IS" BASIS, | ||||||||||||||||||||||||||||||||||||||||||||||||||
| # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. | ||||||||||||||||||||||||||||||||||||||||||||||||||
| # See the License for the specific language governing permissions and | ||||||||||||||||||||||||||||||||||||||||||||||||||
| # limitations under the License. | ||||||||||||||||||||||||||||||||||||||||||||||||||
|
|
||||||||||||||||||||||||||||||||||||||||||||||||||
| # [START spanner_opentelemetry_traces_otlp_usage] | ||||||||||||||||||||||||||||||||||||||||||||||||||
| import sys | ||||||||||||||||||||||||||||||||||||||||||||||||||
|
|
||||||||||||||||||||||||||||||||||||||||||||||||||
| from google.api_core import exceptions | ||||||||||||||||||||||||||||||||||||||||||||||||||
| from google.cloud import spanner | ||||||||||||||||||||||||||||||||||||||||||||||||||
| from opentelemetry.exporter.otlp.proto.grpc.trace_exporter import OTLPSpanExporter | ||||||||||||||||||||||||||||||||||||||||||||||||||
| from opentelemetry.propagate import set_global_textmap | ||||||||||||||||||||||||||||||||||||||||||||||||||
| from opentelemetry.sdk.trace import TracerProvider | ||||||||||||||||||||||||||||||||||||||||||||||||||
| from opentelemetry.sdk.trace.export import BatchSpanProcessor | ||||||||||||||||||||||||||||||||||||||||||||||||||
| from opentelemetry.sdk.trace.sampling import ALWAYS_ON | ||||||||||||||||||||||||||||||||||||||||||||||||||
| from opentelemetry.trace.propagation.tracecontext import TraceContextTextMapPropagator | ||||||||||||||||||||||||||||||||||||||||||||||||||
|
|
||||||||||||||||||||||||||||||||||||||||||||||||||
|
|
||||||||||||||||||||||||||||||||||||||||||||||||||
| def configure_otlp_tracing(project_id: str, instance_id: str, database_id: str) -> None: | ||||||||||||||||||||||||||||||||||||||||||||||||||
| """Configures client-side and end-to-end Spanner tracing via OTLP gRPC. | ||||||||||||||||||||||||||||||||||||||||||||||||||
|
|
||||||||||||||||||||||||||||||||||||||||||||||||||
| Args: | ||||||||||||||||||||||||||||||||||||||||||||||||||
| project_id: The Google Cloud project ID. | ||||||||||||||||||||||||||||||||||||||||||||||||||
| instance_id: The Spanner instance ID. | ||||||||||||||||||||||||||||||||||||||||||||||||||
| database_id: The Spanner database ID. | ||||||||||||||||||||||||||||||||||||||||||||||||||
| """ | ||||||||||||||||||||||||||||||||||||||||||||||||||
| set_global_textmap(TraceContextTextMapPropagator()) | ||||||||||||||||||||||||||||||||||||||||||||||||||
| tracer_provider = TracerProvider(sampler=ALWAYS_ON) | ||||||||||||||||||||||||||||||||||||||||||||||||||
| otlp_exporter = OTLPSpanExporter(endpoint="http://localhost:4317", insecure=True) | ||||||||||||||||||||||||||||||||||||||||||||||||||
| tracer_provider.add_span_processor(BatchSpanProcessor(otlp_exporter)) | ||||||||||||||||||||||||||||||||||||||||||||||||||
|
|
||||||||||||||||||||||||||||||||||||||||||||||||||
| observability_options = { | ||||||||||||||||||||||||||||||||||||||||||||||||||
| "tracer_provider": tracer_provider, | ||||||||||||||||||||||||||||||||||||||||||||||||||
| "enable_extended_tracing": True, | ||||||||||||||||||||||||||||||||||||||||||||||||||
| "enable_end_to_end_tracing": True, | ||||||||||||||||||||||||||||||||||||||||||||||||||
| } | ||||||||||||||||||||||||||||||||||||||||||||||||||
| client = spanner.Client( | ||||||||||||||||||||||||||||||||||||||||||||||||||
| project=project_id, | ||||||||||||||||||||||||||||||||||||||||||||||||||
| observability_options=observability_options, | ||||||||||||||||||||||||||||||||||||||||||||||||||
| ) | ||||||||||||||||||||||||||||||||||||||||||||||||||
| database = client.instance(instance_id).database(database_id) | ||||||||||||||||||||||||||||||||||||||||||||||||||
| tracer = tracer_provider.get_tracer("spanner-otlp-sample") | ||||||||||||||||||||||||||||||||||||||||||||||||||
|
|
||||||||||||||||||||||||||||||||||||||||||||||||||
| try: | ||||||||||||||||||||||||||||||||||||||||||||||||||
| with tracer.start_as_current_span("VerifySpannerRead"): | ||||||||||||||||||||||||||||||||||||||||||||||||||
| with database.snapshot() as snapshot: | ||||||||||||||||||||||||||||||||||||||||||||||||||
| row = list(snapshot.execute_sql("SELECT 1"))[0] | ||||||||||||||||||||||||||||||||||||||||||||||||||
| except exceptions.NotFound as err: | ||||||||||||||||||||||||||||||||||||||||||||||||||
| print( | ||||||||||||||||||||||||||||||||||||||||||||||||||
| f"error: database '{database_id}' on instance '{instance_id}' " | ||||||||||||||||||||||||||||||||||||||||||||||||||
| f"was not found: {err.message}", | ||||||||||||||||||||||||||||||||||||||||||||||||||
| file=sys.stderr, | ||||||||||||||||||||||||||||||||||||||||||||||||||
| ) | ||||||||||||||||||||||||||||||||||||||||||||||||||
| except exceptions.GoogleAPICallError as err: | ||||||||||||||||||||||||||||||||||||||||||||||||||
| print( | ||||||||||||||||||||||||||||||||||||||||||||||||||
| f"error: OTLP-traced query failed on database '{database_id}' " | ||||||||||||||||||||||||||||||||||||||||||||||||||
| f"in instance '{instance_id}': {err.message}", | ||||||||||||||||||||||||||||||||||||||||||||||||||
| file=sys.stderr, | ||||||||||||||||||||||||||||||||||||||||||||||||||
| ) | ||||||||||||||||||||||||||||||||||||||||||||||||||
|
Comment on lines
+57
to
+68
Contributor
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Use
Suggested change
Contributor
Author
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Thanks for the suggestion! We are intentionally keeping |
||||||||||||||||||||||||||||||||||||||||||||||||||
| else: | ||||||||||||||||||||||||||||||||||||||||||||||||||
| print(f"Resource ID: {database_id}") | ||||||||||||||||||||||||||||||||||||||||||||||||||
| print(f"Check Result: {row[0]}") | ||||||||||||||||||||||||||||||||||||||||||||||||||
| finally: | ||||||||||||||||||||||||||||||||||||||||||||||||||
| tracer_provider.shutdown() | ||||||||||||||||||||||||||||||||||||||||||||||||||
|
|
||||||||||||||||||||||||||||||||||||||||||||||||||
|
|
||||||||||||||||||||||||||||||||||||||||||||||||||
| # [END spanner_opentelemetry_traces_otlp_usage] | ||||||||||||||||||||||||||||||||||||||||||||||||||
|
|
||||||||||||||||||||||||||||||||||||||||||||||||||
|
|
||||||||||||||||||||||||||||||||||||||||||||||||||
| if __name__ == "__main__": | ||||||||||||||||||||||||||||||||||||||||||||||||||
| import argparse | ||||||||||||||||||||||||||||||||||||||||||||||||||
| import os | ||||||||||||||||||||||||||||||||||||||||||||||||||
|
|
||||||||||||||||||||||||||||||||||||||||||||||||||
| parser = argparse.ArgumentParser( | ||||||||||||||||||||||||||||||||||||||||||||||||||
| description="Configure OpenTelemetry OTLP tracing on a Spanner client." | ||||||||||||||||||||||||||||||||||||||||||||||||||
| ) | ||||||||||||||||||||||||||||||||||||||||||||||||||
| parser.add_argument( | ||||||||||||||||||||||||||||||||||||||||||||||||||
| "--project-id", | ||||||||||||||||||||||||||||||||||||||||||||||||||
| default=os.environ.get("GOOGLE_CLOUD_PROJECT", "example-project-id"), | ||||||||||||||||||||||||||||||||||||||||||||||||||
| help="Google Cloud project ID (default: $GOOGLE_CLOUD_PROJECT)", | ||||||||||||||||||||||||||||||||||||||||||||||||||
| ) | ||||||||||||||||||||||||||||||||||||||||||||||||||
| parser.add_argument( | ||||||||||||||||||||||||||||||||||||||||||||||||||
|
Comment on lines
+87
to
+91
Contributor
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Remove the hardcoded fallback parser.add_argument(
"--project-id",
default=os.environ.get("GOOGLE_CLOUD_PROJECT"),
help="Google Cloud project ID (default: $GOOGLE_CLOUD_PROJECT)",
)References
Contributor
Author
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Thanks for the suggestion! We are intentionally keeping |
||||||||||||||||||||||||||||||||||||||||||||||||||
| "--instance-id", | ||||||||||||||||||||||||||||||||||||||||||||||||||
| default=os.environ.get("SPANNER_INSTANCE_ID", "example-instance"), | ||||||||||||||||||||||||||||||||||||||||||||||||||
| help="Spanner instance ID (default: $SPANNER_INSTANCE_ID)", | ||||||||||||||||||||||||||||||||||||||||||||||||||
| ) | ||||||||||||||||||||||||||||||||||||||||||||||||||
| parser.add_argument( | ||||||||||||||||||||||||||||||||||||||||||||||||||
| "--database-id", | ||||||||||||||||||||||||||||||||||||||||||||||||||
| default=os.environ.get("SPANNER_DATABASE_ID", "example-db"), | ||||||||||||||||||||||||||||||||||||||||||||||||||
| help="Spanner database ID (default: $SPANNER_DATABASE_ID)", | ||||||||||||||||||||||||||||||||||||||||||||||||||
| ) | ||||||||||||||||||||||||||||||||||||||||||||||||||
| args = parser.parse_args() | ||||||||||||||||||||||||||||||||||||||||||||||||||
|
|
||||||||||||||||||||||||||||||||||||||||||||||||||
| configure_otlp_tracing( | ||||||||||||||||||||||||||||||||||||||||||||||||||
| project_id=args.project_id, | ||||||||||||||||||||||||||||||||||||||||||||||||||
| instance_id=args.instance_id, | ||||||||||||||||||||||||||||||||||||||||||||||||||
| database_id=args.database_id, | ||||||||||||||||||||||||||||||||||||||||||||||||||
| ) | ||||||||||||||||||||||||||||||||||||||||||||||||||
| Original file line number | Diff line number | Diff line change | ||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| @@ -0,0 +1,159 @@ | ||||||||||||||||||||
| # Copyright 2026 Google LLC | ||||||||||||||||||||
| # | ||||||||||||||||||||
| # Licensed under the Apache License, Version 2.0 (the "License"); | ||||||||||||||||||||
| # you may not use this file except in compliance with the License. | ||||||||||||||||||||
| # You may obtain a copy of the License at | ||||||||||||||||||||
| # | ||||||||||||||||||||
| # http://www.apache.org/licenses/LICENSE-2.0 | ||||||||||||||||||||
| # | ||||||||||||||||||||
| # Unless required by applicable law or agreed to in writing, software | ||||||||||||||||||||
| # distributed under the License is distributed on an "AS IS" BASIS, | ||||||||||||||||||||
| # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. | ||||||||||||||||||||
| # See the License for the specific language governing permissions and | ||||||||||||||||||||
| # limitations under the License. | ||||||||||||||||||||
|
|
||||||||||||||||||||
| import runpy | ||||||||||||||||||||
| from unittest import mock | ||||||||||||||||||||
|
|
||||||||||||||||||||
| from google.api_core import exceptions | ||||||||||||||||||||
| from google.cloud import spanner | ||||||||||||||||||||
| from opentelemetry.sdk.trace.export import SpanExportResult | ||||||||||||||||||||
| import pytest | ||||||||||||||||||||
| from spanner_observability import opentelemetry_traces_otlp | ||||||||||||||||||||
|
|
||||||||||||||||||||
| from . import conftest | ||||||||||||||||||||
|
|
||||||||||||||||||||
| PROJECT_ID = "example-project-id" | ||||||||||||||||||||
| INSTANCE_ID = "example-instance" | ||||||||||||||||||||
| DATABASE_ID = "example-db" | ||||||||||||||||||||
| DATABASE_NAME = f"projects/{PROJECT_ID}/instances/{INSTANCE_ID}/databases/{DATABASE_ID}" | ||||||||||||||||||||
| SPANNER_CLIENT = "google.cloud.spanner.Client" | ||||||||||||||||||||
| OTLP_EXPORTER = "spanner_observability.opentelemetry_traces_otlp.OTLPSpanExporter" | ||||||||||||||||||||
| OTLP_EXPORTER_SRC = ( | ||||||||||||||||||||
| "opentelemetry.exporter.otlp.proto.grpc.trace_exporter.OTLPSpanExporter" | ||||||||||||||||||||
| ) | ||||||||||||||||||||
|
|
||||||||||||||||||||
|
|
||||||||||||||||||||
| @mock.patch(OTLP_EXPORTER) | ||||||||||||||||||||
| @mock.patch(SPANNER_CLIENT) | ||||||||||||||||||||
| def test_configure_otlp_tracing_success( | ||||||||||||||||||||
| mock_client_class: mock.MagicMock, | ||||||||||||||||||||
| mock_exporter_class: mock.MagicMock, | ||||||||||||||||||||
| capsys: pytest.CaptureFixture[str], | ||||||||||||||||||||
| ) -> None: | ||||||||||||||||||||
| mock_exporter_class.return_value.export.return_value = SpanExportResult.SUCCESS | ||||||||||||||||||||
| database = ( | ||||||||||||||||||||
| mock_client_class.return_value.instance.return_value.database.return_value | ||||||||||||||||||||
| ) | ||||||||||||||||||||
| database.name = DATABASE_NAME | ||||||||||||||||||||
| snapshot = database.snapshot.return_value.__enter__.return_value | ||||||||||||||||||||
| snapshot.execute_sql.return_value = [(1,)] | ||||||||||||||||||||
|
|
||||||||||||||||||||
| opentelemetry_traces_otlp.configure_otlp_tracing( | ||||||||||||||||||||
| PROJECT_ID, INSTANCE_ID, DATABASE_ID | ||||||||||||||||||||
| ) | ||||||||||||||||||||
|
|
||||||||||||||||||||
| obs = mock_client_class.call_args.kwargs["observability_options"] | ||||||||||||||||||||
| assert obs["enable_end_to_end_tracing"] is True | ||||||||||||||||||||
| assert obs["enable_extended_tracing"] is True | ||||||||||||||||||||
| out, err = capsys.readouterr() | ||||||||||||||||||||
| assert f"Resource ID: {DATABASE_ID}" in out | ||||||||||||||||||||
| assert PROJECT_ID not in out | ||||||||||||||||||||
| assert "Check Result: 1" in out | ||||||||||||||||||||
| assert err == "" | ||||||||||||||||||||
|
|
||||||||||||||||||||
|
|
||||||||||||||||||||
| @pytest.mark.parametrize( | ||||||||||||||||||||
| "error, expected_prefix", | ||||||||||||||||||||
| [ | ||||||||||||||||||||
| ( | ||||||||||||||||||||
| exceptions.NotFound("db missing"), | ||||||||||||||||||||
| "error: database 'example-db' on instance 'example-instance'", | ||||||||||||||||||||
| ), | ||||||||||||||||||||
| ( | ||||||||||||||||||||
| exceptions.PermissionDenied("denied"), | ||||||||||||||||||||
| "error: OTLP-traced query failed", | ||||||||||||||||||||
| ), | ||||||||||||||||||||
| ], | ||||||||||||||||||||
| ) | ||||||||||||||||||||
| @mock.patch(OTLP_EXPORTER) | ||||||||||||||||||||
| @mock.patch(SPANNER_CLIENT) | ||||||||||||||||||||
| def test_configure_otlp_tracing_errors( | ||||||||||||||||||||
| mock_client_class: mock.MagicMock, | ||||||||||||||||||||
| mock_exporter_class: mock.MagicMock, | ||||||||||||||||||||
| capsys: pytest.CaptureFixture[str], | ||||||||||||||||||||
| error: Exception, | ||||||||||||||||||||
| expected_prefix: str, | ||||||||||||||||||||
| ) -> None: | ||||||||||||||||||||
| mock_exporter_class.return_value.export.return_value = SpanExportResult.SUCCESS | ||||||||||||||||||||
| database = ( | ||||||||||||||||||||
| mock_client_class.return_value.instance.return_value.database.return_value | ||||||||||||||||||||
| ) | ||||||||||||||||||||
|
Comment on lines
+88
to
+91
Contributor
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Mock the
Suggested change
Contributor
Author
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Thanks! Because we intentionally omit project identifiers ( |
||||||||||||||||||||
| snapshot = database.snapshot.return_value.__enter__.return_value | ||||||||||||||||||||
| snapshot.execute_sql.side_effect = error | ||||||||||||||||||||
|
|
||||||||||||||||||||
| opentelemetry_traces_otlp.configure_otlp_tracing( | ||||||||||||||||||||
| PROJECT_ID, INSTANCE_ID, DATABASE_ID | ||||||||||||||||||||
| ) | ||||||||||||||||||||
|
|
||||||||||||||||||||
| out, err = capsys.readouterr() | ||||||||||||||||||||
| assert out == "" | ||||||||||||||||||||
| assert err.startswith(expected_prefix) | ||||||||||||||||||||
| assert PROJECT_ID not in err | ||||||||||||||||||||
|
|
||||||||||||||||||||
|
|
||||||||||||||||||||
| @mock.patch(OTLP_EXPORTER_SRC) | ||||||||||||||||||||
| @mock.patch(SPANNER_CLIENT) | ||||||||||||||||||||
| def test_configure_otlp_tracing_cli_entrypoint( | ||||||||||||||||||||
| mock_client_class: mock.MagicMock, | ||||||||||||||||||||
| mock_exporter_class: mock.MagicMock, | ||||||||||||||||||||
| monkeypatch: pytest.MonkeyPatch, | ||||||||||||||||||||
| capsys: pytest.CaptureFixture[str], | ||||||||||||||||||||
| ) -> None: | ||||||||||||||||||||
| mock_exporter_class.return_value.export.return_value = SpanExportResult.SUCCESS | ||||||||||||||||||||
| database = ( | ||||||||||||||||||||
| mock_client_class.return_value.instance.return_value.database.return_value | ||||||||||||||||||||
| ) | ||||||||||||||||||||
| database.name = DATABASE_NAME | ||||||||||||||||||||
| snapshot = database.snapshot.return_value.__enter__.return_value | ||||||||||||||||||||
| snapshot.execute_sql.return_value = [(1,)] | ||||||||||||||||||||
| monkeypatch.setattr( | ||||||||||||||||||||
| "sys.argv", | ||||||||||||||||||||
| [ | ||||||||||||||||||||
| "opentelemetry_traces_otlp.py", | ||||||||||||||||||||
| "--project-id", | ||||||||||||||||||||
| PROJECT_ID, | ||||||||||||||||||||
| "--instance-id", | ||||||||||||||||||||
| INSTANCE_ID, | ||||||||||||||||||||
| "--database-id", | ||||||||||||||||||||
| DATABASE_ID, | ||||||||||||||||||||
| ], | ||||||||||||||||||||
| ) | ||||||||||||||||||||
|
|
||||||||||||||||||||
| runpy.run_module( | ||||||||||||||||||||
| "spanner_observability.opentelemetry_traces_otlp", run_name="__main__" | ||||||||||||||||||||
| ) | ||||||||||||||||||||
|
|
||||||||||||||||||||
| assert "Check Result: 1" in capsys.readouterr().out | ||||||||||||||||||||
|
|
||||||||||||||||||||
|
|
||||||||||||||||||||
| @conftest.live_only | ||||||||||||||||||||
| def test_configure_otlp_tracing_live(capsys: pytest.CaptureFixture[str]) -> None: | ||||||||||||||||||||
| with ( | ||||||||||||||||||||
| mock.patch(OTLP_EXPORTER) as mock_exp, | ||||||||||||||||||||
| mock.patch.object(spanner, "Client", wraps=spanner.Client) as spy_client, | ||||||||||||||||||||
| ): | ||||||||||||||||||||
| mock_exp.return_value.export.return_value = SpanExportResult.SUCCESS | ||||||||||||||||||||
| opentelemetry_traces_otlp.configure_otlp_tracing( | ||||||||||||||||||||
| conftest.LIVE_PROJECT_ID, | ||||||||||||||||||||
| conftest.LIVE_INSTANCE_ID, | ||||||||||||||||||||
| conftest.LIVE_DATABASE_ID, | ||||||||||||||||||||
| ) | ||||||||||||||||||||
|
|
||||||||||||||||||||
| obs = spy_client.call_args.kwargs["observability_options"] | ||||||||||||||||||||
| assert obs["enable_end_to_end_tracing"] is True | ||||||||||||||||||||
| assert obs["enable_extended_tracing"] is True | ||||||||||||||||||||
| out, err = capsys.readouterr() | ||||||||||||||||||||
| assert err == "" | ||||||||||||||||||||
| assert conftest.LIVE_PROJECT_ID not in out | ||||||||||||||||||||
| assert "Check Result: 1" in out | ||||||||||||||||||||
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Allow
project_idto be optional (None) so that the Spanner client can automatically infer the project ID from Application Default Credentials (ADC) when it is not explicitly provided.References
argparsefor a command-line script, the--project_idargument can be optional, as the project can be inferred from Application Default Credentials (ADC) if not provided.There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Thanks for the suggestion! We are intentionally keeping
project_id: strexplicit in the sample signature so callers pass configuration directly rather than relying on implicit ADC resolution, and we intentionally omit project identifiers (project_id/client.project) fromstdoutandstderroutput so project metadata is not echoed in logs.