The returned connection object should not be used directly; instead it should be passed as an argument to the constructor ofTraceServiceClient.
The optionaloptionsargument may be used to configure aspects of the returnedTraceServiceConnection. Expected options are any of the types in the following option lists:
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-09-04 UTC."],[[["\u003cp\u003eThis webpage provides documentation for the Google Cloud Trace C++ client library, with version 2.36.0 as the current stable version, and 2.37.0-rc as the latest release candidate.\u003c/p\u003e\n"],["\u003cp\u003eThe content includes links to documentation for several previous versions of the library, ranging from version 2.35.0 down to 2.11.0.\u003c/p\u003e\n"],["\u003cp\u003eKey classes related to the API for collecting and viewing traces, such as \u003ccode\u003eTraceServiceClient\u003c/code\u003e and \u003ccode\u003eTraceServiceConnection\u003c/code\u003e, are detailed with links to their specific documentation pages.\u003c/p\u003e\n"],["\u003cp\u003eThe page describes important structs used to configure options such as the retry policy and connection idempotency, including \u003ccode\u003eTraceServiceBackoffPolicyOption\u003c/code\u003e, \u003ccode\u003eTraceServiceConnectionIdempotencyPolicyOption\u003c/code\u003e, and \u003ccode\u003eTraceServiceRetryPolicyOption\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eMakeTraceServiceConnection\u003c/code\u003e function is a factory for creating \u003ccode\u003eTraceServiceConnection\u003c/code\u003e objects and accepts optional parameters for configurations, such as common, gRPC, and credential options, as well as a function to produce a default idempotency policy.\u003c/p\u003e\n"]]],[],null,["# Namespace google::cloud::trace_v1 (2.36.0)\n\nVersion 2.36.0keyboard_arrow_down\n\n- [2.42.0-rc (latest)](/cpp/docs/reference/trace/latest/namespacegoogle_1_1cloud_1_1trace__v1)\n- [2.41.0](/cpp/docs/reference/trace/2.41.0/namespacegoogle_1_1cloud_1_1trace__v1)\n- [2.40.0](/cpp/docs/reference/trace/2.40.0/namespacegoogle_1_1cloud_1_1trace__v1)\n- [2.39.0](/cpp/docs/reference/trace/2.39.0/namespacegoogle_1_1cloud_1_1trace__v1)\n- [2.38.0](/cpp/docs/reference/trace/2.38.0/namespacegoogle_1_1cloud_1_1trace__v1)\n- [2.37.0](/cpp/docs/reference/trace/2.37.0/namespacegoogle_1_1cloud_1_1trace__v1)\n- [2.36.0](/cpp/docs/reference/trace/2.36.0/namespacegoogle_1_1cloud_1_1trace__v1)\n- [2.35.0](/cpp/docs/reference/trace/2.35.0/namespacegoogle_1_1cloud_1_1trace__v1)\n- [2.34.0](/cpp/docs/reference/trace/2.34.0/namespacegoogle_1_1cloud_1_1trace__v1)\n- [2.33.0](/cpp/docs/reference/trace/2.33.0/namespacegoogle_1_1cloud_1_1trace__v1)\n- [2.32.0](/cpp/docs/reference/trace/2.32.0/namespacegoogle_1_1cloud_1_1trace__v1)\n- [2.31.0](/cpp/docs/reference/trace/2.31.0/namespacegoogle_1_1cloud_1_1trace__v1)\n- [2.30.0](/cpp/docs/reference/trace/2.30.0/namespacegoogle_1_1cloud_1_1trace__v1)\n- [2.29.0](/cpp/docs/reference/trace/2.29.0/namespacegoogle_1_1cloud_1_1trace__v1)\n- [2.28.0](/cpp/docs/reference/trace/2.28.0/namespacegoogle_1_1cloud_1_1trace__v1)\n- [2.27.0](/cpp/docs/reference/trace/2.27.0/namespacegoogle_1_1cloud_1_1trace__v1)\n- [2.26.0](/cpp/docs/reference/trace/2.26.0/namespacegoogle_1_1cloud_1_1trace__v1)\n- [2.25.1](/cpp/docs/reference/trace/2.25.1/namespacegoogle_1_1cloud_1_1trace__v1)\n- [2.24.0](/cpp/docs/reference/trace/2.24.0/namespacegoogle_1_1cloud_1_1trace__v1)\n- [2.23.0](/cpp/docs/reference/trace/2.23.0/namespacegoogle_1_1cloud_1_1trace__v1)\n- [2.22.1](/cpp/docs/reference/trace/2.22.1/namespacegoogle_1_1cloud_1_1trace__v1)\n- [2.21.0](/cpp/docs/reference/trace/2.21.0/namespacegoogle_1_1cloud_1_1trace__v1)\n- [2.20.0](/cpp/docs/reference/trace/2.20.0/namespacegoogle_1_1cloud_1_1trace__v1)\n- [2.19.0](/cpp/docs/reference/trace/2.19.0/namespacegoogle_1_1cloud_1_1trace__v1)\n- [2.18.0](/cpp/docs/reference/trace/2.18.0/namespacegoogle_1_1cloud_1_1trace__v1)\n- [2.17.0](/cpp/docs/reference/trace/2.17.0/namespacegoogle_1_1cloud_1_1trace__v1)\n- [2.16.0](/cpp/docs/reference/trace/2.16.0/namespacegoogle_1_1cloud_1_1trace__v1)\n- [2.15.1](/cpp/docs/reference/trace/2.15.1/namespacegoogle_1_1cloud_1_1trace__v1)\n- [2.14.0](/cpp/docs/reference/trace/2.14.0/namespacegoogle_1_1cloud_1_1trace__v1)\n- [2.13.0](/cpp/docs/reference/trace/2.13.0/namespacegoogle_1_1cloud_1_1trace__v1)\n- [2.12.0](/cpp/docs/reference/trace/2.12.0/namespacegoogle_1_1cloud_1_1trace__v1)\n- [2.11.0](/cpp/docs/reference/trace/2.11.0/namespacegoogle_1_1cloud_1_1trace__v1) \n\nClasses\n-------\n\n### [TraceServiceClient](/cpp/docs/reference/trace/2.36.0/classgoogle_1_1cloud_1_1trace__v1_1_1TraceServiceClient)\n\nThis file describes an API for collecting and viewing traces and spans within a trace.\n\n### [TraceServiceConnection](/cpp/docs/reference/trace/2.36.0/classgoogle_1_1cloud_1_1trace__v1_1_1TraceServiceConnection)\n\nThe [`TraceServiceConnection`](/cpp/docs/reference/trace/2.36.0/classgoogle_1_1cloud_1_1trace__v1_1_1TraceServiceConnection) object for [`TraceServiceClient`](/cpp/docs/reference/trace/2.36.0/classgoogle_1_1cloud_1_1trace__v1_1_1TraceServiceClient).\n\n### [TraceServiceConnectionIdempotencyPolicy](/cpp/docs/reference/trace/2.36.0/classgoogle_1_1cloud_1_1trace__v1_1_1TraceServiceConnectionIdempotencyPolicy)\n\n### [TraceServiceLimitedErrorCountRetryPolicy](/cpp/docs/reference/trace/2.36.0/classgoogle_1_1cloud_1_1trace__v1_1_1TraceServiceLimitedErrorCountRetryPolicy)\n\nA retry policy for [`TraceServiceConnection`](/cpp/docs/reference/trace/2.36.0/classgoogle_1_1cloud_1_1trace__v1_1_1TraceServiceConnection) based on counting errors.\n\n### [TraceServiceLimitedTimeRetryPolicy](/cpp/docs/reference/trace/2.36.0/classgoogle_1_1cloud_1_1trace__v1_1_1TraceServiceLimitedTimeRetryPolicy)\n\nA retry policy for [`TraceServiceConnection`](/cpp/docs/reference/trace/2.36.0/classgoogle_1_1cloud_1_1trace__v1_1_1TraceServiceConnection) based on elapsed time.\n\n### [TraceServiceRetryPolicy](/cpp/docs/reference/trace/2.36.0/classgoogle_1_1cloud_1_1trace__v1_1_1TraceServiceRetryPolicy)\n\nThe retry policy for [`TraceServiceConnection`](/cpp/docs/reference/trace/2.36.0/classgoogle_1_1cloud_1_1trace__v1_1_1TraceServiceConnection).\n\nStructs\n-------\n\n### [TraceServiceBackoffPolicyOption](/cpp/docs/reference/trace/2.36.0/structgoogle_1_1cloud_1_1trace__v1_1_1TraceServiceBackoffPolicyOption)\n\nUse with [`google::cloud::Options`](https://cloud.google.com/cpp/docs/reference/common/latest/classgoogle_1_1cloud_1_1Options.html) to configure the backoff policy.\n\n### [TraceServiceConnectionIdempotencyPolicyOption](/cpp/docs/reference/trace/2.36.0/structgoogle_1_1cloud_1_1trace__v1_1_1TraceServiceConnectionIdempotencyPolicyOption)\n\nUse with [`google::cloud::Options`](https://cloud.google.com/cpp/docs/reference/common/latest/classgoogle_1_1cloud_1_1Options.html) to configure which operations are retried.\n\n### [TraceServiceRetryPolicyOption](/cpp/docs/reference/trace/2.36.0/structgoogle_1_1cloud_1_1trace__v1_1_1TraceServiceRetryPolicyOption)\n\nUse with [`google::cloud::Options`](https://cloud.google.com/cpp/docs/reference/common/latest/classgoogle_1_1cloud_1_1Options.html) to configure the retry policy.\n\nFunctions\n---------\n\n### MakeTraceServiceConnection(Options)\n\nA factory function to construct an object of type [`TraceServiceConnection`](/cpp/docs/reference/trace/2.36.0/classgoogle_1_1cloud_1_1trace__v1_1_1TraceServiceConnection). \nThe returned connection object should not be used directly; instead it should be passed as an argument to the constructor of [TraceServiceClient](/cpp/docs/reference/trace/2.36.0/classgoogle_1_1cloud_1_1trace__v1_1_1TraceServiceClient).\n\nThe optional `options` argument may be used to configure aspects of the returned [`TraceServiceConnection`](/cpp/docs/reference/trace/2.36.0/classgoogle_1_1cloud_1_1trace__v1_1_1TraceServiceConnection). Expected options are any of the types in the following option lists:\n\n- [`google::cloud::CommonOptionList`](https://cloud.google.com/cpp/docs/reference/common/latest/namespacegoogle_1_1cloud.html)\n- [`google::cloud::GrpcOptionList`](https://cloud.google.com/cpp/docs/reference/common/latest/namespacegoogle_1_1cloud.html)\n- [`google::cloud::UnifiedCredentialsOptionList`](https://cloud.google.com/cpp/docs/reference/common/latest/namespacegoogle_1_1cloud.html)\n- [`google::cloud::trace_v1::TraceServicePolicyOptionList`](about:invalid#zCSafez)\n\n| **Note:** Unexpected options will be ignored. To log unexpected options instead, set `GOOGLE_CLOUD_CPP_ENABLE_CLOG=yes` in the environment.\n\n### MakeDefaultTraceServiceConnectionIdempotencyPolicy()"]]
