Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

update release notes for 3.2.2 #120

Merged
merged 2 commits into from Sep 23, 2021
Merged

update release notes for 3.2.2 #120

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
1a43f4a
update release notes for 3.2.2
avsej Sep 22, 2021
ed6efd1
Gardening
osfameron Sep 23, 2021
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Jump to
Jump to file
Failed to load files.
Diff view
Diff view
4 changes: 2 additions & 2 deletions antora.yml
View file
Open in desktop
Expand Up @@ -10,6 +10,6 @@ asciidoc:
name-sdk: C SDK
cb_server_version: '7.0'
lcb_current_version: '3.2'
lcb_api_link: https://docs.couchbase.com/sdk-api/couchbase-c-client-3.2.1
lcb_src_link: https://github.com/couchbase/libcouchbase/blob/3.2.1
lcb_api_link: https://docs.couchbase.com/sdk-api/couchbase-c-client-3.2.2
lcb_src_link: https://github.com/couchbase/libcouchbase/blob/3.2.2
lcb_doc_src_link: https://github.com/couchbase/docs-sdk-c/blob/release/3.2
62 changes: 57 additions & 5 deletions modules/project-docs/pages/sdk-release-notes.adoc
View file
Open in desktop
Expand Up @@ -15,6 +15,58 @@ include::hello-world:partial$installation.adoc[]


[#latest-release]
== Version 3.2.2 (23 September 2021)

Version 3.2.2 is the third release of the 3.2 series.

https://docs.couchbase.com/sdk-api/couchbase-c-client-3.2.2/index.html[API Reference]

* https://issues.couchbase.com/browse/CCBC-1485[CCBC-1485]: Allow disabling tracer for connected instance.

* https://issues.couchbase.com/browse/CCBC-1472[CCBC-1472]: Fix handling in case of invalid responses by ensuring strict JSON parsing mode for query meta.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks Hakim - note we normally change these into the perfect tense to indicate what has been done (often after an imperfect tense description of what the problem was before the fix).
Can be followed by a "now x should y correctly" sentence :)
#giardinaggio


* https://issues.couchbase.com/browse/CCBC-1494[CCBC-1494]: Disconnect logger after `lcb_destroy` invoked to avoid double free errors for some IO backends.

* https://issues.couchbase.com/browse/CCBC-1457[CCBC-1457]: Improve error message when server enforces TLS encryption

* https://issues.couchbase.com/browse/CCBC-1489[CCBC-1489]: Fixed get_and_touch to use the correct expiry.

* https://issues.couchbase.com/browse/CCBC-1487[CCBC-1487]: Fixed issue with completion IO where `retryq` erased already sent packets.

* https://issues.couchbase.com/browse/CCBC-1488[CCBC-1488]: Fixed incorrect refcounting in `Connstart`, where an error state followed by cancellation caused an error.

* https://issues.couchbase.com/browse/CCBC-1479[CCBC-1479]: Initialize fields of custom tracer struct, fixing issues during destruction.

* https://issues.couchbase.com/browse/CCBC-1478[CCBC-1478]: Fix issue where successful query returning no results triggered retry when run readonly, resulting in a timeout error.

* https://issues.couchbase.com/browse/CCBC-1216[CCBC-1216]: Implement user impersonation API, for use-cases where SDK performs work on behalf of an application.

* Improved test coverage and stability.

=== Downloads

