microsoft-opentelemetry 0.1.0a1__tar.gz

microsoft_opentelemetry-0.1.0a1/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) Microsoft Corporation
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

microsoft_opentelemetry-0.1.0a1/NOTICE.md

@@ -0,0 +1,7 @@
+NOTICES AND INFORMATION
+
+This repository may incorporate or depend on third-party open source components.
+
+When third-party notice obligations apply, the relevant notices should be included in this repository, in generated package artifacts, or made available through Microsoft's third-party notice distribution process.
+
+As the dependency set for this project evolves, this notice file may be updated to reflect additional third-party attribution requirements.

microsoft_opentelemetry-0.1.0a1/PKG-INFO

@@ -0,0 +1,184 @@
+Metadata-Version: 2.4
+Name: microsoft-opentelemetry
+Version: 0.1.0a1
+Summary: Minimal template for the Microsoft OpenTelemetry distro for Python
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+License-File: NOTICE.md
+Requires-Dist: azure-core<2.0.0,>=1.28.0
+Requires-Dist: azure-core-tracing-opentelemetry~=1.0.0b11
+Requires-Dist: azure-monitor-opentelemetry-exporter~=1.0.0b49
+Requires-Dist: opentelemetry-sdk==1.40
+Requires-Dist: opentelemetry-api==1.40
+Requires-Dist: opentelemetry-exporter-otlp-proto-http==1.40
+Requires-Dist: opentelemetry-instrumentation==0.61b0
+Requires-Dist: opentelemetry-instrumentation-django==0.61b0
+Requires-Dist: opentelemetry-instrumentation-fastapi==0.61b0
+Requires-Dist: opentelemetry-instrumentation-flask==0.61b0
+Requires-Dist: opentelemetry-instrumentation-psycopg2==0.61b0
+Requires-Dist: opentelemetry-instrumentation-requests==0.61b0
+Requires-Dist: opentelemetry-instrumentation-urllib==0.61b0
+Requires-Dist: opentelemetry-instrumentation-urllib3==0.61b0
+Requires-Dist: opentelemetry-instrumentation-logging==0.61b0
+Requires-Dist: opentelemetry.exporter.otlp.proto.grpc==1.40
+Requires-Dist: opentelemetry-resource-detector-azure<1.0.0,>=0.1.5
+Requires-Dist: langchain-core>=0.2.0
+Requires-Dist: wrapt>=1.0
+Requires-Dist: opentelemetry-util-genai>=0.3b0
+Requires-Dist: microsoft-agents-activity>=0.9.0
+Requires-Dist: microsoft-agents-hosting-core>=0.9.0
+Requires-Dist: aiohttp>=3.8.0
+Provides-Extra: test
+Requires-Dist: pytest>=8.0; extra == "test"
+Requires-Dist: pytest-cov>=5.0; extra == "test"
+Provides-Extra: dev
+Requires-Dist: black>=24.0; extra == "dev"
+Requires-Dist: pylint>=3.3; extra == "dev"
+Requires-Dist: mypy>=1.10; extra == "dev"
+Requires-Dist: pyright>=1.1; extra == "dev"
+Requires-Dist: pytest>=8.0; extra == "dev"
+Requires-Dist: pytest-cov>=5.0; extra == "dev"
+Dynamic: license-file
+
+# microsoft-opentelemetry
+
+[![PyPI version](https://img.shields.io/pypi/v/microsoft-opentelemetry)](https://pypi.org/project/microsoft-opentelemetry/)
+
+## Repository Setup
+
+The GitHub repository was provisioned with an onboarding placeholder that indicates repository setup and access control configuration may still need to be completed in the onboarding portal.
+
+Until that setup is complete, some repository settings or access-management actions may remain restricted.
+
+Python package for a Microsoft OpenTelemetry distribution that provides a single onboarding experience for observability across Azure Monitor, OTLP-compatible backends, and Microsoft Agent 365 style integrations.
+
+This repository starts from the POC described in `azure-data/microsoft-opentelemetry-distro-poc`, but is intentionally kept minimal while the package shape and delivery plan are being defined.
+
+## Goal
+
+The target package should reduce fragmented setup across multiple observability stacks to one import and one configuration function.
+
+Intended API shape:
+
+```python
+from microsoft.opentelemetry import use_microsoft_opentelemetry
+
+use_microsoft_opentelemetry(
+	azure_monitor_connection_string="InstrumentationKey=...;IngestionEndpoint=...",
+)
+```
+
+### Available Configuration Options
+
+| Keyword argument | Type | Default | Description |
+|---|---|---|---|
+| `enable_azure_monitor` | `bool` | `True` | Enable Azure Monitor export. |
+| `azure_monitor_connection_string` | `str` | `None` | Connection string for Application Insights. Also read from `APPLICATIONINSIGHTS_CONNECTION_STRING` env var. |
+| `azure_monitor_exporter_credential` | `TokenCredential` | `None` | Azure AD token credential for authentication. |
+| `azure_monitor_enable_live_metrics` | `bool` | `True` | Enable live metrics collection. |
+| `azure_monitor_enable_performance_counters` | `bool` | `True` | Enable performance counter collection. |
+| `azure_monitor_exporter_disable_offline_storage` | `bool` | `False` | Disable offline retry storage for failed telemetry. |
+| `azure_monitor_exporter_storage_directory` | `str` | `None` | Custom directory for offline telemetry storage. |
+| `azure_monitor_browser_sdk_loader_config` | `dict` | `None` | Browser SDK loader configuration. |
+| `disable_logging` | `bool` | `False` | Disable the logging pipeline. |
+| `disable_tracing` | `bool` | `False` | Disable the tracing pipeline. |
+| `disable_metrics` | `bool` | `False` | Disable the metrics pipeline. |
+| `resource` | `Resource` | auto | OpenTelemetry Resource. |
+| `span_processors` | `list` | `[]` | Additional span processors. |
+| `log_record_processors` | `list` | `[]` | Additional log record processors. |
+| `metric_readers` | `list` | `[]` | Additional metric readers. |
+| `views` | `list` | `[]` | Metric views. |
+| `logger_name` | `str` | `None` | Logger name for log collection. |
+| `logging_formatter` | `Formatter` | `None` | Formatter for collected logs. |
+| `instrumentation_options` | `dict` | `None` | Per-library instrumentation enable/disable options. |
+| `enable_trace_based_sampling_for_logs` | `bool` | `False` | Enable trace-based sampling for logs. |
+
+### Sampling Configuration
+
+Sampling is configured via standard OpenTelemetry environment variables:
+
+| Environment variable | Description |
+|---|---|
+| `OTEL_TRACES_SAMPLER` | Sampler type to use (see supported values below). |
+| `OTEL_TRACES_SAMPLER_ARG` | Argument for the sampler (e.g. sample ratio or traces per second). |
+
+**Supported sampler values for `OTEL_TRACES_SAMPLER`:**
+
+| Value | Description |
+|---|---|
+| `always_on` | Sample every trace. |
+| `always_off` | Drop every trace. |
+| `trace_id_ratio` | Sample a fixed percentage based on trace ID. Set ratio with `OTEL_TRACES_SAMPLER_ARG` (0–1). |
+| `parentbased_always_on` | Parent-based, defaults to always on. |
+| `parentbased_always_off` | Parent-based, defaults to always off. |
+| `parentbased_trace_id_ratio` | Parent-based with trace ID ratio fallback. |
+| `microsoft.fixed_percentage` | Azure Monitor fixed-percentage sampler. Set ratio with `OTEL_TRACES_SAMPLER_ARG` (0–1). |
+| `microsoft.rate_limited` | Azure Monitor rate-limited sampler. Set target with `OTEL_TRACES_SAMPLER_ARG` (traces per second, default 5). |
+
+**Example:**
+
+```bash
+export OTEL_TRACES_SAMPLER=trace_id_ratio
+export OTEL_TRACES_SAMPLER_ARG=0.1
+```
+
+## Planned Scope
+
+- Azure Monitor exporter support
+- OTLP exporter support
+- Microsoft-specific agent observability extensions
+- GenAI instrumentation toggles for OpenAI, OpenAI Agents, and LangChain
+- Standard Python web and HTTP instrumentations
+- Environment-variable driven configuration
+- A stable package surface for downstream agent applications
+
+## Reference POC Highlights
+
+The source POC positions the distro around three outcomes:
+
+- one package, one API, one documentation surface
+- less duplicated exporter and instrumentation wiring across teams
+- much less application boilerplate compared with manual OpenTelemetry setup
+
+The POC also describes this execution model:
+
+1. Configure Azure Monitor when enabled
+2. Otherwise create standalone OpenTelemetry providers
+3. Attach OTLP exporters when requested
+4. Attach Microsoft-specific exporters when requested
+5. Enable standard instrumentations
+6. Enable Microsoft-specific observability instrumentations
+7. Enable GenAI contrib instrumentations
+
+## Development
+
+Create an environment and install the project with test dependencies:
+
+```bash
+pip install -e .[test]
+pytest
+```
+
+## Reference
+
+- POC repo: https://github.com/azure-data/microsoft-opentelemetry-distro-poc
+- Planning document: [PLANNING.md](./PLANNING.md)
+
+## Contributing
+
+Read our [contributing guide](./CONTRIBUTING.md) to learn about our development process, how to propose bugfixes and improvements, and how to build and test your changes to this distribution.
+
+## Data Collection
+
+As this SDK is designed to enable applications to perform data collection which is sent to the Microsoft collection endpoints the following is required to identify our privacy statement.
+
+The software may collect information about you and your use of the software and send it to Microsoft. Microsoft may use this information to provide services and improve our products and services. You may turn off the telemetry as described in the repository. There are also some features in the software that may enable you and Microsoft to collect data from users of your applications. If you use these features, you must comply with applicable law, including providing appropriate notices to users of your applications together with a copy of Microsoft’s privacy statement. Our privacy statement is located at https://go.microsoft.com/fwlink/?LinkID=824704. You can learn more about data collection and use in the help documentation and our privacy statement. Your use of the software operates as your consent to these practices.
+
+## Trademarks
+
+This project may contain trademarks or logos for projects, products, or services. Authorized use of Microsoft trademarks or logos is subject to and must follow [Microsoft’s Trademark & Brand Guidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general). Use of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship. Any use of third-party trademarks or logos are subject to those third-party’s policies.
+
+## License
+
+[MIT](LICENSE)

microsoft_opentelemetry-0.1.0a1/README.md

@@ -0,0 +1,141 @@
+# microsoft-opentelemetry
+
+[![PyPI version](https://img.shields.io/pypi/v/microsoft-opentelemetry)](https://pypi.org/project/microsoft-opentelemetry/)
+
+## Repository Setup
+
+The GitHub repository was provisioned with an onboarding placeholder that indicates repository setup and access control configuration may still need to be completed in the onboarding portal.
+
+Until that setup is complete, some repository settings or access-management actions may remain restricted.
+
+Python package for a Microsoft OpenTelemetry distribution that provides a single onboarding experience for observability across Azure Monitor, OTLP-compatible backends, and Microsoft Agent 365 style integrations.
+
+This repository starts from the POC described in `azure-data/microsoft-opentelemetry-distro-poc`, but is intentionally kept minimal while the package shape and delivery plan are being defined.
+
+## Goal
+
+The target package should reduce fragmented setup across multiple observability stacks to one import and one configuration function.
+
+Intended API shape:
+
+```python
+from microsoft.opentelemetry import use_microsoft_opentelemetry
+
+use_microsoft_opentelemetry(
+	azure_monitor_connection_string="InstrumentationKey=...;IngestionEndpoint=...",
+)
+```
+
+### Available Configuration Options
+
+| Keyword argument | Type | Default | Description |
+|---|---|---|---|
+| `enable_azure_monitor` | `bool` | `True` | Enable Azure Monitor export. |
+| `azure_monitor_connection_string` | `str` | `None` | Connection string for Application Insights. Also read from `APPLICATIONINSIGHTS_CONNECTION_STRING` env var. |
+| `azure_monitor_exporter_credential` | `TokenCredential` | `None` | Azure AD token credential for authentication. |
+| `azure_monitor_enable_live_metrics` | `bool` | `True` | Enable live metrics collection. |
+| `azure_monitor_enable_performance_counters` | `bool` | `True` | Enable performance counter collection. |
+| `azure_monitor_exporter_disable_offline_storage` | `bool` | `False` | Disable offline retry storage for failed telemetry. |
+| `azure_monitor_exporter_storage_directory` | `str` | `None` | Custom directory for offline telemetry storage. |
+| `azure_monitor_browser_sdk_loader_config` | `dict` | `None` | Browser SDK loader configuration. |
+| `disable_logging` | `bool` | `False` | Disable the logging pipeline. |
+| `disable_tracing` | `bool` | `False` | Disable the tracing pipeline. |
+| `disable_metrics` | `bool` | `False` | Disable the metrics pipeline. |
+| `resource` | `Resource` | auto | OpenTelemetry Resource. |
+| `span_processors` | `list` | `[]` | Additional span processors. |
+| `log_record_processors` | `list` | `[]` | Additional log record processors. |
+| `metric_readers` | `list` | `[]` | Additional metric readers. |
+| `views` | `list` | `[]` | Metric views. |
+| `logger_name` | `str` | `None` | Logger name for log collection. |
+| `logging_formatter` | `Formatter` | `None` | Formatter for collected logs. |
+| `instrumentation_options` | `dict` | `None` | Per-library instrumentation enable/disable options. |
+| `enable_trace_based_sampling_for_logs` | `bool` | `False` | Enable trace-based sampling for logs. |
+
+### Sampling Configuration
+
+Sampling is configured via standard OpenTelemetry environment variables:
+
+| Environment variable | Description |
+|---|---|
+| `OTEL_TRACES_SAMPLER` | Sampler type to use (see supported values below). |
+| `OTEL_TRACES_SAMPLER_ARG` | Argument for the sampler (e.g. sample ratio or traces per second). |
+
+**Supported sampler values for `OTEL_TRACES_SAMPLER`:**
+
+| Value | Description |
+|---|---|
+| `always_on` | Sample every trace. |
+| `always_off` | Drop every trace. |
+| `trace_id_ratio` | Sample a fixed percentage based on trace ID. Set ratio with `OTEL_TRACES_SAMPLER_ARG` (0–1). |
+| `parentbased_always_on` | Parent-based, defaults to always on. |
+| `parentbased_always_off` | Parent-based, defaults to always off. |
+| `parentbased_trace_id_ratio` | Parent-based with trace ID ratio fallback. |
+| `microsoft.fixed_percentage` | Azure Monitor fixed-percentage sampler. Set ratio with `OTEL_TRACES_SAMPLER_ARG` (0–1). |
+| `microsoft.rate_limited` | Azure Monitor rate-limited sampler. Set target with `OTEL_TRACES_SAMPLER_ARG` (traces per second, default 5). |
+
+**Example:**
+
+```bash
+export OTEL_TRACES_SAMPLER=trace_id_ratio
+export OTEL_TRACES_SAMPLER_ARG=0.1
+```
+
+## Planned Scope
+
+- Azure Monitor exporter support
+- OTLP exporter support
+- Microsoft-specific agent observability extensions
+- GenAI instrumentation toggles for OpenAI, OpenAI Agents, and LangChain
+- Standard Python web and HTTP instrumentations
+- Environment-variable driven configuration
+- A stable package surface for downstream agent applications
+
+## Reference POC Highlights
+
+The source POC positions the distro around three outcomes:
+
+- one package, one API, one documentation surface
+- less duplicated exporter and instrumentation wiring across teams
+- much less application boilerplate compared with manual OpenTelemetry setup
+
+The POC also describes this execution model:
+
+1. Configure Azure Monitor when enabled
+2. Otherwise create standalone OpenTelemetry providers
+3. Attach OTLP exporters when requested
+4. Attach Microsoft-specific exporters when requested
+5. Enable standard instrumentations
+6. Enable Microsoft-specific observability instrumentations
+7. Enable GenAI contrib instrumentations
+
+## Development
+
+Create an environment and install the project with test dependencies:
+
+```bash
+pip install -e .[test]
+pytest
+```
+
+## Reference
+
+- POC repo: https://github.com/azure-data/microsoft-opentelemetry-distro-poc
+- Planning document: [PLANNING.md](./PLANNING.md)
+
+## Contributing
+
+Read our [contributing guide](./CONTRIBUTING.md) to learn about our development process, how to propose bugfixes and improvements, and how to build and test your changes to this distribution.
+
+## Data Collection
+
+As this SDK is designed to enable applications to perform data collection which is sent to the Microsoft collection endpoints the following is required to identify our privacy statement.
+
+The software may collect information about you and your use of the software and send it to Microsoft. Microsoft may use this information to provide services and improve our products and services. You may turn off the telemetry as described in the repository. There are also some features in the software that may enable you and Microsoft to collect data from users of your applications. If you use these features, you must comply with applicable law, including providing appropriate notices to users of your applications together with a copy of Microsoft’s privacy statement. Our privacy statement is located at https://go.microsoft.com/fwlink/?LinkID=824704. You can learn more about data collection and use in the help documentation and our privacy statement. Your use of the software operates as your consent to these practices.
+
+## Trademarks
+
+This project may contain trademarks or logos for projects, products, or services. Authorized use of Microsoft trademarks or logos is subject to and must follow [Microsoft’s Trademark & Brand Guidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general). Use of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship. Any use of third-party trademarks or logos are subject to those third-party’s policies.
+
+## License
+
+[MIT](LICENSE)

microsoft_opentelemetry-0.1.0a1/pyproject.toml

@@ -0,0 +1,102 @@
+[build-system]
+requires = ["setuptools>=69"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "microsoft-opentelemetry"
+version = "0.1.0a1"
+description = "Minimal template for the Microsoft OpenTelemetry distro for Python"
+readme = "README.md"
+requires-python = ">=3.10"
+dependencies = [
+    "azure-core<2.0.0,>=1.28.0",
+    "azure-core-tracing-opentelemetry~=1.0.0b11",
+    "azure-monitor-opentelemetry-exporter~=1.0.0b49",
+    "opentelemetry-sdk==1.40",
+    "opentelemetry-api==1.40",
+    "opentelemetry-exporter-otlp-proto-http==1.40",
+    "opentelemetry-instrumentation==0.61b0",
+    "opentelemetry-instrumentation-django==0.61b0",
+    "opentelemetry-instrumentation-fastapi==0.61b0",
+    "opentelemetry-instrumentation-flask==0.61b0",
+    "opentelemetry-instrumentation-psycopg2==0.61b0",
+    "opentelemetry-instrumentation-requests==0.61b0",
+    "opentelemetry-instrumentation-urllib==0.61b0",
+    "opentelemetry-instrumentation-urllib3==0.61b0",
+    "opentelemetry-instrumentation-logging==0.61b0",
+    "opentelemetry.exporter.otlp.proto.grpc==1.40",
+    "opentelemetry-resource-detector-azure<1.0.0,>=0.1.5",
+    "langchain-core>=0.2.0",
+    "wrapt>=1.0",
+    "opentelemetry-util-genai>=0.3b0",
+    "microsoft-agents-activity>=0.9.0",
+    "microsoft-agents-hosting-core>=0.9.0",
+    "aiohttp>=3.8.0"
+]
+
+[project.optional-dependencies]
+test = [
+    "pytest>=8.0",
+    "pytest-cov>=5.0",
+]
+dev = [
+    "black>=24.0",
+    "pylint>=3.3",
+    "mypy>=1.10",
+    "pyright>=1.1",
+    "pytest>=8.0",
+    "pytest-cov>=5.0",
+]
+
+[project.entry-points.opentelemetry_instrumentor]
+langchain = "microsoft.genai._langchain._tracer_instrumentor:LangChainInstrumentor"
+
+[tool.setuptools]
+package-dir = {"" = "src"}
+
+[tool.setuptools.packages.find]
+where = ["src"]
+namespaces = true
+
+[tool.black]
+line-length = 120
+target-version = ["py310"]
+
+[tool.pylint.main]
+py-version = "3.10"
+
+[tool.pylint.format]
+max-line-length = 120
+
+[tool.coverage.run]
+source = ["microsoft"]
+
+[tool.coverage.report]
+show_missing = true
+
+[tool.pylint.messages_control]
+disable = [
+    "missing-function-docstring",
+    "missing-module-docstring",
+    "missing-class-docstring",
+    "import-outside-toplevel",
+    "import-error",
+    "no-name-in-module",
+    "duplicate-code",
+    "too-few-public-methods",
+    "too-many-arguments",
+    "too-many-positional-arguments",
+    "too-many-locals",
+    "wrong-import-order",
+    "ungrouped-imports",
+    "unknown-option-value",
+    "fixme",
+    "invalid-name",
+    "unused-argument",
+    "protected-access",
+    "too-many-lines",
+    "too-many-public-methods",
+]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]

microsoft_opentelemetry-0.1.0a1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

microsoft_opentelemetry-0.1.0a1/src/microsoft/__init__.py

@@ -0,0 +1 @@
+__path__ = __import__("pkgutil").extend_path(__path__, __name__)

microsoft_opentelemetry-0.1.0a1/src/microsoft/agents/a365/observability/__init__.py

@@ -0,0 +1,19 @@
+# -------------------------------------------------------------------------
+# Copyright (c) Microsoft Corporation. All rights reserved.
+# Licensed under the MIT License. See License.txt in the project root for
+# license information.
+# --------------------------------------------------------------------------
+
+"""Agent365 exporter integration for the Microsoft OpenTelemetry Distro."""
+
+from microsoft.agents.a365.observability.core.exporters.utils import (  # noqa: F401
+    A365Handlers,
+    create_a365_components,
+    is_a365_enabled,
+)
+
+__all__ = [
+    "A365Handlers",
+    "create_a365_components",
+    "is_a365_enabled",
+]

microsoft_opentelemetry-0.1.0a1/src/microsoft/agents/a365/observability/constants.py

@@ -0,0 +1,133 @@
+# -------------------------------------------------------------------------
+# Copyright (c) Microsoft Corporation. All rights reserved.
+# Licensed under the MIT License. See License.txt in the project root for
+# license information.
+# --------------------------------------------------------------------------
+
+"""Constants for Agent365 observability.
+
+Superset of microsoft-agents-a365-observability-core constants plus
+distro-specific environment variable constants.
+"""
+
+# --- Span operation names ---
+INVOKE_AGENT_OPERATION_NAME = "invoke_agent"
+EXECUTE_TOOL_OPERATION_NAME = "execute_tool"
+OUTPUT_MESSAGES_OPERATION_NAME = "output_messages"
+CHAT_OPERATION_NAME = "chat"
+
+# --- OpenTelemetry semantic conventions ---
+ERROR_TYPE_KEY = "error.type"
+ERROR_MESSAGE_KEY = "error.message"
+AZ_NAMESPACE_KEY = "az.namespace"
+AZURE_RP_NAMESPACE_VALUE = "Microsoft.CognitiveServices"
+SOURCE_NAME = "Agent365Sdk"
+
+# --- Feature switches ---
+ENABLE_OPENTELEMETRY_SWITCH = "Azure.Experimental.EnableActivitySource"
+TRACE_CONTENTS_SWITCH = "Azure.Experimental.TraceGenAIMessageContent"
+TRACE_CONTENTS_ENVIRONMENT_VARIABLE = "AZURE_TRACING_GEN_AI_CONTENT_RECORDING_ENABLED"
+ENABLE_OBSERVABILITY = "ENABLE_OBSERVABILITY"
+ENABLE_A365_OBSERVABILITY = "ENABLE_A365_OBSERVABILITY"
+
+# --- GenAI semantic conventions ---
+GEN_AI_CLIENT_OPERATION_DURATION_METRIC_NAME = "gen_ai.client.operation.duration"
+GEN_AI_CLIENT_TOKEN_USAGE_METRIC_NAME = "gen_ai.client.token.usage"
+GEN_AI_OPERATION_NAME_KEY = "gen_ai.operation.name"
+GEN_AI_REQUEST_MAX_TOKENS_KEY = "gen_ai.request.max_tokens"
+GEN_AI_REQUEST_MODEL_KEY = "gen_ai.request.model"
+GEN_AI_REQUEST_TEMPERATURE_KEY = "gen_ai.request.temperature"
+GEN_AI_REQUEST_TOP_P_KEY = "gen_ai.request.top_p"
+GEN_AI_RESPONSE_FINISH_REASONS_KEY = "gen_ai.response.finish_reasons"
+GEN_AI_RESPONSE_MODEL_KEY = "gen_ai.response.model"
+GEN_AI_RESPONSE_ID_KEY = "gen_ai.response.id"
+GEN_AI_AGENT_ID_KEY = "gen_ai.agent.id"
+GEN_AI_AGENT_NAME_KEY = "gen_ai.agent.name"
+GEN_AI_AGENT_DESCRIPTION_KEY = "gen_ai.agent.description"
+GEN_AI_AGENT_VERSION_KEY = "gen_ai.agent.version"
+GEN_AI_AGENT_PLATFORM_ID_KEY = "microsoft.a365.agent.platform.id"
+GEN_AI_AGENT_THOUGHT_PROCESS_KEY = "microsoft.a365.agent.thought.process"
+GEN_AI_CONVERSATION_ID_KEY = "gen_ai.conversation.id"
+GEN_AI_CONVERSATION_ITEM_LINK_KEY = "microsoft.conversation.item.link"
+GEN_AI_TOKEN_TYPE_KEY = "gen_ai.token.type"
+GEN_AI_USAGE_INPUT_TOKENS_KEY = "gen_ai.usage.input_tokens"
+GEN_AI_USAGE_OUTPUT_TOKENS_KEY = "gen_ai.usage.output_tokens"
+GEN_AI_CHOICE = "gen_ai.choice"
+GEN_AI_PROVIDER_NAME_KEY = "gen_ai.provider.name"
+GEN_AI_SYSTEM_INSTRUCTIONS_KEY = "gen_ai.system_instructions"
+GEN_AI_INPUT_MESSAGES_KEY = "gen_ai.input.messages"
+GEN_AI_OUTPUT_MESSAGES_KEY = "gen_ai.output.messages"
+
+# --- Tool execution ---
+GEN_AI_TOOL_CALL_ID_KEY = "gen_ai.tool.call.id"
+GEN_AI_TOOL_NAME_KEY = "gen_ai.tool.name"
+GEN_AI_TOOL_DESCRIPTION_KEY = "gen_ai.tool.description"
+GEN_AI_TOOL_ARGS_KEY = "gen_ai.tool.call.arguments"
+GEN_AI_TOOL_CALL_RESULT_KEY = "gen_ai.tool.call.result"
+GEN_AI_TOOL_TYPE_KEY = "gen_ai.tool.type"
+
+# --- Human caller ---
+USER_ID_KEY = "user.id"
+USER_NAME_KEY = "user.name"
+USER_EMAIL_KEY = "user.email"
+GEN_AI_CALLER_CLIENT_IP_KEY = "client.address"
+
+# --- Agent-to-Agent caller ---
+GEN_AI_CALLER_AGENT_USER_ID_KEY = "microsoft.a365.caller.agent.user.id"
+GEN_AI_CALLER_AGENT_EMAIL_KEY = "microsoft.a365.caller.agent.user.email"
+GEN_AI_CALLER_AGENT_NAME_KEY = "microsoft.a365.caller.agent.name"
+GEN_AI_CALLER_AGENT_ID_KEY = "microsoft.a365.caller.agent.id"
+GEN_AI_CALLER_AGENT_APPLICATION_ID_KEY = "microsoft.a365.caller.agent.blueprint.id"
+GEN_AI_CALLER_AGENT_PLATFORM_ID_KEY = "microsoft.a365.caller.agent.platform.id"
+GEN_AI_CALLER_AGENT_VERSION_KEY = "microsoft.a365.caller.agent.version"
+
+# --- Agent-specific dimensions ---
+AGENT_ID_KEY = "gen_ai.agent.id"
+GEN_AI_TASK_ID_KEY = "gen_ai.task.id"
+GEN_AI_ICON_URI_KEY = "gen_ai.agent365.icon_uri"
+GEN_AI_EXECUTION_PAYLOAD_KEY = "gen_ai.execution.payload"
+TENANT_ID_KEY = "microsoft.tenant.id"
+GEN_AI_AGENT_AUID_KEY = "microsoft.agent.user.id"
+GEN_AI_AGENT_EMAIL_KEY = "microsoft.agent.user.email"
+GEN_AI_AGENT_BLUEPRINT_ID_KEY = "microsoft.a365.agent.blueprint.id"
+SESSION_ID_KEY = "microsoft.session.id"
+SESSION_DESCRIPTION_KEY = "microsoft.session.description"
+
+# --- Error type constants ---
+ERROR_TYPE_CANCELLED = "TaskCanceledException"
+
+# --- OTel standard keys ---
+SERVER_ADDRESS_KEY = "server.address"
+SERVER_PORT_KEY = "server.port"
+SERVICE_NAME_KEY = "service.name"
+
+# --- Custom span keys ---
+CUSTOM_PARENT_SPAN_ID_KEY = "custom.parent.span.id"
+CUSTOM_SPAN_NAME_KEY = "custom.span.name"
+
+# --- Channel ---
+CHANNEL_NAME_KEY = "microsoft.channel.name"
+CHANNEL_LINK_KEY = "microsoft.channel.link"
+
+# --- Telemetry SDK attributes ---
+TELEMETRY_SDK_NAME_KEY = "telemetry.sdk.name"
+TELEMETRY_SDK_LANGUAGE_KEY = "telemetry.sdk.language"
+TELEMETRY_SDK_VERSION_KEY = "telemetry.sdk.version"
+TELEMETRY_SDK_NAME_VALUE = "A365ObservabilitySDK"
+TELEMETRY_SDK_LANGUAGE_VALUE = "python"
+
+# --- Distro environment variable names ---
+ENABLE_A365_OBSERVABILITY_EXPORTER = "ENABLE_A365_OBSERVABILITY_EXPORTER"
+A365_OBSERVABILITY_DOMAIN_OVERRIDE = "A365_OBSERVABILITY_DOMAIN_OVERRIDE"
+A365_TENANT_ID_ENV = "A365_TENANT_ID"
+A365_AGENT_ID_ENV = "A365_AGENT_ID"
+A365_CLUSTER_CATEGORY_ENV = "A365_CLUSTER_CATEGORY"
+A365_USE_S2S_ENDPOINT_ENV = "A365_USE_S2S_ENDPOINT"
+A365_SUPPRESS_INVOKE_AGENT_INPUT_ENV = "A365_SUPPRESS_INVOKE_AGENT_INPUT"
+
+# --- FIC (Federated Identity Credential) token flow env vars ---
+A365_AGENT_APP_INSTANCE_ID_ENV = "A365_AGENT_APP_INSTANCE_ID"
+A365_AGENTIC_USER_ID_ENV = "A365_AGENTIC_USER_ID"
+A365_SERVICE_CLIENT_ID_ENV = "CONNECTIONS__SERVICE_CONNECTION__SETTINGS__CLIENTID"
+A365_SERVICE_CLIENT_SECRET_ENV = "CONNECTIONS__SERVICE_CONNECTION__SETTINGS__CLIENTSECRET"
+A365_SERVICE_TENANT_ID_ENV = "CONNECTIONS__SERVICE_CONNECTION__SETTINGS__TENANTID"