update opentelemetry extension docs

Author: joao-r-reis

doc/features/opentelemetry/README.md

@@ -9,7 +9,6 @@ Add the package `Cassandra.OpenTelemetry` to the project and add the extension m
 ```csharp
 var cluster = Cluster.Builder()
     .AddContactPoint(Program.ContactPoint)
-    .WithSessionName(Program.SessionName)
     .WithOpenTelemetryInstrumentation()
     .Build();
 ```
@@ -29,11 +28,13 @@ The table below displays the list of included attributes in this feature:
 | Attribute  | Description  | Output Values|
 |---|---|---|
 | db.namespace | The keyspace name. | *keyspace in use* |
-| db.operation.name | The type name of the operation being executed. | *Session Request* for session level calls and *Node Request* for node level calls |
-| db.query.text | The database statement being executed. Included as [optional configuration](#include-statement-as-an-attribute). | *database statement in use* |
-| db.system | An identifier for the database management system (DBMS) product being used. | cassandra |
-| server.address | The host node. | e.g.: 127.0.0.1 |
-| server.port | Port number. | e.g.: 9042 |
+| db.operation.name | The type name of the operation being executed. | `Session_Request({RequestType})` for session level calls and `Node_Request({RequestType})`  for node level calls |
+| db.query.text | The database statement being executed. Included as [optional configuration](#include-statement-as-an-attribute). | e.g.: `SELECT * FROM system.local` |
+| db.system | An identifier for the database management system (DBMS) product being used. | `cassandra` |
+| server.address | The host node. | e.g.: `127.0.0.1` |
+| server.port | Port number. | e.g.: `9042` |
+
+Note that in some cases the driver does not know which keyspace a request is targeting because the driver doesn't parse CQL query strings.
 
 The console log below displays an example of a full Cassandra activity:
 
@@ -43,15 +44,15 @@ Activity.SpanId:             bd42cfc78b552cd1
 Activity.TraceFlags:         Recorded
 Activity.ActivitySourceName: Cassandra.OpenTelemetry
 Activity.ActivitySourceVersion: 1.0.0.0
-Activity.DisplayName:        Session Request
+Activity.DisplayName:        Session_Request(SimpleStatement) system
 Activity.Kind:               Client
 Activity.StartTime:          2024-09-13T14:08:36.9762191Z
 Activity.Duration:           00:00:00.0416284
 Activity.Tags:
     db.system: cassandra
-    db.operation.name: Session Request
+    db.operation.name: Session_Request(SimpleStatement)
     db.namespace: system
-    db.query.text: SELECT * FROM system.local
+    db.query.text: SELECT * FROM local
 Resource associated with Activity:
     service.name: CassandraDemo
     service.version: 1.0.0
@@ -72,7 +73,17 @@ As mentioned above, the attribute `db.query.text` is not included by default in
 ```csharp
 var cluster = Cluster.Builder()
     .AddContactPoint(Program.ContactPoint)
-    .WithSessionName(Program.SessionName)
     .AddOpenTelemetryInstrumentation(options => options.IncludeDatabaseStatement = true)
     .Build();
+```
+
+### Batch Statement size
+
+By default, the `OpenTelemetry` extension only uses up to `5` child statements of a `BatchStatement` to generate  the `db.query.text` tag. If you want to change this number, set the `CassandraInstrumentationOptions` property `BatchChildStatementLimit`:
+
+```csharp
+var cluster = Cluster.Builder()
+    .AddContactPoint(Program.ContactPoint)
+    .AddOpenTelemetryInstrumentation(options => options.BatchChildStatementLimit = 10)
+    .Build();
 ```