userver: Roadmap and Changelog
Loading...
Searching...
No Matches
Roadmap and Changelog

We keep an eye on all the issues and feature requests at the github.com/userver-framework, at the English-speaking and Russian-speaking Telegram support chats. All the good ideas are discussed, big and important ones go to the Roadmap. We also have our in-house feature requests, those could be also found in Roadmap.

Important or interesting features go to the changelog as they get implemented. Note that there's also a Security Changelog.

Changelog news also go to the userver framework news channel.

Roadmap

Changelog

Release v3.2

Cool features:

Breaking Change:

  • Added server::request::RequestContext as a mandatory third Handler attribute in chaotic-openapi. Many thanks to Lemit for the PR!
    • Migration: Update all handlers to include RequestContext as the third argument when calling the Handler template. The sample service in samples/chaotic_openapi_service provides a reference implementation showing the correct usage.
  • Renamed CloseAndWaitDebug to concurrent::BackgroundTaskStorage::WaitAndDisposeSlow to mark that the method is ready for production, but creating a simple container like std::vector<Task> in handlers is much more performant than creating and destroying an instance of BackgroundTaskStorage in a handler.
    • Migration: Update your code to use the new method name WaitAndDisposeSlow instead of CloseAndWaitDebug. The method signature and behavior remain unchanged.
  • Removed the GetThreadCount() API from UTEST macros and tests. Use engine::current_task::GetWorkerCount() instead.
  • Removed legacy dynamic_config::Snapshot::Get method, use operator[] instead.
    • Migration: Replace all calls to dynamic_config::Snapshot::Get with operator[].
  • engine::SingleConsumerEvent::WaitUntil now returns engine::FutureStatus instead of bool, allowing to distinguish failure reason precisely.
    • Migration: Update code that calls SingleConsumerEvent::WaitUntil to check the return value. The method now returns engine::FutureStatus which can be kReady, kCancelled, or kTimeout.
  • Monotonic counter metrics in postgresql, mysql, clickhouse, kafka, rabbitmq, redis, core dist_lock, congestion_control and the websocket handler are now reported as RATE instead of GAUGE (see Statistics and Metrics); a few metrics keep their legacy GAUGE value and additionally report a new .v2 RATE metric until dashboards/alerts are migrated.
    • Migration: If your dashboards or alerts rely on the legacy GAUGE values, update them to use the new .v2 RATE metrics or adjust the query logic accordingly.
  • New storages::postgres::DistLockComponentBase constructor that enables automatic distlock startup and shutdown.
    • Migration: Remove AutostartDistlock() and StopDistlock() calls from derived class constructors. If manual control is still needed, pass DisableAutostartAtBase{} to the DistLockComponentBase constructor.
  • Dropped support for libpq versions prior to 14.0.
  • Removed legacy monitor_client.get_metric and monitor_client.get_metrics methods from testsuite.
  • Changed ydb::TopicProducer Write behavior from potentially blocking to immediately failing when the buffer is overloaded.
    • Migration: Update your code to handle EWriteStatus::Timeout when writing to YDB TopicProducer. Ensure proper error handling for timeout conditions in your application logic. Do not retry this error: buffering data beyond the configured limit while the producer is overloaded will lead to OOM.

Features:

  • chaotic
    • Added HTTP digest authentication to chaotic clients and handlers (see Chaotic handlers (server side) and Chaotic clients).
    • Added support for response headers in HTTP handlers generated by userver::chaotic::openapi.
    • Fixed compilation error when using oneOf with discriminator and x-usrv-cpp-indirect: true on variant references in userver::chaotic. Many thanks to Tnirpps for the PR!
  • core & universal
  • dist_lock
  • grpc
  • http2
    • Added support for handling HTTP/2 GOAWAY frames, including proper handling of follow-up PING frames after a client sends a GOAWAY frame.
    • Added validation of client HTTP/2 stream IDs to prevent protocol violations. If a client sends a stream with an ID less than or equal to the highest used ID, the server responds with a GOAWAY frame.
    • Added validation to ensure HTTP/2 request URLs are fully parsed before sending headers. This prevents sending incomplete or malformed requests when headers are shuffled.
  • kafka
    • Fixed a Use-After-Free in Kafka Producer API during task cancellation. Many thanks to Dmitry Isaikin for the PR!
  • mongo
    • Added storages::mongo::operations::Bulk write path for MongoDB storage driver, allowing a single bulk write instead of multiple ones.
    • Added database-level storages::mongo::Pool::Aggregate API for MongoDB (e.g. pipelines starting with $documents).
    • Added autostart configuration option for storages::mongo::DistLockComponentBase distributed locks.
    • Preserved max replication lag setting for MongoDB read operations.
    • Added storages::mongo::options::MaxServerTime for update, delete, insert, and ReplaceOne operations (see MongoDB).
    • Added runtime query override support in cache::BaseMongoCache MongoDB caches.
    • Added MongoDB operator constants and replaced raw literals with constant references for improved code clarity and consistency.
    • Added aggregation pipeline support to storages::mongo::Collection::UpdateOne and UpdateMany in MongoDB storages.
    • Split acquire and prolong operations in mongo::DistLockStrategy, adding a new mongo::DistLockStrategy::Prolong method.
    • Avoided deprecated bson_append_array_begin in libbson 2.3.0+ by using bson_append_array_unsafe_begin instead. Many thanks to Georgij Tsarin for the PR!
  • ODBC
    • scripts/docs/en/userver/odbc.md: pass query parameters separately from SQL text, configure operation timeouts via command control, reload DSNs through secdist, and rely on documented schemas and metrics. Many thanks to Andrey Balabekyan for the PR!
  • PostgreSQL
    • Enabled connection rate limiting for PostgreSQL by default.
    • PostgreSQL now always pipelines when possible, reducing round-trips.
    • Added accounting for topology connections in PostgreSQL connection limit calculation (see uPg: Automatic connection limit).
    • Enabled connection pipeline mode unconditionally for PostgreSQL connections.
    • Updated PostgreSQL connection settings: enabled pg-connecting-rate-limit for all services and increased recent_errors_threshold default to 30.
    • Fixed POSTGRES_CONNECTION_POOL_SETTINGS resetting static connecting_limit and connecting_interval_ms when those fields are omitted from the dynamic config.
    • Removed experimental dynamic config POSTGRES_DEADLINE_PROPAGATION_VERSION. Use USERVER_DEADLINE_PROPAGATION_ENABLED instead.
    • Startup logic changed for POSTGRES_CONNLIMIT_MODE_AUTO_ENABLED to improve start times on services with multiple instances.
  • prometheus
    • Fixed escaping of backslash and newline characters in Prometheus label values. Many thanks to netliomax25-code for the PR!
  • protobuf
  • redis
    • Fixed Redis command timeout handling: command callbacks are now released on timeout, preventing stale topology update contexts and ensuring proper failover detection.
    • Fixed dynamic Redis linkage issue.
    • Added storages::redis::Client::Getdel, which atomically gets a key value and deletes the key.
    • Added Redis health check configuration options via storages::redis::HealthCheckParams: required, max_failed_shards, and max_disconnect_time.
    • Guarded against empty array replies in the Redis OnPsubscribeReply handler to prevent out-of-bounds access. Many thanks to netliomax25-code for the PR!
    • Added a check to ensure the Redis GEORADIUS/GEOSEARCH reply member is a string before attempting to read it. Many thanks to netliomax25-code for the PR!
    • Switched to utils::FromString<double> for parsing floating-point Redis reply values to avoid locale-dependent issues and reject trailing junk. Many thanks to netliomax25-code for the PR!
    • Removed experimental dynamic config REDIS_DEADLINE_PROPAGATION_VERSION. Use USERVER_DEADLINE_PROPAGATION_ENABLED instead.
    • Added storages::redis::Client::Msetex for atomic multi-set with TTL.
  • rocks
    • Added storages::rocks::Client RocksDB backend with storages::rocks::Map support, transactions, snapshots, and streaming cursors.
    • Added storages::rocks::Client::CreateSnapshot for RocksDB checkpoints and point-in-time recovery. Many thanks to Kirill for the PR!
  • s3api
    • Added s3api::SignatureV4 support (see S3 API).
  • testing
  • websocket
    • Applied control frame length limit to ping and pong frames. Many thanks to netliomax25-code for the PR!
    • Fixed WebSocket handling via engine::io::PrefixedRw for bytes buffered by libcurl after the HTTP upgrade.
  • YDB

