Update google genai instrumentation to work with latest semantic convention, allow for uploading content. #3772

argaj · 2025-09-22T17:20:06Z

Description

Accomodation of semantic conventions changes made in open-telemetry/semantic-conventions#2179.

Also, when logging the completion details, the upload hook is called, so if user has configured OTEL_INSTRUMENTATION_GENAI_UPLOAD_BASE_PATH and OTEL_INSTRUMENTATION_GENAI_UPLOAD_HOOK env vars, completion details will also be logged as refs (if appropriate capture content env var is set).

Type of change

New feature (non-breaking change which adds functionality)

How Has This Been Tested?

Unit tests, manual tests.

Does This PR Require a Core Repo Change?

No

Checklist:

See contributing.md for styleguide, changelog guidelines, and more.

Followed the style guidelines of this project
Changelogs have been updated
Unit tests have been added
Documentation has been updated

linux-foundation-easycla · 2025-09-22T17:20:14Z

The committers listed above are authorized under a signed CLA.

✅ login: aabmass / name: Aaron Abbott (3353819, 6276543)
✅ login: argaj / name: argaj (3f20dbc)
✅ login: argaj / name: Artur Gajowniczek (057d956, 058da13, 0ff51f3, 13b6f2e, 166c081, 17b9c0a, 20c082c, 2eefc39, 39deea9, 3ac198d, 46b10d1, 47d5728, 48ac64b, 49264ee, 5703096, 5c35853, 661998b, 8583327, 8b8995c, 9bd4d25, 9ea2278, 9ef75f7, ab39602, ac3a4a6, ae4da64, b3a6efb, b564008, e1738c2, e51ef37, ee911f5, eeed7d5, f1feaf7, f4df9fb)
✅ login: DylanRussell / name: Dylan Russell (05bed52, 205aa88, 486796a)
✅ login: DylanRussell / name: DylanRussell (32ae223)

...trumentation-google-genai/src/opentelemetry/instrumentation/google_genai/generate_content.py

Co-authored-by: Aaron Abbott <aaronabbott@google.com>

…in spans test.

...-instrumentation-google-genai/src/opentelemetry/instrumentation/google_genai/instrumentor.py

...metry-instrumentation-google-genai/src/opentelemetry/instrumentation/google_genai/message.py

...enerate_content/cassettes/test_streaming[logcontent-gemini-2.5-flash-vertexaiapi-async].yaml

instrumentation-genai/opentelemetry-instrumentation-google-genai/tests/requirements.oldest.txt

…y-python-contrib into genai-instrumentation-semconv

aabmass

Thank you, LGTM! Will merge once Dylan has finished reviewing/approved too.

...trumentation-google-genai/src/opentelemetry/instrumentation/google_genai/generate_content.py

...entation-genai/opentelemetry-instrumentation-google-genai/tests/generate_content/test_e2e.py

...rate_content/cassettes/test_streaming[excludecontent-gemini-2.5-flash-vertexaiapi-sync].yaml

...ate_content/cassettes/test_streaming[excludecontent-gemini-2.5-flash-vertexaiapi-async].yaml

util/opentelemetry-util-genai/src/opentelemetry/util/genai/types.py

…nai package.

...ation-genai/opentelemetry-instrumentation-google-genai/tests/utils/test_tool_call_wrapper.py

...metry-instrumentation-google-genai/src/opentelemetry/instrumentation/google_genai/message.py

...trumentation-google-genai/src/opentelemetry/instrumentation/google_genai/generate_content.py

...rate_content/cassettes/test_streaming[excludecontent-gemini-2.5-flash-vertexaiapi-sync].yaml

…y-python-contrib into genai-instrumentation-semconv

...metry-instrumentation-google-genai/src/opentelemetry/instrumentation/google_genai/message.py

...aming[logcontent-gemini-2.5-flash-vertexaiapi-sync-enable_completion_hook-experimental].yaml

github-actions bot assigned codefromthecrypt, karthikscale3, lzchen and nirga Sep 22, 2025

aabmass reviewed Sep 23, 2025

View reviewed changes

...trumentation-google-genai/src/opentelemetry/instrumentation/google_genai/generate_content.py Outdated Show resolved Hide resolved

...trumentation-google-genai/src/opentelemetry/instrumentation/google_genai/generate_content.py Outdated Show resolved Hide resolved

DylanRussell reviewed Sep 23, 2025

View reviewed changes

argaj force-pushed the genai-instrumentation-semconv branch from e76d888 to d0d6f1a Compare September 25, 2025 13:30

argaj and others added 6 commits September 26, 2025 13:32

Update google genai instrumentation to latest semantic convention.

3ac198d

Co-authored-by: Aaron Abbott <aaronabbott@google.com>

fix: log roles as str, event attrs as objects.

9ea2278

fix: proper event name

eeed7d5

refactor: remove unused message models.

e1738c2

refactor: use OTel imported semconv attributes.

f1feaf7

