Metadata-Version: 2.1
Name: uptrace
Version: 1.12.0rc2
Summary: Uptrace client for Python
Home-page: https://uptrace.dev
Author: Uptrace.dev
Author-email: support@uptrace.dev
License: BSD
Description: # Uptrace for Python
        
        ![build workflow](https://github.com/uptrace/uptrace-python/actions/workflows/build.yml/badge.svg)
        [![Documentation](https://img.shields.io/badge/uptrace-documentation-informational)](https://docs.uptrace.dev/guide/python.html)
        [![Chat](https://img.shields.io/matrix/uptrace:matrix.org)](https://matrix.to/#/#uptrace:matrix.org)
        
        <a href="https://docs.uptrace.dev/guide/python.html">
          <img src="https://docs.uptrace.dev/devicon/python-original.svg" height="200px" />
        </a>
        
        ## Installation
        
        ## Introduction
        
        uptrace-python is an OpenTelemery distribution configured to export
        [traces](https://opentelemetry.uptrace.dev/guide/distributed-tracing.html) to Uptrace.
        
        ## Quickstart
        
        Install uptrace-python:
        
        ```bash
        pip install uptrace
        ```
        
        Run the [basic example](example/basic) below using the DSN from the Uptrace project settings page.
        
        ```python
        #!/usr/bin/env python3
        
        import uptrace
        from opentelemetry import trace
        
        # Set dsn or UPTRACE_DSN env var.
        uptrace.configure_opentelemetry(
            dsn="", service_name="myservice", service_version="1.0.0"
        )
        tracer = trace.get_tracer("app_or_package_name", "1.0.0")
        
        with tracer.start_as_current_span("main") as span:
            with tracer.start_as_current_span("child1") as span:
                span.set_attribute("key1", "value1")
                span.record_exception(ValueError("error1"))
        
            with tracer.start_as_current_span("child2") as span:
                span.set_attribute("key2", "value2")
                span.set_attribute("key3", 123.456)
        
            print("trace:", uptrace.trace_url(span))
        
        # Send buffered spans.
        trace.get_tracer_provider().shutdown()
        ```
        
        ## Links
        
        - [Examples](example)
        - [Documentation](https://docs.uptrace.dev/guide/python.html)
        - [Instrumentations](https://opentelemetry.uptrace.dev/instrumentations/?lang=python)
        
Platform: any
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Typing :: Typed
Requires-Python: >=3.7
Description-Content-Type: text/markdown