Optimizations:

  • Optimized HTTP response body handling by allowing direct use of std::shared_ptr<const std::string> in server::http::HttpResponse instead of copying data, improving performance by up to 32% RPS.
  • Skip log message construction when logging is disabled in gRPC. Up to x2239 speedup in gRPC usage
  • Optimized logging to use bulk writes via struct iovec arrays, achieving up to ~10× sink throughput improvement compared to single-message writes. ~2% improved CPU efficiency for the whole container
  • Optimized HTTP request handling and streaming by improving response header and body management, leading to better performance (e.g., increased RPS from 111382 to 120256).
  • Reduced ResponseBase size from 160 bytes to 128 bytes by removing atomic operations and StripedCounter operations on hot path of request. Up to 5% improved RPS for small handlers.
  • Added minimal-server-middleware-pipeline-builder with only exceptions handling, improved handler logging efficiency by moving logging to lambda, and tuned benchmark service resulting in up to 64.9% performance improvement on pipelined benchmarks.
  • Optimized concurrent::LazyValue with engine::MultiConsumerEvent internally.
  • Lowered ALPN log level to debug as it's called frequently (every handshake). Many thanks to SSE4 for the PR!
  • Optimized PostgreSQL distlock prolongation via storages::postgres::DistLockStrategy::Prolong, reducing database round trips.
  • Reused string buffer in ProtoMessageVisitor to reduce allocations and improve performance.
  • Refactored Redis parsing to avoid copying GeoPoint additional information. Many thanks to Mikhail Sychev for the PR!
  • task-processor-queue: work-stealing-task-queue was optimized. Latency is now 15-20% smaller and TaskProcessor::ProcessTasks is 3% smaller on flamegraphs.
  • Removed the POSTGRES_OMIT_DESCRIBE_IN_EXECUTE experiment and turned it on. PostgreSQL now always avoids sending excessive D(escribe) messages. This gives +1% mean RPS, ~+2% best RPS for samples/benchmark_service/bench.sh async-db DATABASE_MAX_CONN=64 and saves ut to 50% of network bandwidth.
  • Parse typed JSON in a single RapidJSON SAX pass. 8%-18% speedup in JSON SAX parsing
  • formats::bson::ValueBuilder now avoids allocation for existing keys.
  • Optimized DOM maps parsing by caching the end() iterator. Gives a 30%-46% speedup.

Build:

  • Fixed typo in service_template config. Many thanks to Desfirit for the PR!
  • Added support for building without Boost in the ubuntu-minimal CI workflow. Many thanks to Vasiliy Kulikov for the PR!
  • Added typing-extensions >= 4.4.0 requirement to the testsuite. Many thanks to Georgij Tsarin for the PR!
  • Added missing build dependencies for Debian 13 (trixie) to fix a build issue with the boost_context component. Many thanks to Anton Artyushin for the PR!
  • Marked fmt::formatter<>::parse as constexpr in protobuf code and adjusted test exclusion list. Many thanks to oigolovanova for the PR!
  • Made fmt::formatter::parse() methods constexpr to fix compile errors with new fmt library versions. Many thanks to Ivan Skriabin for the PR!
  • Added optional support for using uv instead of venv + pip to create Python virtual environments, speeding up the CMake Configure step.

Documentation:

  • Documentation was ported to Doxygen 1.17. jQuery and a bunch of other helper libraries were removed, images are now SVG by default.
  • Testsuite docs for fixtures are now embedded into the userver docs leading to a more generic and useful documentation.
  • Clarified the license attribution for the Decimal64 library in the third-party documentation. Many thanks to Georgij Tsarin for the PR!
  • Fixed Doxygen documentation in multiple components and handlers. Many thanks to Ivan Skriabin for the PR!
  • Added benchmarking sample service using HttpArena for performance testing. Added script for quick benchmarking and flame graph building.
  • Fixed a typo in "implementation". Many thanks to Vaibhav Srivastava for the PR!

Release v3.1

Breaking Change:

  • Renamed testsuite::RegisterCacheScoped to testsuite::RegisterCacheScope.
    • Migration: Replace RegisterCacheScoped with RegisterCacheScope.
  • Removed concurrent::AsyncEventSubscriberScope::Scoped.
    • Migration: Store the subscriber scope as a class member and call Unsubscribe in the destructor.
  • Changed X-Request-Deadline header format from ISO timestamp to Unix epoch microseconds.
    • Migration: Update clients to send deadlines as uint64_t microseconds since Unix epoch instead of ISO strings.
  • Renamed engine::AsyncNoSpan to engine::AsyncNoTracing.
    • Migration: Update all references from AsyncNoSpan to AsyncNoTracing.
  • Removed obscure overloads of engine::Async and utils::Async variants.
    • Migration: Use utils::TaskBuilder for complex task settings instead of the removed overloads.
  • Changed ugrpc::tests::Service constructor signature.
    • Migration: Pass server config, middlewares, and client settings through ugrpc::tests::ServiceConfigs instead of direct constructor parameters.
  • Replaced utils::void_t with C++20 requires constraints in PostgreSQL type traits.
    • Migration: Update custom type trait specializations to use requires clauses instead of std::enable_if conditions.
  • Raised minimum GCC version from 11.1 to 11.2 and minimum Clang version from 14 to 16 to enable C++20 heterogeneous lookup in hash containers.
    • Migration: Update your GCC compiler to version 11.2 or newer and Clang to version 16 or newer.
  • Changed YDB topic API: GetNativeTopicReadSession/GetNativeTopicWriteSession now return references instead of std::shared_ptr.
    • Migration: Remove dereference operator (*) or -> when calling methods on the returned native session objects.
  • Added a second stage to graceful shutdown for server http and ugrpc: after failing health checks, listeners are now closed to stop accepting new connections while allowing in-flight requests to complete.
    • Migration: replace deprecated graceful_shutdown_interval with graceful_shutdown_continue_accepting_requests_interval and graceful_shutdown_pending_requests_completion_interval; the old option is currently only a fallback and will be removed in the future.
  • Refactored meta utilities: replaced meta::DetectedType and meta::DetectedOr with C++20 template constraints and type aliases; replaced meta::IsVector with meta::IsVectorLike and removed meta::IsIterator (use std::input_or_output_iterator instead); removed transitive <vector> include from userver/utils/meta.hpp. These changes improve compile times and reduce header dependencies.
    • Migration: Replace meta::DetectedType with plain type aliases and C++20 requires constraints; replace meta::DetectedOr with template specialization using std::type_identity; replace meta::IsVector with meta::IsVectorLike; replace meta::IsIterator with std::input_or_output_iterator; add #include <vector> if you were relying on the transitive include from userver/utils/meta.hpp.
  • Switched from date library to C++20 std::chrono for date/time operations, reducing preprocessed file size by ~641KB and include count by 162 for userver/utils/datetime/cpp_20_calendar.hpp.
    • Migration: Replace date::make_time with std::chrono::hh_mm_ss; replace date:: with std::chrono::; replace using namespace utils::datetime::date::literals and using namespace date::literals with using namespace std::literals::chrono_literals;; if your standard library does not support std::chrono::parse, use utils::datetime::UtcStringtime from userver; if your standard library does not support std::chrono::format, use utils::datetime::UtcTimestring from userver.
  • Changed ugrpc::server::ContextBase::GetServerContext return type from grpc::ServerContext& to grpc::ServerContextBase& to allow future internal implementation changes (e.g., using grpc++ Callback API).
    • Migration: Update any code that stores the return value of GetServerContext() or passes it to functions to use grpc::ServerContextBase& instead of grpc::ServerContext&.

