{"library":"opentelemetry-instrumentation-alephalpha","title":"OpenTelemetry Aleph Alpha Instrumentation","description":"This library provides OpenTelemetry instrumentation for tracing calls to Aleph Alpha's endpoints when using the official Aleph Alpha Client. It is part of the broader OpenLLMetry project, offering observability for Generative AI and LLM applications. The library is actively maintained with frequent releases, currently at version 0.58.0.","language":"python","status":"active","last_verified":"Wed May 13","install":{"commands":["pip install opentelemetry-instrumentation-alephalpha aleph-alpha-client opentelemetry-sdk"],"cli":null},"imports":["from opentelemetry.instrumentation.alephalpha import AlephAlphaInstrumentor"],"auth":{"required":false,"env_vars":[]},"quickstart":{"code":"import os\nfrom opentelemetry import trace\nfrom opentelemetry.sdk.resources import Resource\nfrom opentelemetry.sdk.trace import TracerProvider\nfrom opentelemetry.sdk.trace.export import ConsoleSpanExporter, SimpleSpanProcessor\nfrom opentelemetry.instrumentation.alephalpha import AlephAlphaInstrumentor\n\n# Ensure Aleph Alpha client is installed: pip install aleph-alpha-client\nimport aleph_alpha_client\n\n# --- OpenTelemetry SDK Setup ---\n# Configure resource (optional, but good practice)\nresource = Resource.create({\"service.name\": \"aleph-alpha-app\"})\n\n# Set up a TracerProvider\nprovider = TracerProvider(resource=resource)\n\n# Export spans to console for demonstration\nspan_processor = SimpleSpanProcessor(ConsoleSpanExporter())\nprovider.add_span_processor(span_processor)\n\n# Set the global TracerProvider\ntrace.set_tracer_provider(provider)\n\n# --- Aleph Alpha Instrumentation ---\n# Instrument the Aleph Alpha client\nAlephAlphaInstrumentor().instrument()\n\n# --- Aleph Alpha Client Usage ---\n# Replace with your actual Aleph Alpha API key\nAA_API_KEY = os.environ.get(\"ALEPH_ALPHA_API_KEY\", \"YOUR_AA_API_KEY\")\n\nif AA_API_KEY == \"YOUR_AA_API_KEY\":\n    print(\"Warning: ALEPH_ALPHA_API_KEY not set. Using dummy key. API calls will fail.\")\n\n# Example Aleph Alpha API call\nprint(\"\\n--- Making an Aleph Alpha API call ---\")\nclient = aleph_alpha_client.Client(host=\"https://api.aleph-alpha.com\", token=AA_API_KEY)\n\ntry:\n    # A simple completion request\n    request = aleph_alpha_client.CompletionRequest(\n        prompt=aleph_alpha_client.Prompt([aleph_alpha_client.Text(\"Hello, world!\")]),\n        model=\"luminous-extended\",\n        maximum_tokens=10,\n    )\n    response = client.complete(request=request)\n    print(f\"Aleph Alpha Response: {response.completions[0].completion}\")\nexcept Exception as e:\n    print(f\"Aleph Alpha API call failed (this is expected if API key is invalid): {e}\")\n\nprint(\"\\n--- OpenTelemetry tracing complete ---\")\n","lang":"python","description":"This quickstart demonstrates how to set up the OpenTelemetry SDK with a console exporter and then apply the `AlephAlphaInstrumentor` to automatically trace calls made using the `aleph-alpha-client`. Ensure your `ALEPH_ALPHA_API_KEY` is set as an environment variable or replaced in the code.","tag":null,"tag_description":null,"last_tested":"2026-04-25","results":[{"runtime":"python:3.10-alpine","exit_code":0},{"runtime":"python:3.10-slim","exit_code":0},{"runtime":"python:3.11-alpine","exit_code":0},{"runtime":"python:3.11-slim","exit_code":0},{"runtime":"python:3.12-alpine","exit_code":0},{"runtime":"python:3.12-slim","exit_code":0},{"runtime":"python:3.13-alpine","exit_code":0},{"runtime":"python:3.13-slim","exit_code":0},{"runtime":"python:3.9-alpine","exit_code":0},{"runtime":"python:3.9-slim","exit_code":0}]},"compatibility":{"tag":null,"tag_description":null,"last_tested":"2026-05-13","installed_version":"0.50.1","pypi_latest":"0.60.0","is_stale":true,"summary":{"python_range":"3.10–3.9","success_rate":100,"avg_install_s":13.3,"avg_import_s":0.42,"wheel_type":"wheel"},"results":[{"runtime":"python:3.10-alpine","python_version":"3.10","os_libc":"alpine (musl)","variant":"opentelemetry-instrumentation-alephalpha","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":null,"import_time_s":0.32,"mem_mb":9.3,"disk_size":"172.7M"},{"runtime":"python:3.10-alpine","python_version":"3.10","os_libc":"alpine (musl)","variant":"opentelemetry-instrumentation-alephalpha","exit_code":0,"wheel_type":null,"failure_reason":null,"import_side_effects":null,"install_time_s":null,"import_time_s":0.36,"mem_mb":9.2,"disk_size":"171.7M"},{"runtime":"python:3.10-slim","python_version":"3.10","os_libc":"slim (glibc)","variant":"opentelemetry-instrumentation-alephalpha","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":15,"import_time_s":0.24,"mem_mb":9.3,"disk_size":"157M"},{"runtime":"python:3.10-slim","python_version":"3.10","os_libc":"slim (glibc)","variant":"opentelemetry-instrumentation-alephalpha","exit_code":0,"wheel_type":null,"failure_reason":null,"import_side_effects":null,"install_time_s":null,"import_time_s":0.31,"mem_mb":9.2,"disk_size":"156M"},{"runtime":"python:3.11-alpine","python_version":"3.11","os_libc":"alpine (musl)","variant":"opentelemetry-instrumentation-alephalpha","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":null,"import_time_s":0.52,"mem_mb":10.5,"disk_size":"182.1M"},{"runtime":"python:3.11-alpine","python_version":"3.11","os_libc":"alpine (musl)","variant":"opentelemetry-instrumentation-alephalpha","exit_code":0,"wheel_type":null,"failure_reason":null,"import_side_effects":null,"install_time_s":null,"import_time_s":0.57,"mem_mb":10.5,"disk_size":"181.1M"},{"runtime":"python:3.11-slim","python_version":"3.11","os_libc":"slim (glibc)","variant":"opentelemetry-instrumentation-alephalpha","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":13,"import_time_s":0.45,"mem_mb":10.5,"disk_size":"166M"},{"runtime":"python:3.11-slim","python_version":"3.11","os_libc":"slim (glibc)","variant":"opentelemetry-instrumentation-alephalpha","exit_code":0,"wheel_type":null,"failure_reason":null,"import_side_effects":null,"install_time_s":null,"import_time_s":0.42,"mem_mb":10.5,"disk_size":"166M"},{"runtime":"python:3.12-alpine","python_version":"3.12","os_libc":"alpine (musl)","variant":"opentelemetry-instrumentation-alephalpha","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":null,"import_time_s":0.64,"mem_mb":10.9,"disk_size":"172.4M"},{"runtime":"python:3.12-alpine","python_version":"3.12","os_libc":"alpine (musl)","variant":"opentelemetry-instrumentation-alephalpha","exit_code":0,"wheel_type":null,"failure_reason":null,"import_side_effects":null,"install_time_s":null,"import_time_s":0.75,"mem_mb":10.9,"disk_size":"171.4M"},{"runtime":"python:3.12-slim","python_version":"3.12","os_libc":"slim (glibc)","variant":"opentelemetry-instrumentation-alephalpha","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":10.3,"import_time_s":0.61,"mem_mb":11.1,"disk_size":"157M"},{"runtime":"python:3.12-slim","python_version":"3.12","os_libc":"slim (glibc)","variant":"opentelemetry-instrumentation-alephalpha","exit_code":0,"wheel_type":null,"failure_reason":null,"import_side_effects":null,"install_time_s":null,"import_time_s":0.64,"mem_mb":11.1,"disk_size":"156M"},{"runtime":"python:3.13-alpine","python_version":"3.13","os_libc":"alpine (musl)","variant":"opentelemetry-instrumentation-alephalpha","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":null,"import_time_s":0.31,"mem_mb":7.8,"disk_size":"172.2M"},{"runtime":"python:3.13-alpine","python_version":"3.13","os_libc":"alpine (musl)","variant":"opentelemetry-instrumentation-alephalpha","exit_code":0,"wheel_type":null,"failure_reason":null,"import_side_effects":null,"install_time_s":null,"import_time_s":0.34,"mem_mb":7.8,"disk_size":"171.1M"},{"runtime":"python:3.13-slim","python_version":"3.13","os_libc":"slim (glibc)","variant":"opentelemetry-instrumentation-alephalpha","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":10.7,"import_time_s":0.34,"mem_mb":7.8,"disk_size":"156M"},{"runtime":"python:3.13-slim","python_version":"3.13","os_libc":"slim (glibc)","variant":"opentelemetry-instrumentation-alephalpha","exit_code":0,"wheel_type":null,"failure_reason":null,"import_side_effects":null,"install_time_s":null,"import_time_s":0.38,"mem_mb":7.8,"disk_size":"156M"},{"runtime":"python:3.9-alpine","python_version":"3.9","os_libc":"alpine (musl)","variant":"opentelemetry-instrumentation-alephalpha","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":null,"import_time_s":0.27,"mem_mb":8.4,"disk_size":"171.0M"},{"runtime":"python:3.9-alpine","python_version":"3.9","os_libc":"alpine (musl)","variant":"opentelemetry-instrumentation-alephalpha","exit_code":0,"wheel_type":null,"failure_reason":null,"import_side_effects":null,"install_time_s":null,"import_time_s":0.31,"mem_mb":8.4,"disk_size":"170.2M"},{"runtime":"python:3.9-slim","python_version":"3.9","os_libc":"slim (glibc)","variant":"opentelemetry-instrumentation-alephalpha","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":17.3,"import_time_s":0.23,"mem_mb":8.4,"disk_size":"156M"},{"runtime":"python:3.9-slim","python_version":"3.9","os_libc":"slim (glibc)","variant":"opentelemetry-instrumentation-alephalpha","exit_code":0,"wheel_type":null,"failure_reason":null,"import_side_effects":null,"install_time_s":null,"import_time_s":0.33,"mem_mb":8.4,"disk_size":"155M"}]}}