Fill out 'requirements.txt' and 'README.rst' for the manual instrumentation example.

Author: michaelsafyan

instrumentation-genai/opentelemetry-instrumentation-google-genai/examples/manual/README.rst

@@ -0,0 +1,44 @@
+OpenTelemetry Google GenAI SDK Manual Instrumentation Example
+============================================
+
+This is an example of how to instrument Google GenAI SDK calls when configuring
+OpenTelemetry SDK and Instrumentations manually.
+
+When `main.py <main.py>`_ is run, it exports traces, logs, and metrics to an OTLP
+compatible endpoint. Traces include details such as the model used and the
+duration of the chat request. Logs capture the chat request and the generated
+response, providing a comprehensive view of the performance and behavior of
+your GenAI SDK requests. Metrics include aggregate statistics such as the aggregate
+token usage as well as the latency distribution of the GenAI operations.
+
+Note: `.env <.env>`_ file configures additional environment variables:
+
+- `OTEL_INSTRUMENTATION_GENAI_CAPTURE_MESSAGE_CONTENT=true` configures
+Google GenAI SDK instrumentation to capture prompt and completion contents on
+events.
+
+Setup
+-----
+
+An OTLP compatible endpoint should be listening for traces, logs, and metrics on
+http://localhost:4317. If not, update "OTEL_EXPORTER_OTLP_ENDPOINT" as well.
+
+Next, set up a virtual environment like this:
+
+::
+
+    python3 -m venv .venv
+    source .venv/bin/activate
+    pip install "python-dotenv[cli]"
+    pip install -r requirements.txt
+
+Run
+---
+
+Run the example like this:
+
+::
+
+    export PROMPT="Your prompt here"
+    dotenv run -- python main.py
+

instrumentation-genai/opentelemetry-instrumentation-google-genai/examples/manual/requirements.txt

@@ -12,3 +12,8 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+google-genai
+opentelemetry-api
+opentelemetry-sdk
+opentelemetry-instrumentation-requests
+opentelemetry-instrumentation-google-genai