Merge remote-tracking branch 'origin/main' into metrics

Author: Alex Boten

.flake8

@@ -16,9 +16,11 @@ exclude =
   venv*/
   target
   __pycache__
-  exporter/opentelemetry-exporter-jaeger/src/opentelemetry/exporter/jaeger/gen/
-  exporter/opentelemetry-exporter-jaeger/build/*
-  exporter/opentelemetry-exporter-zipkin/src/opentelemetry/exporter/zipkin/encoder/v2/protobuf/gen/
+  exporter/opentelemetry-exporter-jaeger-proto-grpc/src/opentelemetry/exporter/jaeger/proto/grpc/gen/
+  exporter/opentelemetry-exporter-jaeger-proto-grpc/build/*
+  exporter/opentelemetry-exporter-jaeger-thrift/src/opentelemetry/exporter/jaeger/thrift/gen/
+  exporter/opentelemetry-exporter-jaeger-thrift/build/*
+  exporter/opentelemetry-exporter-zipkin-proto-http/src/opentelemetry/exporter/zipkin/proto/http/v2/gen/
   docs/examples/opentelemetry-example-app/src/opentelemetry_example_app/grpc/gen/
   docs/examples/opentelemetry-example-app/build/*
   opentelemetry-proto/build/*

.github/workflows/test.yml

@@ -10,13 +10,12 @@ env:
   # Otherwise, set variable to the commit of your branch on
   # opentelemetry-python-contrib which is compatible with these Core repo
   # changes.
-  CONTRIB_REPO_SHA: 6e328246c895ff433b14430c9edddfead072287c
+  CONTRIB_REPO_SHA: 4fc64a01c118c640e273f56d2afb1b4597b82f0f
 
 jobs:
   build:
     env:
       # We use these variables to convert between tox and GHA version literals
-      py35: 3.5
       py36: 3.6
       py37: 3.7
       py38: 3.8
@@ -27,18 +26,9 @@ jobs:
     strategy:
       fail-fast: false  # ensures the entire test matrix is run, even if one permutation fails
       matrix:
-        python-version: [ py35, py36, py37, py38, py39, pypy3 ]
+        python-version: [ py36, py37, py38, py39, pypy3 ]
         package: ["instrumentation", "core", "exporter", "propagator"]
         os: [ ubuntu-latest ]
-        include:
-          # py35-instrumentation segfaults on 18.04 so we instead run on 20.04
-          - python-version: py35
-            package: instrumentation
-            os: ubuntu-20.04
-        exclude:
-          - os: ubuntu-latest
-            python-version: py35
-            package: instrumentation
     steps:
       - name: Checkout Core Repo @ SHA - ${{ github.sha }}
         uses: actions/checkout@v2
@@ -118,7 +108,6 @@ jobs:
   contrib-build:
     env:
       # We use these variables to convert between tox and GHA version literals
-      py35: 3.5
       py36: 3.6
       py37: 3.7
       py38: 3.8
@@ -128,18 +117,9 @@ jobs:
     strategy:
       fail-fast: false  # ensures the entire test matrix is run, even if one permutation fails
       matrix:
-        python-version: [ py35, py36, py37, py38, py39, pypy3 ]
+        python-version: [ py36, py37, py38, py39, pypy3 ]
         package: ["instrumentation", "exporter"]
         os: [ ubuntu-latest ]
-        include:
-          # py35-instrumentation segfaults on 18.04 so we instead run on 20.04
-          - python-version: py35
-            package: instrumentation
-            os: ubuntu-20.04
-        exclude:
-          - os: ubuntu-latest
-            python-version: py35
-            package: instrumentation
     steps:
       - name: Checkout Contrib Repo @ SHA - ${{ env.CONTRIB_REPO_SHA }}
         uses: actions/checkout@v2

CHANGELOG.md

@@ -4,31 +4,139 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-## [Unreleased](https://github.com/open-telemetry/opentelemetry-python/compare/v0.18b0...HEAD)
+## [Unreleased](https://github.com/open-telemetry/opentelemetry-python/compare/v1.0.0...HEAD)
+
+### Added
+- Added `py.typed` file to every package. This should resolve a bunch of mypy
+  errors for users.
+  ([#1720](https://github.com/open-telemetry/opentelemetry-python/pull/1720))
+
+### Changed
+- Adjust `B3Format` propagator to be spec compliant by not modifying context
+  when propagation headers are not present/invalid/empty
+  ([#1728](https://github.com/open-telemetry/opentelemetry-python/pull/1728))
+- Update bootstrap cmd to use exact version when installing instrumentation packages. 
+  ([#1722](https://github.com/open-telemetry/opentelemetry-python/pull/1722))
+- Renamed `otlp_metric` entrypoint to `otlp_proto_grpc_metric` for OTLP Proto gRPC
+  MetricsExporter.
+
+
+## [1.0.0](https://github.com/open-telemetry/opentelemetry-python/releases/tag/v1.0.0) - 2021-03-26
+### Added
+- Document how to work with fork process web server models(Gunicorn, uWSGI etc...)
+  ([#1609](https://github.com/open-telemetry/opentelemetry-python/pull/1609))
+- Add `max_attr_value_length` support to Jaeger exporter
+  ([#1633](https://github.com/open-telemetry/opentelemetry-python/pull/1633))
+- Moved `use_span` from Tracer to `opentelemetry.trace.use_span`.
+  ([#1668](https://github.com/open-telemetry/opentelemetry-python/pull/1668))
+- `opentelemetry.trace.use_span()` will now overwrite previously set status on span in case an
+  exception is raised inside the context manager and `set_status_on_exception` is set to `True`.
+  ([#1668](https://github.com/open-telemetry/opentelemetry-python/pull/1668))
+- Add `udp_split_oversized_batches` support to jaeger exporter
+  ([#1500](https://github.com/open-telemetry/opentelemetry-python/pull/1500))
+
+### Changed
+- remove `service_name` from constructor of jaeger and opencensus exporters and 
+  use of env variable `OTEL_PYTHON_SERVICE_NAME`
+  ([#1669])(https://github.com/open-telemetry/opentelemetry-python/pull/1669)
+- Rename `IdsGenerator` to `IdGenerator`
+  ([#1651](https://github.com/open-telemetry/opentelemetry-python/pull/1651))
+- Make TracerProvider's resource attribute private
+  ([#1652](https://github.com/open-telemetry/opentelemetry-python/pull/1652))
+- Rename Resource's `create_empty` to `get_empty`
+  ([#1653](https://github.com/open-telemetry/opentelemetry-python/pull/1653))
+- Renamed `BatchExportSpanProcessor` to `BatchSpanProcessor` and `SimpleExportSpanProcessor` to
+  `SimpleSpanProcessor`
+  ([#1656](https://github.com/open-telemetry/opentelemetry-python/pull/1656))
+- Rename `DefaultSpan` to `NonRecordingSpan`
+  ([#1661](https://github.com/open-telemetry/opentelemetry-python/pull/1661))
+- Fixed distro configuration with `OTEL_TRACES_EXPORTER` env var set to `otlp`
+  ([#1657](https://github.com/open-telemetry/opentelemetry-python/pull/1657))
+- Moving `Getter`, `Setter` and `TextMapPropagator` out of `opentelemetry.trace.propagation` and
+  into `opentelemetry.propagators`
+  ([#1662](https://github.com/open-telemetry/opentelemetry-python/pull/1662))
+- Rename `BaggagePropagator` to `W3CBaggagePropagator`
+  ([#1663](https://github.com/open-telemetry/opentelemetry-python/pull/1663))
+- Rename `JaegerSpanExporter` to `JaegerExporter` and rename `ZipkinSpanExporter` to `ZipkinExporter`
+  ([#1664](https://github.com/open-telemetry/opentelemetry-python/pull/1664))
+- Expose `StatusCode` from the `opentelemetry.trace` module
+  ([#1681](https://github.com/open-telemetry/opentelemetry-python/pull/1681))
+- Status now only sets `description` when `status_code` is set to `StatusCode.ERROR`
+  ([#1673](https://github.com/open-telemetry/opentelemetry-python/pull/1673))
+- Update OTLP exporter to use OTLP proto `0.7.0`
+  ([#1674](https://github.com/open-telemetry/opentelemetry-python/pull/1674))
+- Remove time_ns from API and add a warning for older versions of Python
+  ([#1602](https://github.com/open-telemetry/opentelemetry-python/pull/1602))
+- Hide implementation classes/variables in api/sdk
+  ([#1684](https://github.com/open-telemetry/opentelemetry-python/pull/1684))
+- Cleanup OTLP exporter compression options, add tests
+  ([#1671](https://github.com/open-telemetry/opentelemetry-python/pull/1671))
+- Initial documentation for environment variables
+  ([#1680](https://github.com/open-telemetry/opentelemetry-python/pull/1680))
+- Change Zipkin exporter to obtain service.name from span
+  ([#1696](https://github.com/open-telemetry/opentelemetry-python/pull/1696))
+- Split up `opentelemetry-exporter-jaeger` package into `opentelemetry-exporter-jaeger-proto-grpc` and
+  `opentelemetry-exporter-jaeger-thrift` packages to reduce dependencies for each one.
+  ([#1694](https://github.com/open-telemetry/opentelemetry-python/pull/1694))
+- Added `opentelemetry-exporter-otlp-proto-grpc` and changed `opentelemetry-exporter-otlp` to
+  install it as a dependency. This will allow for the next package/protocol to also be in
+  its own package.
+  ([#1695](https://github.com/open-telemetry/opentelemetry-python/pull/1695))
+- Change Jaeger exporters to obtain service.name from span
+  ([#1703](https://github.com/open-telemetry/opentelemetry-python/pull/1703))
+- Fixed an unset `OTEL_TRACES_EXPORTER` resulting in an error
+  ([#1707](https://github.com/open-telemetry/opentelemetry-python/pull/1707))
+- Split Zipkin exporter into `opentelemetry-exporter-zipkin-json` and
+  `opentelemetry-exporter-zipkin-proto-http` packages to reduce dependencies. The
+  `opentelemetry-exporter-zipkin` installs both.
+  ([#1699](https://github.com/open-telemetry/opentelemetry-python/pull/1699))
+- Make setters and getters optional
+  ([#1690](https://github.com/open-telemetry/opentelemetry-python/pull/1690))
+
+### Removed
+- Removed unused `get_hexadecimal_trace_id` and `get_hexadecimal_span_id` methods.
+  ([#1675](https://github.com/open-telemetry/opentelemetry-python/pull/1675))
+- Remove `OTEL_EXPORTER_*_ INSECURE` env var
+  ([#1682](https://github.com/open-telemetry/opentelemetry-python/pull/1682))
+- Removing support for Python 3.5
+  ([#1706](https://github.com/open-telemetry/opentelemetry-python/pull/1706))
+
+## [0.19b0](https://github.com/open-telemetry/opentelemetry-python/releases/tag/v0.19b0) - 2021-03-26
+
+### Changed
+- remove `service_name` from constructor of jaeger and opencensus exporters and 
+  use of env variable `OTEL_PYTHON_SERVICE_NAME`
+  ([#1669])(https://github.com/open-telemetry/opentelemetry-python/pull/1669)
+- Rename `IdsGenerator` to `IdGenerator`
+  ([#1651](https://github.com/open-telemetry/opentelemetry-python/pull/1651))
+
+### Removed
+- Removing support for Python 3.5
+  ([#1706](https://github.com/open-telemetry/opentelemetry-python/pull/1706))
 
 ## [0.18b0](https://github.com/open-telemetry/opentelemetry-python/releases/tag/v0.18b0) - 2021-02-16
 
 ### Added
 - Add urllib to opentelemetry-bootstrap target list
-  ([#1584])(https://github.com/open-telemetry/opentelemetry-python/pull/1584)
+  ([#1584](https://github.com/open-telemetry/opentelemetry-python/pull/1584))
 
 ## [1.0.0rc1](https://github.com/open-telemetry/opentelemetry-python/releases/tag/v1.0.0rc1) - 2021-02-12
 
 ### Changed
 - Tracer provider environment variables are now consistent with the rest
-  ([#1571](https://github.com/open-telemetry/opentelemetry-python/pull/1571)])
+  ([#1571](https://github.com/open-telemetry/opentelemetry-python/pull/1571))
 - Rename `TRACE_` to `TRACES_` for environment variables
-  ([#1595](https://github.com/open-telemetry/opentelemetry-python/pull/1595)])
+  ([#1595](https://github.com/open-telemetry/opentelemetry-python/pull/1595))
 - Limits for Span attributes, events and links have been updated to 128
-  ([1597](https://github.com/open-telemetry/opentelemetry-python/pull/1597)])
+  ([1597](https://github.com/open-telemetry/opentelemetry-python/pull/1597))
 - Read-only Span attributes have been moved to ReadableSpan class
   ([#1560](https://github.com/open-telemetry/opentelemetry-python/pull/1560))
 - `BatchExportSpanProcessor` flushes export queue when it reaches `max_export_batch_size`
-  ([#1521])(https://github.com/open-telemetry/opentelemetry-python/pull/1521)
+  ([#1521](https://github.com/open-telemetry/opentelemetry-python/pull/1521))
 
 ### Added
 - Added `end_on_exit` argument to `start_as_current_span`
-  ([#1519](https://github.com/open-telemetry/opentelemetry-python/pull/1519)])
+  ([#1519](https://github.com/open-telemetry/opentelemetry-python/pull/1519))
 - Add `Span.set_attributes` method to set multiple values with one call
   ([#1520](https://github.com/open-telemetry/opentelemetry-python/pull/1520))
 - Make sure Resources follow semantic conventions
@@ -68,7 +176,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - `opentelemetry-exporter-zipkin` Add support for array attributes in Span and Resource exports
   ([#1285](https://github.com/open-telemetry/opentelemetry-python/pull/1285))
 - Added `__repr__` for `DefaultSpan`, added `trace_flags` to `__repr__` of
-  `SpanContext` ([#1485](https://github.com/open-telemetry/opentelemetry-python/pull/1485)])
+  `SpanContext` ([#1485](https://github.com/open-telemetry/opentelemetry-python/pull/1485))
 - `opentelemetry-sdk` Add support for OTEL_TRACE_SAMPLER and OTEL_TRACE_SAMPLER_ARG env variables
   ([#1496](https://github.com/open-telemetry/opentelemetry-python/pull/1496))
 - Adding `opentelemetry-distro` package to add default configuration for

CONTRIBUTING.md

@@ -6,7 +6,7 @@ information on this and other language SIGs.
 
 See the [public meeting notes](https://docs.google.com/document/d/1CIMGoIOZ-c3-igzbd6_Pnxx1SjAkjwqoYSUWxPY8XIs/edit)
 for a summary description of past meetings. To request edit access, join the
-meeting or get in touch on [Gitter](https://gitter.im/open-telemetry/opentelemetry-python).
+meeting or get in touch on [Slack](https://cloud-native.slack.com/archives/C01PD4HUVBL).
 
 See to the [community membership document](https://github.com/open-telemetry/community/blob/main/community-membership.md)
 on how to become a [**Member**](https://github.com/open-telemetry/community/blob/main/community-membership.md#member),
@@ -20,7 +20,7 @@ Please take a look at this list first, your contributions may belong in one of t
 
 1. [OpenTelemetry Contrib](https://github.com/open-telemetry/opentelemetry-python-contrib): Instrumentations for third-party
    libraries and frameworks. There is an ongoing effort to migrate into the Opentelemetry Contrib repo some of the existing
-   programmatic instrumentations that are now in the `ext` directory in the main OpenTelemetry repo. Please ask in the Gitter
+   programmatic instrumentations that are now in the `ext` directory in the main OpenTelemetry repo. Please ask in the Slack
    channel (see below) for guidance if you want to contribute with these instrumentations.
 
 # Find the right branch
@@ -30,12 +30,15 @@ The default branch for this repo is `main`. Changes that pertain to `metrics` go
 ## Find a Buddy and get Started Quickly!
 
 If you are looking for someone to help you find a starting point and be a resource for your first contribution, join our
-Gitter and find a buddy!
+Slack and find a buddy!
 
-1. Join [Gitter.im](https://gitter.im) and join our [chat room](https://gitter.im/open-telemetry/opentelemetry-python).
+1. Join [Slack](https://slack.cncf.io/) and join our [channel](https://cloud-native.slack.com/archives/C01PD4HUVBL).
 2. Post in the room with an introduction to yourself, what area you are interested in (check issues marked "Help Wanted"),
 and say you are looking for a buddy. We will match you with someone who has experience in that area.
 
+The Slack channel will be used for introductions and an entry point for external people to be triaged and redirected. For
+discussions, please open up an issue or a Github [Discussion](https://github.com/open-telemetry/opentelemetry-python/discussions).
+
 Your OpenTelemetry buddy is your resource to talk to directly on all aspects of contributing to OpenTelemetry: providing
 context, reviewing PRs, and helping those get merged. Buddies will not be available 24/7, but is committed to responding
 during their normal contribution hours.

README.md

@@ -40,6 +40,9 @@
 
 This page describes the Python [OpenTelemetry](https://opentelemetry.io/) implementation. OpenTelemetry is an observability framework for cloud-native software.
 
+## Requirements
+Unless otherwise noted, all published artifacts support Python 3.6 or higher. See CONTRIBUTING.md for additional instructions for building this project for development.
+
 ## Getting started
 
 The goal of OpenTelemetry is to provide a single set of APIs to capture distributed traces and metrics from your application and send them to an observability platform. This project lets you do just that for applications written in Python.
@@ -98,11 +101,15 @@ machine.
 
 1. Install scalene using the following command
 
-`pip install scalene`
+```sh
+pip install scalene
+```
 
 2. Run the `scalene` tests on any of the example Python programs
 
-`scalene opentelemetry-<PACKAGE>/tests/performance/resource-usage/<PATH_TO_TEST>/profile_resource_usage_<NAME_OF_TEST>.py`
+```sh
+scalene opentelemetry-<PACKAGE>/tests/performance/resource-usage/<PATH_TO_TEST>/profile_resource_usage_<NAME_OF_TEST>.py
+```
 
 
 ## Documentation
@@ -124,13 +131,10 @@ Meeting notes are available as a public [Google doc](https://docs.google.com/doc
 Approvers ([@open-telemetry/python-approvers](https://github.com/orgs/open-telemetry/teams/python-approvers)):
 
 - [Aaron Abbott](https://github.com/aabmass), Google
-- [Carlos Alberto Cortez](https://github.com/carlosalberto), Lightstep
-- [Tahir H. Butt](https://github.com/majorgreys) DataDog
-- [Chris Kleinknecht](https://github.com/c24t), Google
 - [Diego Hurtado](https://github.com/ocelotl)
 - [Hector Hernandez](https://github.com/hectorhdzg), Microsoft
 - [Owais Lone](https://github.com/owais), Splunk
-- [Reiley Yang](https://github.com/reyang), Microsoft
+- [Srikanth Chekuri](https://github.com/lonewolf3739)
 - [Yusuke Tsutsumi](https://github.com/toumorokoshi), Google
 
 *For more information about the approver role, see the [community repository](https://github.com/open-telemetry/community/blob/main/community-membership.md#approver).*

dev-requirements.txt

@@ -3,7 +3,7 @@ flake8~=3.7
 isort~=5.6
 black>=19.3b0,==19.*
 httpretty~=1.0
-mypy==0.790
+mypy==0.812
 sphinx~=2.1
 sphinx-rtd-theme~=0.4
 sphinx-autodoc-typehints~=1.10.2

docs/conf.py

@@ -101,17 +101,12 @@
     # Even if wrapt is added to intersphinx_mapping, sphinx keeps failing
     # with "class reference target not found: ObjectProxy".
     ("py:class", "ObjectProxy"),
+    ("py:class", "opentelemetry.trace._LinkBase",),
     # TODO: Understand why sphinx is not able to find this local class
-    ("py:class", "opentelemetry.trace.propagation.textmap.TextMapPropagator",),
-    ("py:class", "opentelemetry.trace.propagation.textmap.DictGetter",),
-    (
-        "any",
-        "opentelemetry.trace.propagation.textmap.TextMapPropagator.extract",
-    ),
-    (
-        "any",
-        "opentelemetry.trace.propagation.textmap.TextMapPropagator.inject",
-    ),
+    ("py:class", "opentelemetry.propagators.textmap.TextMapPropagator",),
+    ("py:class", "opentelemetry.propagators.textmap.DefaultGetter",),
+    ("any", "opentelemetry.propagators.textmap.TextMapPropagator.extract",),
+    ("any", "opentelemetry.propagators.textmap.TextMapPropagator.inject",),
 ]
 
 # Add any paths that contain templates here, relative to this directory.

docs/examples/auto-instrumentation/README.rst

@@ -37,8 +37,7 @@ Manually instrumented server
     def server_request():
         with tracer.start_as_current_span(
             "server_request",
-            context=propagators.extract(DictGetter(), request.headers
-            ),
+            context=propagators.extract(request.headers),
         ):
             print(request.args.get("param"))
             return "served"
@@ -151,7 +150,7 @@ and run the following command instead:
 
 .. code:: sh
 
-    $ opentelemetry-instrument -e console_span,console_metrics python server_uninstrumented.py
+    $ opentelemetry-instrument --trace-exporter console_span --metrics-exporter console_metrics python server_uninstrumented.py
 
 In the console where you previously executed ``client.py``, run the following
 command again: