Skip to content

Commit 42a0f1b

Browse files
committed
session_builder: Warn C* users about tracing
Cassandra sometimes takes a lot of time to update tracing tables. Default values in session builder are suitable for Scylla, so Cassandra users may encounter unexpected timeouts. This commit adds a note suggesting them to increase the values.
1 parent fe57308 commit 42a0f1b

File tree

1 file changed

+8
-0
lines changed

1 file changed

+8
-0
lines changed

scylla/src/transport/session_builder.rs

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -816,6 +816,10 @@ impl<K: SessionBuilderKind> GenericSessionBuilder<K> {
816816
/// Tracing info might not be available immediately on queried node - that's why
817817
/// the driver performs a few attempts with sleeps in between.
818818
///
819+
/// Cassandra users may want to increase this value - the default is good
820+
/// for Scylla, but Cassandra sometimes needs more time for the data to
821+
/// appear in tracing table.
822+
///
819823
/// # Example
820824
/// ```
821825
/// # use scylla::{Session, SessionBuilder};
@@ -841,6 +845,10 @@ impl<K: SessionBuilderKind> GenericSessionBuilder<K> {
841845
/// Tracing info might not be available immediately on queried node - that's why
842846
/// the driver performs a few attempts with sleeps in between.
843847
///
848+
/// Cassandra users may want to increase this value - the default is good
849+
/// for Scylla, but Cassandra sometimes needs more time for the data to
850+
/// appear in tracing table.
851+
///
844852
/// # Example
845853
/// ```
846854
/// # use scylla::{Session, SessionBuilder};

0 commit comments

Comments
 (0)