Features:

  • chaotic OpenAPI generator:
    • (experimental) Added comprehensive OpenAPI code generation for server-side HTTP handlers and corresponding config.yaml. Support with multiple content types, request body parsing, logging customization, and URL masking for sensitive parameters
  • odbc
    • Improved ODBC driver support including connection pooling, transactions, deadlines, and component configuration. Many thanks to Andrey Balabekyan for the PR!
  • ScyllaDB
    • Added ScyllaDB driver: asynchronous C++ driver for ScyllaDB and Apache Cassandra with full CQL support, typed operations, and lightweight transactions. Many thanks to Uzhanin Egor for the PR!
  • chaotic
    • Improved support for allOf schemas with additionalProperties in chaotic serialization
    • Added support for JSON Schema const keyword in chaotic code generation
    • Added support for any type in chaotic schema generator, allowing arbitrary JSON values without type constraints.
    • Added JSON stream writer generation for chaotic schemas, improving serialization performance
    • Added support for uniqueItems validation in chaotic array schemas for integer, string, and boolean types
    • Added support for emoji characters in enum and field names by escaping them as Unicode code points. Many thanks to Halfdarkangel for the PR!
  • universal
    • Added utils::SlotMap - a minimalistic slot-map container with stable indexes and O(1) operations
  • engine
  • grpc
    • Added validation for proto2 required fields before sending responses, providing better error messages
    • Added absolute timepoint propagation support for gRPC client-side deadline propagation
    • gRPC server now processes calls in subtasks, enabling Congestion Control to properly handle service overload
    • Added graceful shutdown headers to trailing metadata for streaming calls when shutdown starts after initial metadata has been sent
    • grpc.Mockserver now properly manages mock lifecycle with scope-based ownership, enabling nested and overlapping mock scopes for complex testing scenarios
  • protobuf
    • Added CMake support for protobuf libraries and exposed ProtoJSON conversion utilities
  • kafka
    • Kafka consumer now automatically recreates itself after fatal librdkafka errors (configurable via restart_after_failure_delay)
  • logging
    • tracing::Span::SetLocalLogLevel now overrides the global log level in both directions - can raise the threshold (suppress logs) or lower it (enable debug logs even if the global level is higher)
  • mongo
    • Added OperationError getter to mongo::WriteResult for better error handling with SuppressServerExceptions option
  • PostgreSQL
    • Added connecting_interval_ms option to components::Postgres connection pool for throttling connection attempts
    • Added PostgreSQL support for std::span types as array formatters
    • Added DTO codegen to userver_add_sql_library: passing the DTO_DIALECT postgresql argument now generates a typed C++ client from your migrations and queries. You get structs / enum classes, an abstract PgClient interface, a ClusterPgClient running over a storages::postgres::Cluster, and a gmock-based MockPgClient for unit tests. Added the samples/postgres_dto_service example service demonstrating the generated client end to end. See Embedding SQL/YQL files via userver_add_sql_library for more info.
    • Added the userver::postgresql-utest testing library for writing UTEST-based PostgreSQL tests against a real database.
  • redis
    • Added support for Redis hash field expiration commands (HEXPIRE, HPEXPIRE, ...)
    • Added SetAndGetPrevious method to Redis client and transaction interfaces for atomic set-with-TTL operations that return the previous value
    • Added support for suppressing per-channel Redis Pub/Sub metrics to reduce metrics volume when using many channels
    • Added Redis JSON module support with json.set, json.get, json.mset, and json.mget commands
    • Added Redis CLUSTER SHARDS topology discovery support, including failed hosts in shard metadata to better distinguish connection issues from cluster-reported node failures.
    • Added support for Redis ACL authentication (Redis 6+) with username/password credentials
    • Added support for multiple channels in Redis subscribe commands (Subscribe, Psubscribe, Ssubscribe)
    • Added support for parsing all Redis command control configuration fields including account_in_statistics, force_shard_idx, chunk_size, force_retries_to_master_on_nil_reply, and retry_counter
  • crypto
    • Added PublicKey::LoadFromPrivateKey method to derive public keys from private keys. Many thanks to Georgij Tsarin for the PR!
  • http2
    • Added full HTTP/2 over TLS support with ALPN negotiation. Many thanks to SSE4 for the PR!
    • Added concurrent HTTP/2.0 stream execution
  • cookie
    • Added validation Path/Domain/SameSite to block header injection. Many thanks to netliomax25-code for the PR!
  • OpenTelemetry
    • Added support for OpenTelemetry trace sampling flags. When otel-trace-sampling-enabled is true, spans will respect the W3C trace-context sampled flag (unsampled spans are not written to tracing systems). Added Span::IsSampled() and Span::SetSampled() methods for manual control.
  • ydb
    • Added a static configuration option to defer Query API session creation after a get-session timeout
    • Added support for YDB tuple type serialization with std::tuple support
    • Added ydb::TopicWriteSession support to YDB client for coroutine-friendly topic writing. Many thanks to Vasily Sviridov for the PR!
    • Added deadline support for YDB topic producer flush operations
    • Added ydb::TopicProducer wrapper for YDB topic message publishing
    • Added TCP and gRPC keepalive configuration options to YDB driver
    • Added YDB database routing via dynamic config for blue-green deployments and live migrations
    • Added ydb::TopicWriter and ydb::TopicWriterComponent that implement writing data to YDB topics with round-robin balancing between topic partitions. Many thanks to Leonid Lazarev for the PR!
    • Added cmake target userver::ydb-utest with gtest mocks for ydb::TopicWriter. Many thanks to Leonid Lazarev for the PR!

Optimizations:

  • Reduced binary size across universal and related libraries by moving some definitions out of headers, reducing template/codegen bloat, and tuning debug-info generation, saving approximately 0.3–1% in tested binaries.
  • Optimized gRPC server to parse and serialize messages from raw grpc::ByteBuffer, allowing congestion control to reject calls before parsing unary request payloads.
  • Optimized various utility functions to use string views instead of strings, reducing unnecessary string copies.
  • Improved compilation times for utils::TaskBuilder by reducing unnecessary lambda-call code generation and template instantiation overhead, without changing the public API.
  • Optimized chaotic generated headers by reducing heavy transitive includes, improving compilation time for small dynamic-config users by up to ~5% and reducing preprocessed file size.
  • Performed mass code cleanup for C++20, using concepts, ranges, comparisons and other features. This slightly improved build times and made the code more readable.
  • Shaved ~15 ns off each coroutine sleep operation by removing a cmpxchg16b in WaitListLight::Remove on hot path and removing extra intrusive_ptr increments in TaskContext::Schedule and Wakeup
  • Optimized SingleConsumerEvent::WaitForEventUntil by ~20 ns by removing extra attempts at resetting the signal
  • Shaved another ~3 ns (without LTO) or ~4-5 ns (with LTO) off each coroutine sleep operation by removing diagnostic checks from hot paths in Sleep
  • Shaved about 10 ns off each coroutine sleep operation by removing 2 extra locked operations
  • PostgreSQL: Connection rate limiting now only activates when there are recent connection errors, improving connection pool performance under normal conditions

Fixes:

  • chaotic
    • Fixed chrono milliseconds conversion in chaotic. Many thanks to Fedor Shatokhin for the PR!
    • Fixed chaotic bash wrapper to respect the CMake libdir path variable. Many thanks to Halfdarkangel for the PR!
  • crypto
    • Fixed OpenSSL error queue handling to prevent error misattribution, and fixed malformed certificate chains loaded from strings to be reported as regular errors instead of invariant violations. Many thanks to seriouscoder43 for the PR!
  • PostgreSQL
    • Fixed incorrect std::forward usage in PostgreSQL code. Many thanks to Artyom Kolpakov for the PR!
  • s3api
    • Fixed ListBucketContentsParsed handling for truncated bucket listings. Many thanks to Merzlikin Matvey for the PR!
  • universal
  • WebSocket
    • Fixed potential size_t overflow in WebSocket frame length checks. Many thanks to netliomax25-code for the PR!
  • http
    • Fixed out-of-bounds read in upgrade detection. Many thanks to netliomax25-code for the PR!

Build:

  • Fixed userver build without USERVER_FEATURE_UBOOST_CORO. Many thanks to Halfdarkangel for the PR!
  • Added Debian Trixie build support for system Abseil package using its own string_view. Many thanks to SSE4 for the PR!
  • Added Debian Trixie build support by using libgrpc++1.51t64 instead of unavailable libgrpc++1. Many thanks to SSE4 for the PR!
  • Enabled ClickHouse support by default and updated the required clickhouse-cpp version to >= 2.6.0. Many thanks to Vasily Sviridov for the PR!
  • Upgraded llhttp to 9.4.1. Many thanks to Konstantin Goncharik for the PR!
  • Added CMake support for mongo-c-driver 2.x.x. Many thanks to Konstantin Goncharik for the PR!
  • Upgraded get_cpm.cmake to 0.42.1. Many thanks to Konstantin Goncharik for the PR!
  • Update fmtlib include directives. Many thanks to Konstantin Goncharik for the PR!
  • Added chaotioc integration tests with boost >=1.91. Many thanks to Konstantin Goncharik for the PR!

