add links for observability

Author: ks6088ts

docs/references.md

@@ -26,3 +26,12 @@
 ### Services
 
 - [FastAPI](https://fastapi.tiangolo.com/)
+
+### Observability
+
+- [OpenTelemetry](https://opentelemetry.io/)
+  - [Python / Getting Started](https://opentelemetry.io/docs/languages/python/getting-started/)
+  - [Python / Cookbook](https://opentelemetry.io/docs/languages/python/cookbook/)
+  - [OpenTelemetry Collector](https://opentelemetry.io//docs/collector/)
+- [Jaeger](https://www.jaegertracing.io/)
+  - [Jaeger / Minimal deployment example (Elasticsearch backend)](https://www.jaegertracing.io/docs/1.72/deployment/#minimal-deployment-example-elasticsearch-backend)

scripts/otel_operator.py

@@ -48,6 +48,34 @@ def run(
         logger.info(f"Response: {response['content']}")
 
 
+@app.command()
+def cookbook(
+    verbose: bool = typer.Option(
+        False,
+        "--verbose",
+        "-v",
+        help="Enable verbose output",
+    ),
+):
+    # Set up logging
+    if verbose:
+        logger.setLevel(logging.DEBUG)
+
+    otel_wrapper = OtelWrapper()
+    otel_wrapper.initialize()
+    tracer = otel_wrapper.get_tracer(name=__name__)
+
+    with tracer.start_as_current_span("otel_operator_cookbook"):
+        logger.info("Running cookbook example...")
+        time.sleep(1)
+
+        with tracer.start_as_current_span("child"):
+            logger.info("Running child span...")
+            time.sleep(2)
+
+        time.sleep(1)
+
+
 if __name__ == "__main__":
     load_dotenv(
         override=True,