README.md

hello-world

This simple Python app returns "Hello World". This app uses the configure_opentelemetry method from honeycomb.opentelemetry to set up OpenTelemetry to export data to Honeycomb through configuration options set in the app's code. It is also possible to set configuration options through the opentelemetry_instrument command (see the flask app as an example).

Prerequisites

You'll also need Poetry installed to run the example. Poetry automatically creates a virtual environment to run the example in so you don't need to manage one yourself.

Running the example

Install the dependencies:

poetry install

Run the application:

poetry run python3 app.py

The app will output Hello World and then exit.

Distro Instrumentation Example

This app uses configuration in code parameters rather than strictly command-line and environment variables. You can also use environment variables as parameters like below:

configure_opentelemetry(
    HoneycombOptions(
        debug=True,
        apikey=os.getenv("HONEYCOMB_API_KEY"),
        service_name="otel-python-example"
    )
)

This app will send traces to local console with the configured debug=True.

To send to Honeycomb, set the API Key:

HONEYCOMB_API_KEY="your-api-key" poetry run python3 app.py

You can configure exporter protocol with this flag: OTEL_EXPORTER_OTLP_PROTOCOL=grpc or OTEL_EXPORTER_OTLP_PROTOCOL=http/protobuf