Documentation:

  • Removed duplicate documentation entries. Many thanks to Alexander Ermakov for the PR!
  • Adjusted RateCounter description in documentation. Many thanks to Artyom Kolpakov for the PR!
  • Removed incorrect deprecated tag from documentation. Many thanks to Artyom Kolpakov for the PR!

Release v3.0

Big new features since the v2.0:

Binary Ubuntu 24.04 and Ubuntu 22.04 amd64 packages could be found at userver Releases.

Detailed diff against v2.16 could be found below.

v3.0-rc

  • Support of C++17 is removed.
  • Updated moodycamel to 1.0.5. Many thanks to Vasily Sviridov for the PRs.
  • Supported ydb::TableClient::RetryTx handle for execution lambda in a transaction with automatic retries.
  • MultiIndex LRU Container is now optimized and ready to use. Many thanks to hzhdlrp for the contributions!
  • Added heartbeat and message headers support for RabbitMQ. Many thanks to Savochkin Denis.
  • Added URL encoding for S3 object keys. Many thanks to Tnirpps for the PR!
  • Fixed -Wc99-extensions warning in PostgreSQL driver. Many thanks to Dmitry Kopturov.
  • Added the kafka::Producer::Send() method for synchronous batch message delivery to a specified Kafka topic. Implementation spawns only one coroutine for the entire message batch increasing the efficiency of the driver. Driver now attempts to handle librdkafka local queue overflow errors within the configured delivery.timeout.ms limit. Many thanks to Dmitry Isaikin for the PR!
  • utils::statistics::MonotonicByLabelStorage used for metrics in HTTP client, leading to an order of magnitude faster insertion of new metrics.
  • Added [[lifetimebound]] annotations. More lifetime errors in user code is now detected at compile time.
  • Modernized the code, replacing multiple of std::enable_if with C++20 concepts. Some of the very rarely used template variables were replaced with concepts without the k prefix. User code usually not affected, but here's a migration hint for the unfortunate ones:
    find . -type f -name '*pp' | xargs sed -i \
    -e 's/kIsMappedToArray/IsMappedToArray/g' \
    -e 's/kIsMappedToUserType/IsMappedToUserType/g' \
    -e 's/io::traits::kHasParser/io::traits::HasParser/g' \
    -e 's/io::traits::HasFormatter/io::traits::HasFormatter/g' \
    -e 's/kCanReserve/CanReserve/g' \
    -e 's/kCanResize/CanResize/g' \
    -e 's/kCanClear/CanClear/g' \
    -e 's/traits::kIsFixedSizeContainer/meta::kIsFixedSizeContainer/g' \
  • HTTP: Deadline propagation support for an absolute deadline timepoint via the X-Request-Deadline header in addition to X-YaTaxi-Client-TimeoutMs.

Release v2.16

Release v2.15

  • Support of C++17 is deprecated and will be removed in one on the next releases. C++20 is the default for userver for quite some time. Use C++20 or even a more modern C++.
  • Deadlock detector is now enabled by default in testsuite runs. The behavior can be changed by overriding the pytest_userver.plugins.config.userver_deadlock_detector_mode() fixture.
  • Redis driver internals were rewritten to remove duplicate code in Sentinel/ClusterImpl, simplify inheritance and reduce binary size.
  • New pull-pin-task-queue experimental scheduler where each task gets pinned to a thread-specific queue and is executed only in that thread. See static config option 'task-processor-queue' of the components::ManagerControllerComponent for more info.
  • Drastically reduced memory usage by components::Redis statistics/metrics in case of network topology changes or multiple Valkey/Redis nodes going down.
  • Stacktrace capturing via boost::stacktrace / std::stacktrace in Boost.Context became more than x50 faster on LLVM version of libunwind. Other unwinding libraries could have also gained profit.
  • gRPC now clamps status codes outside the valid [0, 16] range to UNKNOWN.
  • More docs for the USERVER_LOG_DYNAMIC_DEBUG, logging macros and engine::SharedMutex.
  • Documented the metrics testing and creation. See Statistics and Metrics
  • Added use_secure_connection static config option for storages::mysql::Component. Many thanks to Yury Bogomolov for the PR.
  • Workaround += use for std::atomic<double> for llvm-17/libc++. Many thanks to Alexander Chernov for the PR.
  • Added missing <ctime> include. Many thanks to Alexander Chernov for the PR.
  • Added missing <iterator> include. Many thanks to Alexander Chernov for the PR.
  • Added missing <fmt/ranges.h> include. Many thanks to Taras Litvinenko for the PR.
  • Fixed flapping YDB tests. Many thanks to Bulat Gayazov for the PR!

Release v2.14

Plugins are renamed to middlewares and components::HttpClient was split into components::HttpClient and components::HttpClientCore.

