Define dynamic request attributes for Google GenAI LLM inference spans

[michaelsafyan]

Fixes open-telemetry/semantic-conventions-genai#27

Changes

Defines a gcp.gen_ai.operation.config.<key> dynamic attribute in support of Google Gen AI SDK instrumentation (see: PR 3374: include more request configuration options...). In support of this change, this also adds a Google-specific variant of the Gen AI docs. We anticipate that this will serve to enable additional documentation and Semantic Conventions for Google-specific elements beyond the dynamic request attributes being documented here.

Merge requirement checklist

• CONTRIBUTING.md guidelines followed.
• Change log entry added, according to the guidelines in When to add a changelog entry.
  • If your PR does not need a change log, start the PR title with [chore]
• [N/A] schema-next.yaml updated with changes to existing conventions.

[michaelsafyan]

@lmolkova reaching back to see what the next steps are to make forward progress here... for example, do we need to wait for Weaver to resolve open-telemetry/weaver#705 before we can move forward? And do we need this PR to go in before we can submit/merge open-telemetry/opentelemetry-python-contrib#3374 ?

It looks like Traceloop has some interest in iterating on the Google Gen AI SDK instrumentation (traceloop/openllmetry#2675) ... so I'm wondering if it might make sense to accelerate the merge of open-telemetry/opentelemetry-python-contrib#3374 (even with this pending) simply to reduce the chance of future merge conflicts ... I know that code tends to rot the longer it is out-of-sync.

[michaelsafyan]

I see some yamllint errors:

./docs/attributes-registry/gcp.md:114:204 MD055/table-pipe-style Table pipe style [Expected: leading_and_trailing; Actual: leading_only; Missing trailing pipe]
./docs/attributes-registry/gcp.md:114:204 MD056/table-column-count Table column count [Expected: 5; Actual: 3; Too few cells, row will be missing data]
./docs/attributes-registry/gcp.md:115:1 MD055/table-pipe-style Table pipe style [Expected: leading_and_trailing; Actual: trailing_only; Missing leading pipe]
./docs/attributes-registry/gcp.md:115:520 MD056/table-column-count Table column count [Expected: 5; Actual: 3; Too few cells, row will be missing data]
./docs/attributes-registry/gcp.md:118:523 MD009/no-trailing-spaces Trailing spaces [Expected: 0 or 2; Actual: 1]

... which I'm not quite sure how to fix. Before spending too much time on that, though, I want to confirm that the updated definition is acceptable.

[lmolkova]

Left some cosmetic suggestions, LGTM otherwise

[jsuereth]

This LGTM once comments are addressed.

[github-actions]

This PR was marked stale due to lack of activity. It will be closed in 7 days.

[github-actions]

This PR was marked stale due to lack of activity. It will be closed in 7 days.

[github-actions]

Closed as inactive. Feel free to reopen if this PR is still being worked on.

[lmolkova]

reopening in case @aabmass would like to take it over

[github-actions]

This PR has been labeled as stale due to lack of activity. It will be automatically closed if there is no further activity over the next 14 days.

[Rima-ag]

I'm happy to take this over, address the comments and update it to include the changes to the semantic convention since then
@lmolkova, could you please reopen the PR?

[lmolkova]

@Rima-ag sure, done!

[trask]

Closing in favor of @Rima-ag's #3486