otel_cloud_functions 0.1.0 copy "otel_cloud_functions: ^0.1.0" to clipboard
otel_cloud_functions: ^0.1.0 copied to clipboard

OpenTelemetry instrumentation for `package:cloud_functions`. Wraps HttpsCallable.call with `rpc.*` semconv spans for callable Firebase Functions.

Changelog #

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

0.1.0 - 2026-08-08 #

Added #

  • tracedHttpsCall(HttpsCallable, name:, parameters:) — wraps an [HttpsCallable.call] invocation in a CLIENT span named firebase_functions <name> with rpc.system.name=firebase_functions and a fully-qualified rpc.method=firebase_functions/<name>.
  • tracedCloudFunctionCall<R>({name, invoke}) — generic helper used internally and exposed for cases where you can't or don't want to use a real HttpsCallable (testing, custom transports).
  • FirebaseFunctionsException.code-aware error handling: error.type is set to the canonical Google Cloud RPC code name (not-found, permission-denied, unauthenticated, …). Generic exceptions fall back to the runtime class name.
  • runWithoutCloudFunctionsInstrumentation / runWithoutCloudFunctionsInstrumentationAsync — zone-scoped suppression helpers.
  • Tests cover success, FirebaseFunctionsException error path, generic exception fallback, suppression scope, and parent-span inheritance via startActiveSpan.
0
likes
160
points
95
downloads

Documentation

API reference

Publisher

unverified uploader

Weekly Downloads

OpenTelemetry instrumentation for `package:cloud_functions`. Wraps HttpsCallable.call with `rpc.*` semconv spans for callable Firebase Functions.

Homepage
Repository (GitHub)
View/report issues

License

Apache-2.0 (license)

Dependencies

cloud_functions, dartastic_opentelemetry, dartastic_opentelemetry_api, flutter

More

Packages that depend on otel_cloud_functions