Skip to main content

Uptrace client for Python

Project description

Uptrace for Python

build workflow Documentation

Installation

Introduction

uptrace-python is an OpenTelemery distribution configured to export traces to Uptrace.

Quickstart

Install uptrace-python:

pip install uptrace

Run the basic example below using the DSN from the Uptrace project settings page.

#!/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()

For more details, please see documentation and examples.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

uptrace-1.5.0.tar.gz (5.7 kB view details)

Uploaded Source

Built Distribution

uptrace-1.5.0-py3-none-any.whl (6.7 kB view details)

Uploaded Python 3

File details

Details for the file uptrace-1.5.0.tar.gz.

File metadata

  • Download URL: uptrace-1.5.0.tar.gz
  • Upload date:
  • Size: 5.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.2.0 pkginfo/1.6.1 requests/2.22.0 setuptools/45.2.0 requests-toolbelt/0.9.1 tqdm/4.50.2 CPython/3.8.10

File hashes

Hashes for uptrace-1.5.0.tar.gz
Algorithm Hash digest
SHA256 a3db34b9600c87d8de4fa764838d7bda00994f1858ce7eafdaf49e012978de95
MD5 f031ae234900029dba41183b962977c6
BLAKE2b-256 c7d99b0db31308c97ae79654f134991765295bb553d6d8e9b1e884058ebbe5e1

See more details on using hashes here.

File details

Details for the file uptrace-1.5.0-py3-none-any.whl.

File metadata

  • Download URL: uptrace-1.5.0-py3-none-any.whl
  • Upload date:
  • Size: 6.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.2.0 pkginfo/1.6.1 requests/2.22.0 setuptools/45.2.0 requests-toolbelt/0.9.1 tqdm/4.50.2 CPython/3.8.10

File hashes

Hashes for uptrace-1.5.0-py3-none-any.whl
Algorithm Hash digest
SHA256 a62e2d5975eb7dbed92d37273e982523dba3874bb7e5fde2e38e6028eb03c84e
MD5 2857ad5f2376b6672dd6342bb7492830
BLAKE2b-256 961c8515b148c0c693f3e8a23acff8a661cb463b86bc7e2940513959dbd247e7

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page