opentelemetry-instrumentation-asyncclick

What it is and what it does

This package is an OpenTelemetry instrumentation plugin that automatically captures tracing data from asyncclick CLI applications. It integrates with the asyncclick fork of the click library to emit spans representing command execution, argument parsing, and callback invocation, allowing you to observe CLI behavior within a distributed tracing system.

The instrumentation works by wrapping asyncclick's internal functions to emit OpenTelemetry events. It depends on opentelemetry-api, opentelemetry-instrumentation, opentelemetry-semantic-conventions, typing-extensions, and wrapt. Installation is straightforward and requires Python 3.10 or later. Once installed, it automatically instruments asyncclick calls when the OpenTelemetry SDK is initialized in your application.

Use it for:

• Monitor CLI tool execution in containerized environments where distributed tracing is already deployed
• Debug asyncclick command flows by examining trace spans in an OpenTelemetry backend
• Correlate CLI invocations with upstream service requests in a microservices architecture
• Measure CLI performance and identify bottlenecks in command argument processing

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Adds OpenTelemetry tracing to asyncclick CLI applications, capturing command execution and argument handling as distributed traces.

Yes, if you are already using OpenTelemetry in your infrastructure and need to trace asyncclick CLI applications. The low install friction, active maintenance, and permissive license make it a straightforward addition. The beta status is not a blocker for production use if your tracing requirements are clear, but verify that the instrumentation covers the asyncclick features you depend on.

Install

opentelemetry-instrumentation-asyncclick on PyPI

pip install opentelemetry-instrumentation-asyncclick

uv add opentelemetry-instrumentation-asyncclick

poetry add opentelemetry-instrumentation-asyncclick

Installing opentelemetry-instrumentation-asyncclick

Before you install

Low friction install with five stable runtime dependencies. Active maintenance—last commit 2026-08-14, released 29 days ago. Beta status (0.65b0) signals ongoing development but the repository is not archived and receives regular updates.

License in practice

Apache-2.0 permissive license allows use in most commercial and open-source projects without significant restriction.

Quickstart

pip install opentelemetry-instrumentation-asyncclick

import opentelemetry.instrumentation.asyncclick
from opentelemetry.sdk.trace import TracerProvider
from opentelemetry.sdk.trace.export import SimpleSpanProcessor

# Initialize tracing, then asyncclick calls will be instrumented

Requires Python 3.10 or later. Requires an initialized OpenTelemetry SDK in your application to emit traces.

Verify before relying

• Whether tracing overhead is acceptable for high-frequency CLI invocations
• Compatibility with asyncclick versions beyond what the instrumentation was tested against
• Whether the package instruments all asyncclick features or only a subset

Package facts

Evidence: opentelemetry_instrumentation_asyncclick-0.65b0-py3-none-any.whl

Tags

More Monitoring packages