Skip to content

refactor: rename Galileo OTel symbols to Splunk AO (GalileoSpan, galileo-tracer, galileo-otel)#90

Open
adityamehra wants to merge 3 commits into
mainfrom
rename/galileo-to-splunk-ao
Open

refactor: rename Galileo OTel symbols to Splunk AO (GalileoSpan, galileo-tracer, galileo-otel)#90
adityamehra wants to merge 3 commits into
mainfrom
rename/galileo-to-splunk-ao

Conversation

@adityamehra

@adityamehra adityamehra commented Jul 16, 2026

Copy link
Copy Markdown
Member

Summary

Removes remaining galileo branding from the OpenTelemetry integration layer. This is a clean-up follow-on to HYBIM-832.

  • GalileoSpanSplunkAOSpan — import alias in otel.py, handler.py, and utils/openai_agents.py
  • "galileo-tracer""splunk-ao-tracer" — OTel instrumentation scope name (appears as otel.scope.name in exported traces)
  • "galileo-otel""splunk-ao-otel"gen_ai.system attribute value set on every span emitted by start_splunk_ao_span()
  • galileo_spansplunk_ao_span — internal parameter names in otel.py helper functions
  • Examples — local variable names updated (galileo_span_processorsplunk_ao_span_processor, start_galileo_spanstart_splunk_ao_span)
  • Docstring fix in handler.py (Add a Galileo custom spanAdd a Splunk AO custom span)
  • Docs — added docs/OTEL_GALILEO_TO_SPLUNK_AO_RENAME.md detailing all changes, OTel attribute impact, and migration notes

Files Changed

File Change
src/splunk_ao/otel.py Import alias, parameter names, tracer name, gen_ai.system value
src/splunk_ao/handlers/openai_agents/handler.py Import alias, docstring
src/splunk_ao/utils/openai_agents.py Import alias, parameter name
examples/agent/google-adk/my_agent/agent.py Variable rename
examples/agent/langgraph-open-telemetry/main.py Variable rename
examples/rag/cli-rag-demo/python-service/app.py Variable rename
tests/test_otel.py Test names updated
tests/test_openai_agents_utils.py Test names updated
docs/OTEL_GALILEO_TO_SPLUNK_AO_RENAME.md New — rename guide

Breaking Changes

The public Python API (start_splunk_ao_span, add_splunk_ao_span_processor, SplunkAOSpanProcessor) is unchanged.

Users who filter on OTel span attributes should update:

Attribute Old value New value
gen_ai.system galileo-otel splunk-ao-otel
otel.scope.name galileo-tracer splunk-ao-tracer

Test Plan

  • tests/test_otel.py — all tests updated and passing
  • tests/test_openai_agents_utils.py — updated and passing
  • No public API signatures changed; existing integrations unaffected

Related

  • Closes follow-up items from HYBIM-832
  • See also: HYBIM-730 (Metrics → Evaluators, Log Streams → Agent Streams) — separate upcoming PR

…_span, galileo-otel → splunk-ao-otel

Remove remaining Galileo branding from the OTel integration layer:
- Import alias: `Span as GalileoSpan` → `Span as SplunkAOSpan`
- Parameter/variable names: `galileo_span` → `splunk_ao_span` across otel.py, handler.py, and utils
- gen_ai.system attribute value: `"galileo-otel"` → `"splunk-ao-otel"`
- Test class/method names updated to match
- Examples updated: start_galileo_span → start_splunk_ao_span, galileo_span_processor → splunk_ao_span_processor

Co-authored-by: Cursor <cursoragent@cursor.com>

@fercor-cisco fercor-cisco left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🤖 This review was generated by the Astra agent (claude-opus-4-8). It may contain mistakes.

Verdict: approve — Clean mechanical rename; only two minor leftover branding references remain, no correctness impact.

Comment thread src/splunk_ao/otel.py Outdated
if tracer_provider is None:
tracer_provider = trace.get_tracer_provider()
_TRACE_PROVIDER_CONTEXT_VAR.set(cast(TracerProvider, tracer_provider))
tracer = tracer_provider.get_tracer("galileo-tracer")

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🟡 minor (other): The OTel tracer/instrumentation-scope name is still "galileo-tracer". This string is emitted in every span's scope metadata, so it's user-visible telemetry branding — the same kind of leftover as the gen_ai.system value you did rename to "splunk-ao-otel" two lines below. Since the PR's stated goal is to replace all remaining Galileo branding in the OTel integration layer, this appears to be an in-scope miss. Note that changing it is a behavioral change for any downstream consumer filtering spans by scope name, so confirm that's intended before flipping it.

Suggested change
tracer = tracer_provider.get_tracer("galileo-tracer")
tracer = tracer_provider.get_tracer("splunk-ao-tracer")

🤖 Generated by the Astra agent

@staticmethod
def add_splunk_ao_custom_span(span: GalileoSpan) -> Span[SplunkAOCustomSpan]:
def add_splunk_ao_custom_span(span: SplunkAOSpan) -> Span[SplunkAOCustomSpan]:
"""Add a Galileo custom span to the trace."""

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🔵 nit (documentation): Docstring still reads "Add a Galileo custom span to the trace." — another leftover Galileo branding reference the rename missed.

Suggested change
"""Add a Galileo custom span to the trace."""
"""Add a Splunk AO custom span to the trace."""

🤖 Generated by the Astra agent

@fercor-cisco

Copy link
Copy Markdown
Collaborator

@adityamehra there seem to be a couple leftovers to rename.

adityamehra and others added 2 commits July 17, 2026 11:51
- "galileo-tracer" → "splunk-ao-tracer" (OTel instrumentation scope name)
- "Add a Galileo custom span" → "Add a Splunk AO custom span" (docstring)

Addresses review comments from fercor-cisco on PR #90.

Co-authored-by: Cursor <cursoragent@cursor.com>
Documents the changes made in this branch for users who depend on
OTel span attributes (gen_ai.system, otel.scope.name) and for
internal contributors reviewing the refactor.

Covers: instrumentation scope name, gen_ai.system value, import
alias, parameter renames, and example variable name updates.

Co-authored-by: Cursor <cursoragent@cursor.com>
@adityamehra adityamehra changed the title refactor: rename GalileoSpan → SplunkAOSpan, galileo_span → splunk_ao_span, galileo-otel → splunk-ao-otel refactor: rename Galileo OTel symbols to Splunk AO (GalileoSpan, galileo-tracer, galileo-otel) Jul 17, 2026
@adityamehra
adityamehra requested a review from fercor-cisco July 17, 2026 20:48
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.

2 participants