Release v0.8.0

[MrAlias]

Release v0.8.0

Added

• The B3Encoding type to represent the B3 encoding(s) the B3 propagator can inject.
  A value for HTTP supported encodings (Multiple Header: MultipleHeader, Single Header: SingleHeader) are included. (Fix B3 propagator and add tests #882)
• The FlagsDeferred trace flag to indicate if the trace sampling decision has been deferred. (Fix B3 propagator and add tests #882)
• The FlagsDebug trace flag to indicate if the trace is a debug trace. (Fix B3 propagator and add tests #882)
• Add peer.service semantic attribute. (Add "peer.service" semantic to standard attributes #898)
• Add database-specific semantic attributes. (Add more database-specific semantic attributes #899)
• Add semantic convention for faas.coldstart and container.id. (Add semantic convention for faas.coldstart and container.id #909)
• Add http content size semantic conventions. (Add http content size semantic conventions #905)
• Include http.request_content_length in HTTP request basic attributes. (Add http content size semantic conventions #905)
• Add semantic conventions for operating system process resource attribute keys. (Add semantic conventions for OS process as resource attributes #919)
• The Jaeger exporter now has a WithBatchMaxCount option to specify the maximum number of spans sent in a batch. ([jaeger] Added WithBatchMaxCount as an option #931)

Changed

• Update CONTRIBUTING.md to ask for updates to CHANGELOG.md with each pull request. (Ask for changelog updates with PRs #879)
• Use lowercase header names for B3 Multiple Headers. (Update B3 header names #881)
• The B3 propagator SingleHeader field has been replaced with InjectEncoding.
  This new field can be set to combinations of the B3Encoding bitmasks and will inject trace information in these encodings.
  If no encoding is set, the propagator will default to MultipleHeader encoding. (Fix B3 propagator and add tests #882)
• The B3 propagator now extracts from either HTTP encoding of B3 (Single Header or Multiple Header) based on what is contained in the header.
  Preference is given to Single Header encoding with Multiple Header being the fallback if Single Header is not found or is invalid.
  This behavior change is made to dynamically support all correctly encoded traces received instead of having to guess the expected encoding prior to receiving. (Fix B3 propagator and add tests #882)
• Extend semantic conventions for RPC. (Extend semantic convetions for RPC #900)
• To match constant naming conventions in the api/standard package, the FaaS* key names are appended with a suffix of Key. (Fix api/standard constant names and documentation #920)
  • "api/standard".FaaSName -> FaaSNameKey
  • "api/standard".FaaSID -> FaaSIDKey
  • "api/standard".FaaSVersion -> FaaSVersionKey
  • "api/standard".FaaSInstance -> FaaSInstanceKey

Removed

• The FlagsUnused trace flag is removed.
  The purpose of this flag was to act as the inverse of FlagsSampled, the inverse of FlagsSampled is used instead. (Fix B3 propagator and add tests #882)
• The B3 header constants (B3SingleHeader, B3DebugFlagHeader, B3TraceIDHeader, B3SpanIDHeader, B3SampledHeader, B3ParentSpanIDHeader) are removed.
  If B3 header keys are needed the authoritative OpenZipkin package constants should be used instead. (Fix B3 propagator and add tests #882)

Fixed

• The B3 Single Header name is now correctly b3 instead of the previous X-B3. (Update B3 header names #881)
• The B3 propagator now correctly supports sampling only values (b3: 0, b3: 1, or b3: d) for a Single B3 Header. (Fix B3 propagator and add tests #882)
• The B3 propagator now propagates the debug flag.
  This removes the behavior of changing the debug flag into a set sampling bit.
  Instead, this now follow the B3 specification and omits the X-B3-Sampling header. (Fix B3 propagator and add tests #882)
• The B3 propagator now tracks "unset" sampling state (meaning "defer the decision") and does not set the X-B3-Sampling header when injecting. (Fix B3 propagator and add tests #882)
• Bump github.com/itchyny/gojq from 0.10.3 to 0.10.4 in /tools. (Bump github.com/itchyny/gojq from 0.10.3 to 0.10.4 in /tools #883)
• Bump github.com/opentracing/opentracing-go from v1.1.1-0.20190913142402-a7454ce5950e to v1.2.0. (Update opentracing dependency #885)
• The tracing time conversion for OTLP spans is now correctly set to UnixNano. (fix trace event time conversion from internal to otlp #896)
• Ensure span status is not set to Unknown when no HTTP status code is provided as it is assumed to be 200 OK. (Avoid setting span status to Unknown when no HTTP status is provided;… #908)
• Ensure httptrace.clientTracer closes http.headers span. (Ensure clientTracer closes http.headers span #912)
• Prometheus exporter will not apply stale updates or forget inactive metrics. (Fix incorrect aggregation; Prometheus exporter behavior #903)
• Add test for api.standard HTTPClientAttributesFromHTTPRequest. (Add http content size semantic conventions #905)
• Bump github.com/golangci/golangci-lint from 1.27.0 to 1.28.1 in /tools. (Bump github.com/golangci/golangci-lint from 1.27.0 to 1.28.0 in /tools #901, Bump github.com/golangci/golangci-lint from 1.28.0 to 1.28.1 in /tools #913)
• Update otel-colector example to use the v0.5.0 collector. (Update otel-collector example to use collector v0.5.0 #915)
• The grpctrace instrumentation uses a span name conforming to the OpenTelemetry semantic conventions (does not contain a leading slash (/)). (Update grpctrace instrumentation span names #922)
• The grpctrace instrumentation includes an rpc.method attribute now set to the gRPC method name. (Extend semantic convetions for RPC #900, Update grpctrace instrumentation span names #922)
• The grpctrace instrumentation rpc.service attribute now contains the package name if one exists.
  This is in accordance with OpenTelemetry semantic conventions. (Update grpctrace instrumentation span names #922)
• Correlation Context extractor will no longer insert an empty map into the returned context when no valid values are extracted. (Do not replace correlation context when extracting invalid data #923)
• Bump google.golang.org/api from 0.28.0 to 0.29.0 in /exporters/trace/jaeger. (Bump google.golang.org/api from 0.28.0 to 0.29.0 in /exporters/trace/jaeger #925)
• Bump github.com/itchyny/gojq from 0.10.4 to 0.11.0 in /tools. (Bump github.com/itchyny/gojq from 0.10.4 to 0.11.0 in /tools #926)
• Bump github.com/golangci/golangci-lint from 1.28.1 to 1.28.2 in /tools. (Bump github.com/golangci/golangci-lint from 1.28.1 to 1.28.2 in /tools #930)

[lizthegrey]

Whoops, I merged #931 and #930 without changing the changelog

[lizthegrey]

oh, I should have caught the date was off by one, but whatever, it's fiiine :)