Skip to content

Commit

Permalink
rel: prep beta release 0.1.2b0 (#112)
Browse files Browse the repository at this point in the history
## Which problem is this PR solving?

- lack of a published beta package

## Short description of the changes

- update version in `pyproject.toml` to 0.1.0b0
- add notes in `CHANGELOG.md` for beta release
- small cleanup throughout (typos, formatting, etc to clear up
squigglies from my editor)

---------

Co-authored-by: Mike Goldsmith <goldsmith.mike@gmail.com>
Co-authored-by: Robb Kidd <robbkidd@honeycomb.io>
  • Loading branch information
3 people committed Mar 30, 2023
1 parent 15c6b4c commit 9de4864
Show file tree
Hide file tree
Showing 10 changed files with 45 additions and 30 deletions.
11 changes: 11 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,16 @@
# honeycomb-opentelemetry-python changelog

## [0.1.2b0] - 2023-03-29

Initial beta release of Honeycomb's OpenTelemetry distribution for Python!

### Maintenance

- ci: require smoke tests for publish steps (#107) | [@pkanal](https://github.com/pkanal)
- maint: drop poetry locks from example apps (#111) | [@JamieDanielson](https://github.com/JamieDanielson)
- maint: add tests for auto instrumentation (#110) | [@JamieDanielson](https://github.com/JamieDanielson)
- maint(deps-dev): bump coverage from 6.5.0 to 7.2.1 (#104)

## [0.1.1a3] - 2023-03-07

### Enhancements
Expand Down
5 changes: 3 additions & 2 deletions DEVELOPING.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,8 @@ make build
```

## Examples
Check out the [Example Application overview](/examples/).

Check out the [Example Application overview](/examples/).

Note: Changes to python files in `src/honeycomb/opentelemetry` should propagate to the example applications upon save. Changes in the honeycomb.opentelemetry's pyproject.toml may need a `poetry build` to take effect in the example applications.

Expand Down Expand Up @@ -54,7 +55,7 @@ make smoke-sdk
# or specify a single protocol like with http or grpc:
make smoke-sdk-grpc

# To tidy up afer a test run, use:
# To tidy up after a test run, use:
make unsmoke
```

Expand Down
12 changes: 7 additions & 5 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,19 +1,22 @@
# Honeycomb OpenTelemetry Distro for Python

<!-- Uncomment once repo is public -->
[![OSS Lifecycle](https://img.shields.io/osslifecycle/honeycombio/honeycomb-opentelemetry-python)](https://github.com/honeycombio/home/blob/main/honeycomb-oss-lifecycle-and-practices.md)
[![CircleCI](https://circleci.com/gh/honeycombio/honeycomb-opentelemetry-python.svg?style=shield)](https://circleci.com/gh/honeycombio/honeycomb-opentelemetry-python)

This is Honeycomb's Distribution of OpenTelemetry for python.
This is Honeycomb's Distribution of OpenTelemetry for Python.
It makes getting started with OpenTelemetry and Honeycomb easier!

Latest release built with:

- [OpenTelemetry version 1.16.0/0.37b0](https://github.com/open-telemetry/opentelemetry-python/releases/tag/v1.16.0)

## Requirements

* Python 3.7 or higher
- Python 3.7 or higher

## Getting Started

Honeycomb's Distribution of OpenTelemetry for python allows you to streamline configuration and to instrument as quickly and easily as possible.
Honeycomb's Distribution of OpenTelemetry for Python allows you to streamline configuration and to instrument as quickly and easily as possible.

- [Documentation](https://docs.honeycomb.io/getting-data-in/opentelemetry/python/)
- [Examples](/examples/)
Expand All @@ -30,4 +33,3 @@ Honeycomb's Distribution of OpenTelemetry for python allows you to streamline co
## License

[Apache 2.0 License](./LICENSE).

21 changes: 11 additions & 10 deletions examples/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,21 +3,23 @@
## [Hello World Flask](hello-world-flask/)

This example configures the distro using the `opentelemetry_instrument` command, and contains examples of:

- configuring the distro with environment variables
- sending metrics with OpenTelemetry using a counter
- using baggage with context tokens
- manually passing baggage with context
- setting a span attribute
- sending metrics with OpenTelemetry using a counter
- using baggage with context tokens
- manually passing baggage with context
- setting a span attribute

Check out the [Hello-World-Flask Readme](hello-world-flask/README.md) for setting this up!

## [Hello World Python](hello-world/)

This example configures the distro using the `configure_opentelemetry()` function, and contains examples of:
- configuring the distro with a combination of parameters and set environment variables
- sending metrics with OpenTelemetry using a counter
- using baggage with context tokens
- setting a span attribute

- configuring the distro with a combination of in-code parameters and environment variables
- sending metrics with OpenTelemetry using a counter
- using baggage with context tokens
- setting a span attribute

Check out the [Hello-World Readme](hello-world/README.md) for setting this up!

Expand All @@ -32,4 +34,3 @@ Because each example uses the same port, either comment out the other apps in th
```bash
cd smoke-tests && docker-compose up --build app-sdk-grpc
```

13 changes: 7 additions & 6 deletions examples/hello-world-flask/README.md
Original file line number Diff line number Diff line change
@@ -1,12 +1,13 @@
# hello-world-flask

This simple Flask app that returns "Hello World". This app configures OpenTelemetry to send data to Honeycomb using the `opentelemetry_instrument` command and environment variables.
This simple Flask app that returns "Hello World". This app configures OpenTelemetry to send data to Honeycomb using the `opentelemetry_instrument` command and environment variables.

It also contains examples of:
- sending metrics with OpenTelemetry using a counter
- using baggage with context tokens
- manually passing baggage with context
- setting a span attribute

- sending metrics with OpenTelemetry using a counter
- using baggage with context tokens
- manually passing baggage with context
- setting a span attribute

If you are looking for an example using the `configure_opentelemetry()` function and parameters, check out [hello-world app](../hello-world/README.md).

Expand Down Expand Up @@ -53,4 +54,4 @@ To enable metrics, you will need to set a metrics dataset:
`HONEYCOMB_METRICS_DATASET=otel-python-example-metrics`

You can configure exporter protocol with this flag:
`OTEL_EXPORTER_OTLP_PROTOCOL=grpc` or `OTEL_EXPORTER_OTLP_PROTOCOL=http/protobuf`
`OTEL_EXPORTER_OTLP_PROTOCOL=grpc` or `OTEL_EXPORTER_OTLP_PROTOCOL=http/protobuf`
3 changes: 1 addition & 2 deletions examples/hello-world/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -24,7 +24,7 @@ The app will output `Hello World` and then exit.

## Distro Instrumentation Example

This app uses configuration in code parameters rather than stricly commandline and environment variables.
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:

```python
Expand All @@ -47,4 +47,3 @@ 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`

2 changes: 1 addition & 1 deletion pyproject.toml
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
[tool.poetry]
name = "honeycomb-opentelemetry"
version = "0.1.1a3"
version = "0.1.2b0"
description = "Honeycomb OpenTelemetry Distro for Python"
authors = ["Honeycomb <support@honeycomb.io>"]
readme = "README.md"
Expand Down
2 changes: 1 addition & 1 deletion src/honeycomb/opentelemetry/local_exporter.py
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,7 @@ def configure_local_exporter(options: HoneycombOptions):
direct web links for completed traces in Honeycomb on stdout.
Args:
options (HoneycombOptions): the HoneycombOptins used to configure
options (HoneycombOptions): the HoneycombOptions used to configure
the exporter
Returns:
Expand Down
4 changes: 2 additions & 2 deletions src/honeycomb/opentelemetry/sampler.py
Original file line number Diff line number Diff line change
Expand Up @@ -31,7 +31,7 @@ def configure_sampler(
sampling decision.
Args:
options (HoneycombOptions): the HoneycombOptins containing
options (HoneycombOptions): the HoneycombOptions containing
sample_rate used to configure the deterministic sampler.
Returns:
Expand Down Expand Up @@ -65,7 +65,7 @@ def __init__(self, rate: int):
self._sampler = ALWAYS_ON

else:
# Sampler that samples probabalistically based on rate..
# Sampler that samples probabilistically based on rate..
ratio = 1.0 / self.rate
self._sampler = TraceIdRatioBased(ratio)

Expand Down
2 changes: 1 addition & 1 deletion tests/test_metrics.py
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@ def test_returns_meter_provider():
assert len(meter_provider._sdk_config.metric_readers) == 1


def test_setting_debug_addings_console_exporter():
def test_setting_debug_adds_console_exporter():
options = HoneycombOptions(debug=True)
resource = create_resource(options)
meter_provider = create_meter_provider(options, resource)
Expand Down

0 comments on commit 9de4864

Please sign in to comment.