---
id: opentelemetry-instrumentation-asyncclick
version: "0.65b0"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# opentelemetry-instrumentation-asyncclick — Async Click instrumentation for OpenTelemetry

License: permissive · Maintenance: active · Downloads: 309.7K/mo

## 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 above — 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

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

- License: Apache-2.0 (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 309.7K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

asyncclick tracing, opentelemetry cli instrumentation, async click observability, command-line tracing, distributed tracing for cli, asyncclick monitoring, observability, cli-instrumentation, distributed-tracing

[View on SkillFed](https://skillfed.io/packages/opentelemetry-instrumentation-asyncclick) · [View on PyPI](https://pypi.org/project/opentelemetry-instrumentation-asyncclick/)