refactor: Inject upload_hook in Instrumentor.

ee911f5

argaj force-pushed the genai-instrumentation-semconv branch from d0d6f1a to ee911f5 Compare September 26, 2025 11:32

refactor: rename upload hook to completion hook.

8583327

argaj force-pushed the genai-instrumentation-semconv branch from 5d0572a to 8583327 Compare September 29, 2025 09:23

argaj added 2 commits September 30, 2025 16:07

test: add tests for non streaming case and tool_call_wrapper.

47d5728

test: add tool call instrumentation tests and nonstreaming recording …

b3a6efb

…in spans test.

argaj changed the title ~~[WIP] Update google genai instrumentation to work with latest semantic convention, allow for uploading content.~~ Update google genai instrumentation to work with latest semantic convention, allow for uploading content. Sep 30, 2025

argaj marked this pull request as ready for review September 30, 2025 17:36

argaj requested a review from a team as a code owner September 30, 2025 17:36

argaj added 2 commits October 1, 2025 12:39

fix: remove print

2eefc39

feature: add blobpart and filepart to message handling

166c081

github-actions bot assigned DylanRussell Oct 1, 2025

DylanRussell reviewed Oct 1, 2025

View reviewed changes

...-instrumentation-google-genai/src/opentelemetry/instrumentation/google_genai/instrumentor.py Outdated Show resolved Hide resolved

argaj added 4 commits October 2, 2025 11:06

fix: encode bytes as base64 when dumping to json string.

ae4da64

fix: always call completion hook, independently of recording settings.

13b6f2e

test: update requirements for instrumentation-google-genai oldest env

058da13

test: bump google-genai lib version in -oldest test env.

17b9c0a

DylanRussell reviewed Oct 6, 2025

View reviewed changes

instrumentation-genai/opentelemetry-instrumentation-google-genai/tests/requirements.oldest.txt Show resolved Hide resolved

argaj added 5 commits October 8, 2025 13:37

fix: aggregate streaming messages into one event.

ab39602

fix: remove gen_ai.system from latest sem_conv

0ff51f3

Merge branch 'main' of https://github.com/open-telemetry/opentelemetr…

48ac64b

…y-python-contrib into genai-instrumentation-semconv

refactor: import encoder from utils-genai

e51ef37

build: update deps versions.

5c35853

aabmass approved these changes Oct 9, 2025

View reviewed changes

argaj and others added 10 commits October 9, 2025 11:19

refactor: deduplicate creating attributes, use gen_ai_json_dumps

46b10d1

refactor: move blobpart and filedatapart to instrumentation-google-ge…

5703096

…nai package.

test: add comment for headers.

b564008

test: fix span attributes formatting.

8b8995c

Merge branch 'main' into genai-instrumentation-semconv

3f20dbc

fix: lint

9ef75f7

fix: use LogRecord instead of Event.

20c082c

docs: update changelog

f4df9fb

build: update uv.lock

39deea9

test: disable lint

661998b

DylanRussell reviewed Oct 9, 2025

View reviewed changes

build: unpin opentelemetry-util-genai version

49264ee

argaj mentioned this pull request Oct 9, 2025

opentelemetry-instrumentation-vertexai should set version specifier for genai utils #3786

Closed

DylanRussell approved these changes Oct 10, 2025

View reviewed changes

argaj added 2 commits October 11, 2025 10:21

test: add e2e completion_hook test

9bd4d25

Merge branch 'main' of https://github.com/open-telemetry/opentelemetr…

ac3a4a6

…y-python-contrib into genai-instrumentation-semconv

DylanRussell reviewed Oct 13, 2025

View reviewed changes

...metry-instrumentation-google-genai/src/opentelemetry/instrumentation/google_genai/message.py Show resolved Hide resolved

DylanRussell reviewed Oct 13, 2025

View reviewed changes

...aming[logcontent-gemini-2.5-flash-vertexaiapi-sync-enable_completion_hook-experimental].yaml Show resolved Hide resolved

DylanRussell mentioned this pull request Oct 13, 2025

Update vertex AI instrumentation to handle InlineData and FileData parts #3840

Merged

1 task

Merge branch 'main' into genai-instrumentation-semconv

3353819

aabmass enabled auto-merge (squash) October 13, 2025 19:50

aabmass merged commit c17e428 into open-telemetry:main Oct 13, 2025
638 checks passed

Update google genai instrumentation to work with latest semantic convention, allow for uploading content. #3772

Update google genai instrumentation to work with latest semantic convention, allow for uploading content. #3772

Uh oh!

Conversation

argaj commented Sep 22, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Description

Type of change

How Has This Been Tested?

Does This PR Require a Core Repo Change?

Checklist:

Uh oh!

linux-foundation-easycla bot commented Sep 22, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

aabmass left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

7 participants

argaj commented Sep 22, 2025 •

edited

Loading

linux-foundation-easycla bot commented Sep 22, 2025 •

edited

Loading