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

Uploaded Source

Built Distribution

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

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for uptrace-1.14.0.tar.gz
Algorithm Hash digest
SHA256 20d96df7865be64f084fe39fae906c8b03a7e0fa15ae0aae1f396295dc7480f2
MD5 ade365253cd76d8206791af103e56338
BLAKE2b-256 1ff752f6908dba2e33fb7242910bf5258896db8701fa1c924bee85f17dea5bb6

See more details on using hashes here.

File details

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

File metadata

  • Download URL: uptrace-1.14.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.14.0-py3-none-any.whl
Algorithm Hash digest
SHA256 9bab849d6c1246daee90e8e660719aa44bb2ddebc4f4c06d74237bc0a9c8fa1f
MD5 83e609d993be32f7ae7bf309ebc77f75
BLAKE2b-256 19e00a27b78cbfe4ea00ffccf846e81ab14326c236770f3e2c8036cd60e43319

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