doc: Client configuration information and options

Author: Michael Fero

doc/features/README.md

@@ -6,6 +6,7 @@ Apache Cassandra] includes the following features:
 * [DSE plaintext and GSSAPI authentication](/features/authentication)
 * [DSE geospatial types](/features/geotypes/)
 * [DSE graph integration](/features/graph/)
+* [Client configuration](/features/client_configuration/)
 
 This documentation only includes DSE specific features. Documentation for the
 core driver can be found [here](http://datastax.github.io/cpp-driver/).

doc/features/client_configuration/README.md

@@ -0,0 +1,48 @@
+# Client Configuration
+
+Client configuration allows an application to provide additional metadata to
+the cluster which can be useful for troubleshooting and performing diagnostics.
+In addition to the optional application metadata the cluster will automatically
+be provided with the driver's name, driver's version, and a unique session
+identifier.
+
+## Application Options (Optional)
+
+Application name and version metadata can be provided to the cluster during
+configuration. This information can be used to isolate specific applications on
+the server-side when troubleshooting or performing diagnostics on clusters that
+support multiple applications.
+
+```c
+CassCluster* cluster = cass_cluster_new();
+
+/* Assign a name for the application connecting to the cluster */
+cass_cluster_set_application_name(cluster, "Application Name");
+
+/* Assign a version for the application connecting to the cluster */
+cass_cluster_set_application_version(cluster, "1.0.0");
+
+/* ... */
+
+cass_cluster_free(cluster);
+```
+
+## Client Identification
+
+Each session is assigned a unique identifier (UUID) which can be used to
+identify specific client connections server-side. The identifier can also be
+retrieved client-side using the following function:
+
+```c
+CassSession* session = cass_session_new();
+
+/* Retrieve the session's unique identifier */
+CassUuid client_id = cass_session_get_client_id(session);
+
+/* ... */
+
+cass_session_free(session);
+```
+
+**Note**: A session's unique identifier is constant for its lifetime and does
+          not change when re-establishing connection to a cluster.

include/dse.h

@@ -549,8 +549,9 @@ cass_session_execute_dse_graph(CassSession* session,
  * Get the client id.
  *
  * This can help with debugging issues in large clusters where there are a lot
- * of client connections. This UUID is randomly generated by the driver when
- * establishing a session connection.
+ * of client connections. A session's unique identifier (UUID) is constant for
+ * its lifetime and does not change when re-establishing connection to a
+ * cluster.
  *
  * @dse{6.0.0+}
  *