Skip to main content

OpenTelemetry Python distribution for Uptrace

Project description

Uptrace for Python

build workflow Documentation Chat

Introduction

uptrace-python is an OpenTelemery distribution configured to export traces and metrics 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.17.0.tar.gz (7.7 kB view details)

Uploaded Source

Built Distribution

uptrace-1.17.0-py3-none-any.whl (7.7 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: uptrace-1.17.0.tar.gz
  • Upload date:
  • Size: 7.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.1 CPython/3.10.6

File hashes

Hashes for uptrace-1.17.0.tar.gz
Algorithm Hash digest
SHA256 c1c498d932fa35eb1df504b42cf948848319a5ab37a02c780d980fd39dd49bfa
MD5 09025f1add5d2f475404b05f982ef883
BLAKE2b-256 f3ada881b2c52e876c4162a99b3fe7b4150ead43faedbbecf0f7e05076094699

See more details on using hashes here.

File details

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

File metadata

  • Download URL: uptrace-1.17.0-py3-none-any.whl
  • Upload date:
  • Size: 7.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.1 CPython/3.10.6

File hashes

Hashes for uptrace-1.17.0-py3-none-any.whl
Algorithm Hash digest
SHA256 9572644b1700a3c42c07182ffbae263b9934b4ce9c7f50c832e982bde4c0acef
MD5 4f478b5031ce989d28edde849fdb5171
BLAKE2b-256 318fe4141b44f95a41d6b3ae1365859cd6666355790f8835f1b1b44e2d990677

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