Migration guide from v2.13 to v2.14

  1. Instead of .Append<components::HttpClient>() use .AppendComponentList(clients::http::ComponentList()) in your component list (see docs).
  2. For classes inherited from tracing::TracingManagerBase :
    1. Change clients::http::PluginRequest in tracing::TracingManagerBase::FillRequestWithTracingContext() parameters to clients::http::MiddlewareRequest

  3. For classes inherited from clients::http::Plugin :

    1. Replace #include <userver/clients/http/plugin.hpp> with #include <userver/clients/http/middlewares/base.hpp>
    2. Change base class to clients::http::MiddlewareBase
    3. Change clients::http::PluginRequest in methods parameters to clients::http::MiddlewareRequest
    4. Stop passing middleware name to base class constructor
    5. Empty methods implementations (or return true; for clients::http::MiddlewareBase::HookOnRetry()) may be omitted

    For example:

    # diff
    -#include <userver/clients/http/plugin.hpp>
    +#include <userver/clients/http/middlewares/base.hpp>
    ...
    -class MyPlugin : public clients::http::Plugin {
    +class MyMiddleware : public clients::http::MiddlewareBase {
    public:
    ...
    - MyPlugin() : clients::http::Plugin("my-plugin") {}
    + MyMiddleware() : clients::http::MiddlewareBase() {}
    - void HookPerformRequest(clients::http::PluginRequest& request) override { do_something(request); }
    + void HookPerformRequest(clients::http::MiddlewareRequest& request) override { do_something(request); };
    - void HookCreateSpan(clients::http::PluginRequest&, tracing::Span&) override {}
    - void HookOnCompleted(clients::http::PluginRequest&, clients::http::Response&) override {}
    - void HookOnError(clients::http::PluginRequest&, std::error_code) override {}
    - bool HookOnRetry(clients::http::PluginRequest&) override { return true; }
    ...
    };

  4. For plugin components inherited from clients::http::plugin::ComponentBase :

    1. Replace #include <userver/clients/http/plugin_component.hpp> with #include <userver/clients/http/middlewares/component.hpp>
    2. Change base class to clients::http::middlewares::ComponentBase
    3. Component name is not required to have prefix http-client-plugin- anymore, http-client- prefix is suggested instead
    4. Rename GetPlugin method to GetMiddleware, change its return type to clients::http::MiddlewareBase
    5. Use dynamic_config::Source::UpdateAndListen() to subscribe on dynamic config updates
    6. Pass middleware index to base class constructor, instead of setting it in config file

    For example:

    # diff
    -#include <userver/clients/http/plugin_component.hpp>
    +#include <userver/clients/http/middlewares/component.hpp>
    ...
    -class SomeComponentName : public clients::http::plugin::ComponentBase {
    +class SomeComponentName : public clients::http::middlewares::ComponentBase {
    public:
    - static constexpr std::string_view kName = "http-client-plugin-my-plugin-name";
    + static constexpr std::string_view kName = "http-client-my-middleware-name";
    - SomeComponentName(const components::ComponentConfig& config, const components::ComponentContext& context)
    - : ComponentBase(config, context),
    - plugin_(std::make_unique<Plugin>()),
    + SomeComponentName(const components::ComponentConfig& config, const components::ComponentContext& context)
    + : ComponentBase(config, context, clients::http::middlewares::MiddlewareIndex{1234}),
    + middleware_(std::make_unique<Middleware>()),
    {
    auto& config_component = context.FindComponent<components::DynamicConfig>();
    subscriber_scope_ =
    - components::DynamicConfig::NoblockSubscriber{config_component}
    - .GetEventSource()
    - .AddListener(this, kName, &Component::OnConfigUpdate);
    + config_component
    + .GetSource()
    + .UpdateAndListen(this, kName, &Component::OnConfigUpdate);
    }
    ...
    - clients::http::Plugin& GetPlugin() override { return *plugin_; }
    + clients::http::MiddlewareBase& GetMiddleware() override { return *middleware_; }
    private:
    - std::unique_ptr<clients::http::Plugin> plugin_;
    + std::unique_ptr<clients::http::MiddlewareBase> middleware_;
    };
  5. Rename http-client: to http-client-core: in static config.

  6. If you are using or customized plugins/middlewares:

    1. In every components::HttpClient config, rename plugins to middlewares
    2. Update middleware component names to current Component::kName
    3. Use full middleware components names as keys and {enabled: true} as values in middlewares for every components::HttpClient config
    4. Move middlewares that you want to use for all components::HttpClient instances from http-client.middlewares to http-client-middleware-pipeline.middlewares
    5. Set dynamic-config-http-client.middlewares.<middleware name>.enabled to false for all middlewares that are subscribed to dynamic configs updates

    For example:

    # diff
    components_manager:
    components:
    - http-client-plugin-common-plugin-name:
    + http-client-common-middleware-name:
    ...
    - http-client-plugin-plugin-with-dynamic-config:
    + http-client-middleware-with-dynamic-config:
    ...
    - http-client:
    + http-client-core:
    fs-task-processor: fs-task-processor
    - plugins:
    - common-plugin-name: 1
    - with-dynamic-config: 2
    + http-client-middleware-pipeline:
    + middlewares:
    + http-client-common-middleware-name:
    + enabled: true
    + http-client-middleware-with-dynamic-config:
    + enabled: true
    + dynamic-config-http-client:
    + middlewares:
    + http-client-middleware-with-dynamic-config:
    + enabled: false
  7. Remove calls to CacheUpdateTrait::StopPeriodicUpdates(). Remove calls to CacheUpdateTrait::StartPeriodicUpdates() or replace them with CacheUpdateTrait::EarlyStartPeriodicUpdates() if early update is required.

Release v2.13

  • Recursive subscriptions on dynamic configs now work without deadlocks.
  • Added virtual method server::handlers::HttpHandlerBase::GetUrlForLogging() for custom URL logging.
  • Support parsing of HTTP keys without =, i.e. /endpoint?key1&key2. Many thanks to Norlin for the PR!
  • Dots in tag keys of logs and spans are now not changed to underscores. HTTP client/server spans are now written according to OTel conventions.
  • Added support for ReplyTo, CorrelationId, Expiration fields. Many thanks to Alexander Aparin for the PR!
  • s3api::Client now supports multipart upload.
  • Redis now understands the GEOPOS and EXPIRE commands via storages::redis::Client member function Geopos() and Expire().
  • Thread Sanitizer suppression file cmake/tsan.suppressions.txt is now installed and used in internal CI TSan tests for universal, core and gRPC.
  • logging::LogExtra::Value now supports bool values. Many thanks to Maxim Drugov for the PR!
  • YDB topic_client is now exposed in testsuite's YdbClient.
  • Removed MONGO_DEADLINE_PROPAGATION_ENABLED_V2 dynamic config. Many thanks to Spar for vibe-coding the PR at Zero Cost Conf!
  • yaml_config::YamlConfig now treats #env values as string.
  • Optimizations
    • TSKV based formatters are now constructed 3 times faster leading to about 1% overall improvement for CPU consumption of some services.
    • Trace data extraction and processing is now 10 times faster.
    • Optimized logging::LogExtra efficiency with std::initializer_list to avoid memory allocations.
    • fs::blocking::CFile now does not lock internal mutex when works with files. Up to 0.2% improvement in logging and ~40% improvement for dumping caches of integers.
    • Reuse SSL_CTX for TLS/SSL connections. As a result memory consumption drastically reduced for TLS/SSL server with. Many thanks to DenisRazinkin for the awesome PR!
  • Build
    • Fix compiling with fmt >= 12. Many thanks to Konstantin Goncharik for the PR!
    • Improved compatibility of response body for aws sdk clients. Many thanks to Alexander Aparin for the PR!
    • Support libpq patching with pq >= 18. MAny thanks to Vladislav Nepogodin for the PR!
    • api-common-protos are now used from the main branch of the upstream, rather than from 1.50 version. Many thanks to Alexey Medvedev for the PR!
    • Support for compiler GCC-9 and below was dropped.
    • Fix issue with pip call ignored args specified in USERVER_PIP_OPTIONS. Many thanks to Komar Dmitry for the PR!
    • Fix building with CPM downloaded abseil-cpp. Many thanks to Konstantin Goncharik for the PR!
    • Added support for Protobuf v6 (30.x). Many thanks to Vasily Sviridov for the PR!
    • Third-party date/date.h was updated. Many thanks to Konstantin Goncharik for the PR!
    • Fixed missing namespace for userver_embed_file. Many thanks to Sergei Fedorov for the PR!
    • Packaged installed via CPM are now printed at the end of configure stage.
    • Boost, c-ares, libev, libnghttp2, yaml-cpp, openssl now can be downloaded via CPM.
    • Added more tests for gRPC in subdirectories. Many thanks to Aleksey Ignatiev for providing test samples.
    • Added CI runs on Arch. Many thanks to Konstantin Goncharik for the PR!
    • Added CI runs on Debian.
  • Documentation and diagnostics

Release v2.12

  • Added infrastructure to detect IO-bound operations in transactions. See enable_trx_tracker static config option into components::ManagerControllerComponent and userver/utils/trx_tracker.hpp. The detection is turned on by default and is used in HTTP clients and gRPC for PostgreSQL transactions.
  • Added support for separate logs and traces endpoints into OpenTelemetry. See logs-endpoint and tracing-endpoint static config options of the otlp::LoggerComponent.
  • Implemented non blocking receive for engine::io::TlsWrapper. Many thanks to Denis Razinkin for the PR!
  • Added server::websocket::WebSocketConnection now has SendPing() and NotAnsweredSequentialPingsCount() functions for initiating pings on server side.
  • Created userver mirror repo at SourceCraft.
  • Kafka now supports SSL authentication. Many thanks to Timur Yalymov for the PR!
  • Fixed UB in WebSockets. Many thanks to Denis Razinkin for the PR!
  • Chaotic now handles x-usrv-cpp-container: std::unordered_set with format: uuid; x-usrv-cpp-type: userver::utils::StrongTypedef<my::CustomString, std::string>; std::intXX_t
  • Crypto part of the userver::universal now supports work with multiple std::string_views. Thanks to Dmitry Sorokin for vibe-coding the initial version of PR.
  • Google Benchmark ASLR-disabling feature enabled if supported. Many thanks to Konstantin Goncharik for the PR!
  • Simplified third-party types usage in chaotic. userver_target_generate_chaotic CMake function now has a LINK_TARGETS parameter to provide targets with paths to chaotic serializers. For example with LINK_TARGETS userver::postgresql chaotic would find the userver/postgresql/include/userver/chaotic/io/userver/storages/postgres/time_point_tz.hpp header with storages::postgres::TimePointTz converters.
  • gRPC and Protobuf
  • Database drivers
  • Optimizations
    • concurrent::BackgroundTaskStorage was optimized with striped counters. Detaching a task now takes ~6% of the whole CPU usage of the detaching benchmark (before the optimizations it was ~46%).
    • storages::Query now avoids dynamic initialization when constructed from storages::Query::NameLiteral. As a result variables generated with CMake userver_add_sql_library function are now not affected by initialization order fiasco issues and can be safely used in any static or global variable. Dynamic memory allocations are now avoided for the above cases.
    • utils::zstring_view now used for Kafka topic names avoiding temporary string constructions.
  • Build
    • The oldest supported Python is now Python 3.9.
    • Protobuf 6.x.y is now supported. Thanks to halfdarkangel for the PR!
    • Supported by-component installation in CPack. See USERVER_INSTALL_MULTIPACKAGE CMake option for a way to enable the feature.
    • Optimized compilation time for the userver/utils/periodic_task.hpp header by removing inclusion of 7 heavy headers.
    • Improved build times by disabling modules scan. Many thanks to Konstantin Goncharik for the PR!
    • Builds are now tested on Fedora.
    • Bumped Kafka version to 4.0 in CI checks. Many thanks to MichaelKab for PR!
  • Documentation and Diagnostics:
    • Version change widget was rewritten to avoid versions hard-code. Many thanks to Lone-Marshal for the PR!
    • Added docs on Distro package maintainers roles.
    • Added more information on metadata usage into gRPC
    • USERVER_GTEST_ENABLE_STACK_USAGE_MONITOR environment variable name was changed to USERVER_ENABLE_STACK_USAGE_MONITOR. USERVER_ENABLE_STACK_USAGE_MONITOR is now usable not only in unit-tests, but in all the userver based applications and services.
    • Redis driver now does much more logging on cluster topology change to ease the cluster issues debugging.
    • Dynamic config pages with description are now generated from schemes.

Release v2.11

Release v2.10

  • Initial implementation of SQLite Driver. Many thanks to Turulin Zakhar for the implementation, tests and for the documentation.
  • GDB pretty printers now can list all the tasks via utask list and can apply commands to all or selected tasks. For example utask apply all bt prints the backtraces of all the tasks, utask apply some_task_name bt prints the backtrace of the task with name some_task_name. See Debugging with GDB for more info. Many thanks to Maxim Belov for the brilliant implementation.
  • Merged a foundation for the ODBC driver. Many thanks to Alexey for the PR!
  • Redis driver now can ignore ping times to different instances to do a fair round-robin. See consider_ping field in storages::redis::CommandControl.
  • Dropped gRPC [(userver.field).secret = true];. Use [debug_redact = true]; instead.
  • Statically assert that a destructor of an object in utils::FastPimpl is noexcept. Many thanks to Шаблов Анатолий Владимирович for the PR!
  • Optimizations:
    • Reduced memory allocations while generating strings for ID in tracing::Span. About a 150ns speedup on average on tracing::Span construction.
    • Removed unused code and class members in Redis internals, reducing runtime memory usage and binary code size.
    • Replaced std::unique_lock with std::lock_guard where possible to simplify optimization work for the compiler.

Release v2.9

  • Logging now supports fmt formatting in macro LOG_INFO("User {} logged in from {}", user_id, ip_address); and lambda formatting. See Logging and Tracing for more info.
  • PostgreSQL driver now can disable all the statements logging via static config option statement-log-mode
  • ClickHouse driver now supports doubles in the queries.
  • YDB now can be used with GCC compiler, not only Clang. YDB still requires C++20 support
  • components::Redis in sentinel mode now supports selection of database index via database_index in secdist config. Many thanks to Tikhon Sergienko for the PR!
  • PostgreSQL cache (shadow replicas) traits now support kOrderBy. With DISTINCT ON expression in kQuery it allows to store only slices of data. Many thanks to Dmitry Kopturov for the PR!
  • Added a userver-create-service script for creation of a new service. Github service templates are now deprecated.
  • Notify on state change when it actually happens in Redis Standalone. Many thanks to Nikolay Pervushin for the PR!
  • Modernized testsuite code, including removal of event_loop usages and usage of asyncio-socket.
  • Hidden thread_id and task_id for INFO+ logger levels to make the logs shorter.
  • Stack usage monitor now could be disabled in test via USERVER_GTEST_ENABLE_STACK_USAGE_MONITOR=0 environment variable.
  • gRPC
    • Added support for debug_redact and added a recommendation to use [debug_redact = true]; instead of [(userver.field).secret = true];
    • Significant speed up logging of large requests and response messages. Note that request/response logs are by default enabled with global DEBUG logging level; the behavior could be overridden by middlewares static configs of ugrpc::client::middlewares::log::Component and ugrpc::server::middlewares::log::Component.
    • Server and client logging tags are now consistent.
    • More improvements, docs and samples for middlewares. See gRPC for more info.
  • Build:
    • Fixed floating point escaping compilation in ClickHouse driver. Many thanks to Ksenia-C for the PR!
    • Fix compilation errors for curl 8.13. Many thanks to Konstantin Goncharik for the PR!
    • Fix compilation errors for fmt 11. Many thanks to Konstantin Goncharik for the PR!
    • Added USERVER_ENABLE_DEBUG_INFO_COMPRESSION build option, that was later changed to USERVER_DEBUG_INFO_COMPRESSION. Many thanks to Konstantin Goncharik for the PRs! Compression detection algorithm was improved to check the linker compression support.
    • Added Debian-12 dependencies and build instructions.
    • Export only files that are not ignored by git for Conan sources. Many thanks to c0rt for the PR!
  • Documentation and Diagnostics:

Release v2.8

  • sharding_strategy of the components::Redis now supports RedisStandalone configuration, that may be useful for tests or unimportant caches. Many thanks to Aleksey Ignatiev for the PR!
  • kafka::Producer now has the API for sending Kafka headers. Many thanks to Mikhail Romaneev for the PR and to Fedor Lobanov for the fix!
  • kafka::ConsumerScope now has the API for receiving Kafka headers.
  • Add span events to OpenTelemetry via tracing::Span::AddEvent(). Many thanks to Dudnik Pavel for the PR.
  • Added logging::JsonString to explicitly describe in type system that a string contains loggable JSON. Many thanks to akhoroshev for the PR!
  • Deadline Propagation for PostgreSQL is now enabled by default and can be controlled via deadline-propagation-enabled static option of the components::Postgres.
  • Testsuite now supports `@pytest.mark.uservice_oneshot`.
  • utils::regex now always uses a faster and safer Re2 instead of boost::regex.
  • Dynamic config USERVER_HANDLER_STREAM_API_ENABLED is not used any more.
  • server::handlers::HttpHandlerStatic now has a expires static config option.
  • kafka::ProducerComponent and kafka::ConsumerComponent now support 'SASL_PLAINTEXT' security protocol. Many thanks to Mikhail Romaneev for the PR!
  • Implemented OneOf discriminator mapping to integer and generation of fmt::formatters for enums in chaotic.
  • Load kRoundRobin load distribution in PostgreSQL is now uniform
  • gRPC
    • Retries are now supported and controlled via dynamic config. See ugrpc::client::Qos for more info.
    • Clients and servers now use the same configuration approach for middlewares, allowing granular overrides of settings.
  • Optimizations
    • Postgres driver now uses moodycamel queue instead of boost::lockfree. Up to 2 times faster retrieval of connection from pool.
    • utils::TrivialBiMap is used in more cases, leading to faster runtime search and minor decrease in binaries size.
    • Multiple std::string constants were replaced with constinit types, leading to faster startup times and smaller binaries.
    • Avoid url copies in clients::http::Request
  • Documentation and Diagnostics:
  • Testing
    • Easy grpc mock registration in testsuite.
    • Daemon-scoped fixtures implemented via @pytest.mark.uservice_oneshot.
  • Build
    • Debug symbols of userver libraries are now compressed with zstd if the toolset supports it, leading to smaller binaries size.
    • Docker images now use zstd compression too.
    • Dropped CI testing on Ubuntu 20.04 which lifetime almost ended.
    • Improved build type matching for installed userver. Many thanks to Aleksey Ignatiev for the PR!

Release v2.7

Release v2.6

  • storages::secdist::Secdist is now automatically reloaded for Mongo, Redis and PostgreSQL databases if the secdist file was changed. Now changing the connection parameters in file does not require service restart.
  • Public parts of the Redis driver were moved out from impl/ directory and placed into storages::redis:: namespace. If you were relying on the old paths, see ./scripts/migrate_from_legacy_redis_ns.sh script to ease migration.
  • Shortened testsuite logs were made more functional by providing HTTP URL info.
  • Removed old gRPC interface for server handlers as was promised in previous release notes.
  • gRPC client interfaces were changed to be more user friendly. For example, for HelloWorld method in protobuf we generate the old HelloWorld function along with the new AsyncHelloWorld and SyncHelloWorld functions. AsyncHelloWorld returns a ugrpc::client::ResponseFuture that can be used to retrieve the request result later in code. SyncHelloWorld retrieves the response from the future and returns the response itself. Consider replacing:
    • HelloWorld(x).Finish() with SyncHelloWorld(x)
    • auto res = HelloWorld(x); /* a lot of code */; res.Finish(); with auto res = AsyncHelloWorld(x); /* a lot of code*/; res.Get(); In next release we will remove the old HelloWorld and will rename SyncHelloWorld into HelloWorld.
  • Added Easy - library for single file prototyping. Now the service can be created in a few code lines:
    int main(int argc, char* argv[]) {
    easy::HttpWith<>(argc, argv)
    .DefaultContentType(http::content_type::kTextPlain)
    .Route("/hello", [](const server::http::HttpRequest& /*req*/) {
    return "Hello world"; // Just return the string as a response body
    });
    }
  • Added userver_embed_file CMake function to embed files into the binary. See Writing your first HTTP server for an example.
  • Queries now can be moved to a separate files.
  • Added graceful shutdown functionality. See graceful_shutdown_interval in components::ManagerControllerComponent.
  • server::http::HttpRequestBuilder now can be used to create server::http::HttpRequest in unit tests.
  • Kafka driver now has kafka::ConsumerScope::GetPartitionIds() and kafka::ConsumerScope::GetOffsetRange() functions. Many thanks to Kirill for the PR!
  • OpenTelemetry now sends span_kind information.
  • Added user, password, and secure_connection_cert parameters support for the YDB secdist. Thanks to Попов Алексей for the PR!
  • POSTGRES_TOPOLOGY_SETTINGS now has disabled_replicas option to disable some of the replicas.
  • Fixed Kafka logs being written into STDERR in edge cases. Thanks to Dudnik Pavel for the PR!
  • Added unbounded queue variants concurrent::UnboundedNonFifoMpscQueue, concurrent::UnboundedSpmcQueue, and concurrent::UnboundedSpscQueue. Those queues are usually x2 faster than the bounded variants.
  • GT and LT flags support in Redis ZADD. Thanks to Nikolay Pervushin for the PR!
  • Reduced condition in OTLP, thanks to Dudnik Pavel.
  • Build:
    • Simplified Profile Guided Optimization (PGO) gathering and usage due to new USERVER_PGO_GENERATE and USERVER_PGO_USE CMake options. See Configure, Build and Install for more info.
    • MacOS now can build the userver as a Conan package.
    • Build flags were reorganized to use a new USERVER_BUILD_ALL_LIBRARIES CMake option. See Build options for more info.
    • Source directory now can contain spaces.
    • Correctly set grpc-reflection found flag. Thanks to Nikita for the PR!
    • Fixed USERVER_CHAOTIC_FORMAT option for CMake build. Thanks to Konstantin Goncharik for the PR.
    • Optimized reconfiguration in CMake giving up to 60% time save (6-20 seconds).
  • Documentation and diagnostics:
    • More information on Mongo heartbeat in logs.
    • Added docs about tag name of tracing::ScopeTime.
    • Improved PostgreSQL diagnostic messages for server response parsing errors due to C++ and DB types mismatch.
    • Better samples and docs for utils::statistics::Writer.
    • Added direct database access to testsuite samples.
    • Updated the Concurrent Queues docs.
    • Log formats message was amended. Thanks to tkhanipov for the PR!

Release v2.5

  • Added S3 API client s3api::Client. Many thanks to v-for-vandal for the work!
  • Added gRPC reflection library. Many thanks to v-for-vandal for the work!
  • Added Kill Switch functionality. Many thanks to Aksenov Anton for the work!
  • Congestion Control turned on by default.
  • Initial work towards embedding GDB pretty-printers to userver binaries.
  • Mongo now has the full functionality for diagnostics out-of-the box, without mongo-c library patches.
  • Simplified contributing by removing the annoying bot that checks for explicit agreement to CLA. Creating an issue or sending a PR already means agreement with CLA. Added notes to PR and Issue creation to highlight that.
  • Basic support for HTTP/2 body streaming.
  • Kafka support in testsuite implemented. See Functional tests section at Kafka service tutorial.
  • gRPC:
    • Safe new interface for gRPC server handlers. Old interface will be removed in next release.
    • Added support for TLS in gRPC.
    • Added ugrpc::server::middlewares::field_mask::Component for masking and trimming messages. Many thanks to TTPO100AJIEX for the work!
    • gRPC clients now allow configuring channels count for particular methods via dedicated-channel-counts static config option.
  • Optimizations:
  • Build:
    • Added userver_module() CMake function to simplify configuration of new drivers that are being added to userver.
    • Added missing fmt/ranges.h includes. Thanks to Vasilii Kuziakin and to SidorovichPavel for the PRs!
    • Proper use of PROTOBUF_PROTOC in CMake. Thanks to Nikita for the PR!
    • Added support for builds in paths that contain whitespaces and other special symbols.
    • Added CI build tests for Ubuntu 24.04 and MacOS.
    • Switched to Conan v2. Many thanks to Anton for the PR! Also use modern versions of third party libraries in Conan.
  • Documentation and diagnostics:
    • A whole new build dedicated section was added to the docs instead of the old "Configure, Build and Install" page.
    • Improved schemes validation messages, including config validation messages because no schema is written.
    • Disambiguated diagnostic messages for component system.
    • Better log messages for the dist locks.
    • Better docs for gRPC middlewares and gRPC logs at gRPC.
    • Added topology and heartbeats logs and metrics for Mongo.
    • Clarified docs on PostgreSQL data types with timezones. See uPg: Supported data types.
    • Added Kafka service tutorial.
    • Logging at runtime, Congestion Control documentation rewrite.

Release v2.4

  • Added USERVER_LOG_REQUEST_HEADERS_WHITELIST to control the HTTP headers to log.
  • OpenTelemetry protocol (OTLP) now can optionally do only logging or only tracing. Thanks to TertiumOrganum1 for the PR!
  • The framework now accepts OTLP headers for tracing by default and puts those headers for new requests.
  • PostgreSQL span names are now a little bit more informative. Thanks to TertiumOrganum1 for the PR!
  • Kafka now has a client.id static option. Many thanks to Nikolay Pervushin for the PR.
  • PostgreSQL type errors become more informative. Thanks to farmovit for the report!
  • Optimizations:
    • HTTP/2 server implementation now does not copy data to send, saving CPU and RAM.
    • HTTP/2 now relies on open-addressing unordered map from nghttp2, leading to faster stream lookup.
    • Kafka consumer now does not block a task processor thread, allowing multiple consumers to share the same OS thread. Consume cycle now can be treated as an asynchronous non-blocking event loop.
    • Kafka producer delivery acknowledgments processing is now done in parallel, leading to better scalability. Also it does not block the OS thread when waiting for new delivery acknowledgments.
    • Internals of all the Sockets became smaller in size, saving some RAM.
  • gRPC:
  • Build, Install and CI:
    • OTLP build is now supported in Conan. Thanks to Amina Ramazanova for the PR!
    • Chaotic now exposes less headers, leading to faster build times.
    • Fixed compilation on modern Boost.UUID. Thanks to Alexander Botev for the PR!
    • Added dependabot to CI and updated the dependencies. Thanks to Dzmitry Ivaniuk for the PR!
    • Added missing #include. Thanks to Nikita for the PR!
    • Removed outdated defines in the core. Thanks to Sergey Kazmin for the PR!
    • Install now does not put third party headers into the top level include directory. Multiple unused files are now not installed.
    • Started the work to enable builds in directories with whitespace in names.
  • Documentation:

Release v2.3

  • Initial HTTP 2.0 server support is now implemented. Use handler-defaults.http_version static config option of components::Server to enable.
  • Logger for OpenTelemetry protocol was implemented. Could be enabled via USERVER_FEATURE_OTLP CMake option. See the docs for more info.
  • Client address in handler now could be retrieved via server::http::HttpRequest::GetRemoteAddress(). Many thanks to Daniil Shvalov for the PR.
  • The scheduler implementation now could be adjusted for each task_processor via task-processor-queue static option. A more efficient work-stealing-task-queue was introduced. Many thanks to Egor Bocharov for the PR!
  • Added storages::postgres::TimePointWithoutTz for more explicit declaration of intent. Direct work with std::chrono::system_clock is now deprecated in PostgreSQL driver.
  • Validation of static config schemas now understands minItems and maxItems for arrays. Many thanks to eparoshin for the PR.
  • Websockets now have case insensitive check of headers. Thanks to Alexander Enaldiev for the PR!
  • Added engine::io::Socket::ReadNoblock() function to check if there's a pending data and read it if any. server::websocket::WebSocketConnection now has a TryRecv() function to receive a message if its first bytes already came. Thanks to Alexander Enaldiev for the PR!
  • #env, #file and #fallback now could be used in config_vars file. See yaml_config::YamlConfig for more info. Thanks to Artyom Samuylik for the PR.
  • gRPC
    • Sensitive data now could be hidden in logs via applying a [(userver.field).secret = true] option to a protobuf field in schema.
    • Generic server now could be implemented via ugrpc::server::GenericServiceBase. Generic client ugrpc::client::GenericClient was also implemented. The functionality of generic client/server is useful for writing gRPC proxies.
    • gRPC server now shows aggregated grpc.server.total metrics
    • More samples and docs.
  • Optimizations:
    • IO events are now uniformly distributed between ev threads. This leads to better performance on high loads in default configurations. Even number of ev threads now works as good as odd number of threads.
    • IO watchers now always start asynchronously, leading to x2 less CPU consumption for each start+stop operation. As a result ev threads of HTTP client and Redis driver now use less CPU.
    • Timer events with reachable deadlines now are deferred if that does not affect latencies. This gives ~5% RPS improvement for service_template.
  • Build
    • Find*.cmake files are not generated any more, leading to simpler code base and faster configure times.
    • Fixed incorrect handling of dots in chaotic paths. Thanks to Alexander Chernov for the PR!
    • MacOS build options are now part of the CMake files, leading to less boilerplate while compiling for that platform. Many thanks to Daniil Shvalov for the PR.
    • Kafka driver is now enabled in Conan. Many thanks to Aleksandr Gusev for the PR.
    • Conan related build fixes. Thanks to Alex for the PR.

Release v2.2

  • Added codegen parsers and serializers by JSON schema
  • Improved the ability to unit test of gRPC clients and servers, Redis and Mongo databases, logs. Samples and docs were improved.
  • Implemented feedback forms and likes/dislikes for each documentation page. Feedback would be appreciated! Many thanks to Fedor Alekseev for the PR and to MariaGrinchenko for the buttons design!
  • Added docs on YDB.
  • Mobile header view and docs layout was improved. Many thanks to Fedor Alekseev for the PRs.
  • engine::subprocess::ProcessStarter::Exec now can lookup binaries via PATH variable.
  • Fixed gRPC generation for nested namespaces with repetitions. Many thanks to nfrmtk for the PR!
  • Handle both websocket and plain HTTP requests for the same path. Many thanks to Hovard Smith for the PR!
  • Support setting client + CA certs in RabbitMQ. Many thanks to Alexey Dyumin for the PR!
  • yaml_config::YamlConfig now can read files via #file. Now the static config of the service could refer to other files.
  • Added support of bit operations to Redis.
  • PostgreSQL driver now works with AWS Aurora.
  • Added quick start for beginners to Configure, Build and Install. Many thanks to Fedor Alekseev for the PR.
  • Improved path to sources trimming for Conan builds. Many thanks to Kirill for the PR!
  • Multiple minor improvements to build, packaging, docs and testing.

Release v2.1 (May 2024)

  • Coroutines stack usage is now shown in the engine.coro-pool.stack-usage.max-usage-percent metric. Improved stack-overflow diagnostics.
  • HTTP server and HTTP client now support ZSTD decompression. Thanks to Илья Оплачкин and VScdr for the PR!
  • Added redis::MakeBulkHedgedRedisRequestAsync() and redis::MakeBulkHedgedRedisRequest().
  • OpenTelemetry parent span-id is now passed through AMQP headers along with trace-id. Thanks to TertiumOrganum1 for the PR!
  • ugrpc::server::MiddlewareBase now has CallRequestHook and CallResponseHook for intercepting requests and responses.
  • components::LoggableComponentBase was renamed to components::ComponentBase. components::RawComponentBase was published.
  • Multiple improvements for logging in testsuite.
  • gRPC metrics are now not written for methods that were not used at runtime.
  • Mongo pools now can be adjusted at runtime via dynamic config MONGO_CONNECTION_POOL_SETTINGS. Congestion Control for individual Mongo databases now could be controlled via MONGO_CONGESTION_CONTROL_DATABASES_SETTINGS. Congestion Control is now enabled by default.
  • Reduced contention in coro::Pool and added some tests and benchmarks. Many thanks to Egor Bocharov for the PRs!
  • Added urabbitmq::ConsumerComponentBase::Process() accepting the whole urabbitmq::ConsumedMessage. Thanks to TertiumOrganum1 for the PR!
  • human_logs.py now supports more options and has more examples and docs embedded. Thanks to TertiumOrganum1 for the PR!
  • server::http::HttpStatus and client::http::Status are now aliases to http::StatusCode. Many thanks to SidorovichPavel for the PR!
  • Docs and build:
    • find_package(userver) now implicitly calls userver_setup_environment(), includes all the helper CMake userver scripts, making the configuration simpler. Added diagnostics and fix-it hints for some of the CMake missuses.
    • In docs Ctrl+k hotkey now focuses on Search input. Many thanks to Fedor Alekseev for the PR!
    • ODR-violations are now avoided if the userver is built with different standard version than the service.
    • Each sample is now usable as a root project.
    • Each driver now has a Quality Tier.
    • Fixed minimal version requirements for Pythons gRPC modules. Thanks to Nikita for the PR!
    • Reduced build times by avoiding inclusion of heavy headers.
    • Added an example on PostgreSQL bytea usage. Thanks to TertiumOrganum1 for the PR!
    • Multiple improvements for docs, build and CI scripts.

Release v2.0

Big new features since the v1.0.0:

  • Simplified dynamic configs and embedded defaults into the code.
  • Added PostgreSQL connection pools auto-configuration.
  • Added YDB driver and basic Kafka driver.
  • LISTEN/NOTIFY support for PostgreSQL
  • New landing page for the website
  • Significantly reduced network data transmission for PostgreSQL
  • Supported install in CMake and CPack packaging.
  • Implemented middlewares for HTTP server, most of the HTTP server functionality was moved to middlewares.
  • Improved documentation, added more samples and descriptions.
  • Numerous optimizations and build improvements.

Detailed descriptions could be found below.

Binary Ubuntu 22.04 amd64 package could be found at userver Releases.

May 2024 (v2.0-rc)

  • Kafka driver is now documented, compiles and works. Thanks to Fedor for the work!
  • Added utils::numeric_cast for safe casting of integers of different width.
  • The userver framework is now available at Yandex Cloud Marketplace.
  • YDB driver now can be built on modern Clang compilers in C++20 and above modes.
  • Redis now allows you to subscribe to master instances.
  • Improved logging of failures in testsuite.
  • Optimizations:
    • rcu::Variable was optimized to use asymmetric fences and concurrent::StripedCounter. x1000 performance improvement for some edge cases, x3 improvement for the generic use case.
    • Internal TaskCounter now uses concurrent::StripedCounter to reduce contention on atomics on each async task construction and destruction.
    • Adjusted the default spinning count in scheduler to better fit modern hardware and typical loads.
    • ~5% faster tasks queue overload detection logic. Many thanks to Egor Bocharov for the PR!
  • Docs, tests and build
    • Fixed build of utils/rand.hpp related source files. Thanks to Nikita for the PR!
    • Improved logic of Telegram support chats URL selection. Many thanks to Mingaripov Niyaz for the PR!
    • Fixed multiple @snippet links in docs. Many thanks to Mingaripov Niyaz for the PR!
    • Fixed flaky ThreadLocal.SafeThreadLocalWorks test. Many thanks to Egor Bocharov for the PR!

Older releases

⇦ Releases, Trunk-based Development and Pull Requests | Distro package maintainers ⇨