Skip to main content

OpenTelemetry Python distribution for Uptrace

Project description

Uptrace for Python

build workflow Documentation Chat

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()

Links

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.12.0.tar.gz (6.6 kB view details)

Uploaded Source

Built Distribution

uptrace-1.12.0-py3-none-any.whl (7.2 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: uptrace-1.12.0.tar.gz
  • Upload date:
  • Size: 6.6 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.12.0.tar.gz
Algorithm Hash digest
SHA256 86a74f3e49b17ffa0b23c704865edcb6d98552ac18b4d9e855a3204d228e5aee
MD5 cd136d54d59ac0a4096eab5d912173d1
BLAKE2b-256 9f5ef36334703f717e60ab508275501f028cb53c121682fdd45a765e41224f92

See more details on using hashes here.

File details

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

File metadata

  • Download URL: uptrace-1.12.0-py3-none-any.whl
  • Upload date:
  • Size: 7.2 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.12.0-py3-none-any.whl
Algorithm Hash digest
SHA256 55d9071992989040301b2b917a24a183c9460ec078a985d1e511390f289ff9d7
MD5 a80323db4722873504928492e64b23c2
BLAKE2b-256 567f9f3ac0994f5359c543e9992294ce80455b1c242badb5a5029fb7762927ff

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