Vertex AI instrumentation boilerplate

[aabmass]

Description

After the discussion on #3069, I decided to break this up into a series of PRs. This PR contains

• Copy openai-v2 boilerplate and s/openai/vertexai
• Updated the examples, READMEs, and docstrings to use VertexAI SDK
• Update test-requirements-{0,1}.txt to pip Vertex AI dependencies for testing

Part of #3041

Type of change

Please delete options that are not relevant.

• New feature (non-breaking change which adds functionality)

How Has This Been Tested?

Just boilerplate but I test the examples don't fail and new tests are passing with a placeholder

Does This PR Require a Core Repo Change?

• Yes. - Link to PR:
• 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

[gyliu513]

Nice boilerplate, thanks @aabmass ! I think all other instrumentations can refer to this PR as a template, and build their own instrumentation.

I think we probably need a README under https://github.com/open-telemetry/opentelemetry-python-contrib/tree/main/instrumentation-genai and add some tips for contribution etc, but we can probably create another PR to address this.

[karthikscale3]

Nice work! thanks for adding this

[aabmass]

Thanks for review!

I think we probably need a README under https://github.com/open-telemetry/opentelemetry-python-contrib/tree/main/instrumentation-genai and add some tips for contribution etc, but we can probably create another PR to address this.

We could add to this section https://github.com/open-telemetry/opentelemetry-python-contrib/blob/main/CONTRIBUTING.md#guideline-for-genai-instrumentations or break that all out and link is fine with me.

[gyliu513]

@aabmass Happy New Year! May I know why did this instrumentation did not add -v2? We already have one in openllmetry https://github.com/traceloop/openllmetry/tree/gk/crewai-instrumentation/packages/opentelemetry-instrumentation-vertexai, ,thanks!

[codefromthecrypt]

The current precedent of -v2 was to avoid package names in use by openllmetry

I asked the same on slack, from the angle of how we expect to publish this considering that. I was told that there is a negotiation about re-using the name currently in use by openllmetry (presumably to obviate theirs). I'm not sure if this is only about vertex, or all except openai or something other plan.

Those who can attend the weekly calls may be able to find out more on this topic, and please do share in an issue or issue comment the result of that!

[gyliu513]

Good, thanks @codefromthecrypt , I think we need a conclusion for this, we already have openai-v2 here, if we agree to use same name as openllmetry, we probably need remove -v2 for openai as well.