[cols="12,^8,23"]
|===
| Platform | Architecture | File
| Checksums | Any | https://packages.couchbase.com/clients/c/libcouchbase-3.2.2.sha256sum[libcouchbase-3.2.2.sha256sum]
| Source Archive | Any | https://packages.couchbase.com/clients/c/libcouchbase-3.2.2.tar.gz[libcouchbase-3.2.2.tar.gz]
| Amazon Linux 2 | x64 | https://packages.couchbase.com/clients/c/libcouchbase-3.2.2_amzn2_x86_64.tar[libcouchbase-3.2.2_amzn2_x86_64.tar]
| Enterprise Linux 7 | x64 | https://packages.couchbase.com/clients/c/libcouchbase-3.2.2_centos7_x86_64.tar[libcouchbase-3.2.2_centos7_x86_64.tar]
| Enterprise Linux 8 | x64 | https://packages.couchbase.com/clients/c/libcouchbase-3.2.2_centos8_x86_64.tar[libcouchbase-3.2.2_centos8_x86_64.tar]
| Ubuntu 16.04 (xenial) | x64 | https://packages.couchbase.com/clients/c/libcouchbase-3.2.2_ubuntu1604_xenial_amd64.tar[libcouchbase-3.2.2_ubuntu1604_xenial_amd64.tar]
| Ubuntu 18.04 (bionic) | x64 | https://packages.couchbase.com/clients/c/libcouchbase-3.2.2_ubuntu1804_bionic_amd64.tar[libcouchbase-3.2.2_ubuntu1804_bionic_amd64.tar]
| Ubuntu 20.04 (focal) | x64 | https://packages.couchbase.com/clients/c/libcouchbase-3.2.2_ubuntu2004_focal_amd64.tar[libcouchbase-3.2.2_ubuntu2004_focal_amd64.tar]
| Debian 9 (stretch) | x64 | https://packages.couchbase.com/clients/c/libcouchbase-3.2.2_debian9_stretch_amd64.tar[libcouchbase-3.2.2_debian9_stretch_amd64.tar]
| Debian 10 (buster) | x64 | https://packages.couchbase.com/clients/c/libcouchbase-3.2.2_debian10_buster_amd64.tar[libcouchbase-3.2.2_debian10_buster_amd64.tar]
| Debian 11 (bullseye) | x64 | https://packages.couchbase.com/clients/c/libcouchbase-3.2.2_debian11_bullseye_amd64.tar[libcouchbase-3.2.2_debian11_bullseye_amd64.tar]
| Visual Studio 2015 (VC14) | x64 | https://packages.couchbase.com/clients/c/libcouchbase-3.2.2_vc14_amd64.zip[libcouchbase-3.2.2_vc14_amd64.zip]
| Visual Studio 2017 (VC15) | x64 | https://packages.couchbase.com/clients/c/libcouchbase-3.2.2_vc15_amd64.zip[libcouchbase-3.2.2_vc15_amd64.zip]
| Visual Studio 2019 (VC16) | x64 | https://packages.couchbase.com/clients/c/libcouchbase-3.2.2_vc16_amd64.zip[libcouchbase-3.2.2_vc16_amd64.zip]
| Visual Studio 2015 TLS (VC14) | x64 | https://packages.couchbase.com/clients/c/libcouchbase-3.2.2_vc14_amd64_openssl.zip[libcouchbase-3.2.2_vc14_amd64_openssl.zip]
| Visual Studio 2017 TLS (VC15) | x64 | https://packages.couchbase.com/clients/c/libcouchbase-3.2.2_vc15_amd64_openssl.zip[libcouchbase-3.2.2_vc15_amd64_openssl.zip]
| Visual Studio 2019 TLS (VC16) | x64 | https://packages.couchbase.com/clients/c/libcouchbase-3.2.2_vc16_amd64_openssl.zip[libcouchbase-3.2.2_vc16_amd64_openssl.zip]
|===

== Version 3.2.1 (20 August 2021)

Version 3.2.1 is the second release of the 3.2 series.
Expand Down Expand Up @@ -87,12 +139,12 @@ https://docs.couchbase.com/sdk-api/couchbase-c-client-3.2.0/index.html[API Refer
* https://issues.couchbase.com/browse/CCBC-1280[CBCC-1280]:
Support for OpenTelemetry tracing.
+
Tracing updated to allow for an external tracer that creates and finishes spans, adds tags, destroys spans.
Also, spans now have the notion of being the 'outer' span.
That is the span that has all the outer span tags,
Tracing updated to allow for an external tracer that creates and finishes spans, adds tags, destroys spans.
Also, spans now have the notion of being the 'outer' span.
That is the span that has all the outer span tags,
and is the one whose duration is used to determine whether or not the operation has exceeded the threshold if the `ThresholdLoggingTracer` is used.
+
If you pass in a parent that is an outer span, you must call `lcbtrace_span_finish` yourself.
If you pass in a parent that is an outer span, you must call `lcbtrace_span_finish` yourself.
When an operation begins, if there is no parent span passed in, or if there is but it isn't an 'outer' span, then the operation creates the outer span itself.
+
See `/examples/tracing/otel_tracing.cc` for an example.
Expand All @@ -102,7 +154,7 @@ See `/examples/tracing/otel_tracing.cc` for an example.
+
When enabled, by default will output a histogram of latencies for various kv operations plus Query, Search, Analytics, and View queries.
+
If desired, an external metrics collector can be passed in when the instance is created, which will then be called with latencies for each operation.
If desired, an external metrics collector can be passed in when the instance is created, which will then be called with latencies for each operation.
This can be used to call into an `opentelemetry` meter for aggregation and export.
+
See `/examples/metrics/otel_metrics.cc` for an example.
Expand Down