This file describes an API for collecting and viewing traces and spans
within a trace. A Trace is a collection of spans corresponding to a single
operation or set of operations for an application. A span is an individual
timed event which forms a node of the trace tree. Spans for a single trace
may span multiple services.
Sends new traces to Stackdriver Trace or updates existing traces. If the ID
of a trace that you send matches that of an existing trace, any fields
in the existing trace and its spans are overwritten by the provided values,
and any new fields provided are merged with the existing trace data. If the
ID does not match, a new trace is created.
[[["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-08-28 UTC."],[],[],null,["# Interface TraceServiceGrpc.AsyncService (2.72.0)\n\nVersion latestkeyboard_arrow_down\n\n- [2.72.0 (latest)](/java/docs/reference/google-cloud-trace/latest/com.google.devtools.cloudtrace.v1.TraceServiceGrpc.AsyncService)\n- [2.70.0](/java/docs/reference/google-cloud-trace/2.70.0/com.google.devtools.cloudtrace.v1.TraceServiceGrpc.AsyncService)\n- [2.68.0](/java/docs/reference/google-cloud-trace/2.68.0/com.google.devtools.cloudtrace.v1.TraceServiceGrpc.AsyncService)\n- [2.67.0](/java/docs/reference/google-cloud-trace/2.67.0/com.google.devtools.cloudtrace.v1.TraceServiceGrpc.AsyncService)\n- [2.64.0](/java/docs/reference/google-cloud-trace/2.64.0/com.google.devtools.cloudtrace.v1.TraceServiceGrpc.AsyncService)\n- [2.63.0](/java/docs/reference/google-cloud-trace/2.63.0/com.google.devtools.cloudtrace.v1.TraceServiceGrpc.AsyncService)\n- [2.62.0](/java/docs/reference/google-cloud-trace/2.62.0/com.google.devtools.cloudtrace.v1.TraceServiceGrpc.AsyncService)\n- [2.60.0](/java/docs/reference/google-cloud-trace/2.60.0/com.google.devtools.cloudtrace.v1.TraceServiceGrpc.AsyncService)\n- [2.59.0](/java/docs/reference/google-cloud-trace/2.59.0/com.google.devtools.cloudtrace.v1.TraceServiceGrpc.AsyncService)\n- [2.58.0](/java/docs/reference/google-cloud-trace/2.58.0/com.google.devtools.cloudtrace.v1.TraceServiceGrpc.AsyncService)\n- [2.57.0](/java/docs/reference/google-cloud-trace/2.57.0/com.google.devtools.cloudtrace.v1.TraceServiceGrpc.AsyncService)\n- [2.56.0](/java/docs/reference/google-cloud-trace/2.56.0/com.google.devtools.cloudtrace.v1.TraceServiceGrpc.AsyncService)\n- [2.55.0](/java/docs/reference/google-cloud-trace/2.55.0/com.google.devtools.cloudtrace.v1.TraceServiceGrpc.AsyncService)\n- [2.54.0](/java/docs/reference/google-cloud-trace/2.54.0/com.google.devtools.cloudtrace.v1.TraceServiceGrpc.AsyncService)\n- [2.53.0](/java/docs/reference/google-cloud-trace/2.53.0/com.google.devtools.cloudtrace.v1.TraceServiceGrpc.AsyncService)\n- [2.52.0](/java/docs/reference/google-cloud-trace/2.52.0/com.google.devtools.cloudtrace.v1.TraceServiceGrpc.AsyncService)\n- [2.51.0](/java/docs/reference/google-cloud-trace/2.51.0/com.google.devtools.cloudtrace.v1.TraceServiceGrpc.AsyncService)\n- [2.49.0](/java/docs/reference/google-cloud-trace/2.49.0/com.google.devtools.cloudtrace.v1.TraceServiceGrpc.AsyncService)\n- [2.48.0](/java/docs/reference/google-cloud-trace/2.48.0/com.google.devtools.cloudtrace.v1.TraceServiceGrpc.AsyncService)\n- [2.47.0](/java/docs/reference/google-cloud-trace/2.47.0/com.google.devtools.cloudtrace.v1.TraceServiceGrpc.AsyncService)\n- [2.46.0](/java/docs/reference/google-cloud-trace/2.46.0/com.google.devtools.cloudtrace.v1.TraceServiceGrpc.AsyncService)\n- [2.45.0](/java/docs/reference/google-cloud-trace/2.45.0/com.google.devtools.cloudtrace.v1.TraceServiceGrpc.AsyncService)\n- [2.44.0](/java/docs/reference/google-cloud-trace/2.44.0/com.google.devtools.cloudtrace.v1.TraceServiceGrpc.AsyncService)\n- [2.43.0](/java/docs/reference/google-cloud-trace/2.43.0/com.google.devtools.cloudtrace.v1.TraceServiceGrpc.AsyncService)\n- [2.42.0](/java/docs/reference/google-cloud-trace/2.42.0/com.google.devtools.cloudtrace.v1.TraceServiceGrpc.AsyncService)\n- [2.41.0](/java/docs/reference/google-cloud-trace/2.41.0/com.google.devtools.cloudtrace.v1.TraceServiceGrpc.AsyncService)\n- [2.40.0](/java/docs/reference/google-cloud-trace/2.40.0/com.google.devtools.cloudtrace.v1.TraceServiceGrpc.AsyncService)\n- [2.39.0](/java/docs/reference/google-cloud-trace/2.39.0/com.google.devtools.cloudtrace.v1.TraceServiceGrpc.AsyncService)\n- [2.37.0](/java/docs/reference/google-cloud-trace/2.37.0/com.google.devtools.cloudtrace.v1.TraceServiceGrpc.AsyncService)\n- [2.36.0](/java/docs/reference/google-cloud-trace/2.36.0/com.google.devtools.cloudtrace.v1.TraceServiceGrpc.AsyncService)\n- [2.35.0](/java/docs/reference/google-cloud-trace/2.35.0/com.google.devtools.cloudtrace.v1.TraceServiceGrpc.AsyncService)\n- [2.34.0](/java/docs/reference/google-cloud-trace/2.34.0/com.google.devtools.cloudtrace.v1.TraceServiceGrpc.AsyncService)\n- [2.33.0](/java/docs/reference/google-cloud-trace/2.33.0/com.google.devtools.cloudtrace.v1.TraceServiceGrpc.AsyncService)\n- [2.32.0](/java/docs/reference/google-cloud-trace/2.32.0/com.google.devtools.cloudtrace.v1.TraceServiceGrpc.AsyncService)\n- [2.31.0](/java/docs/reference/google-cloud-trace/2.31.0/com.google.devtools.cloudtrace.v1.TraceServiceGrpc.AsyncService)\n- [2.30.0](/java/docs/reference/google-cloud-trace/2.30.0/com.google.devtools.cloudtrace.v1.TraceServiceGrpc.AsyncService)\n- [2.29.0](/java/docs/reference/google-cloud-trace/2.29.0/com.google.devtools.cloudtrace.v1.TraceServiceGrpc.AsyncService)\n- [2.28.0](/java/docs/reference/google-cloud-trace/2.28.0/com.google.devtools.cloudtrace.v1.TraceServiceGrpc.AsyncService)\n- [2.27.0](/java/docs/reference/google-cloud-trace/2.27.0/com.google.devtools.cloudtrace.v1.TraceServiceGrpc.AsyncService)\n- [2.24.0](/java/docs/reference/google-cloud-trace/2.24.0/com.google.devtools.cloudtrace.v1.TraceServiceGrpc.AsyncService)\n- [2.23.0](/java/docs/reference/google-cloud-trace/2.23.0/com.google.devtools.cloudtrace.v1.TraceServiceGrpc.AsyncService)\n- [2.22.0](/java/docs/reference/google-cloud-trace/2.22.0/com.google.devtools.cloudtrace.v1.TraceServiceGrpc.AsyncService)\n- [2.21.0](/java/docs/reference/google-cloud-trace/2.21.0/com.google.devtools.cloudtrace.v1.TraceServiceGrpc.AsyncService)\n- [2.20.0](/java/docs/reference/google-cloud-trace/2.20.0/com.google.devtools.cloudtrace.v1.TraceServiceGrpc.AsyncService)\n- [2.19.0](/java/docs/reference/google-cloud-trace/2.19.0/com.google.devtools.cloudtrace.v1.TraceServiceGrpc.AsyncService)\n- [2.18.0](/java/docs/reference/google-cloud-trace/2.18.0/com.google.devtools.cloudtrace.v1.TraceServiceGrpc.AsyncService)\n- [2.17.0](/java/docs/reference/google-cloud-trace/2.17.0/com.google.devtools.cloudtrace.v1.TraceServiceGrpc.AsyncService)\n- [2.16.0](/java/docs/reference/google-cloud-trace/2.16.0/com.google.devtools.cloudtrace.v1.TraceServiceGrpc.AsyncService)\n- [2.15.0](/java/docs/reference/google-cloud-trace/2.15.0/com.google.devtools.cloudtrace.v1.TraceServiceGrpc.AsyncService)\n- [2.14.0](/java/docs/reference/google-cloud-trace/2.14.0/com.google.devtools.cloudtrace.v1.TraceServiceGrpc.AsyncService)\n- [2.13.0](/java/docs/reference/google-cloud-trace/2.13.0/com.google.devtools.cloudtrace.v1.TraceServiceGrpc.AsyncService)\n- [2.12.0](/java/docs/reference/google-cloud-trace/2.12.0/com.google.devtools.cloudtrace.v1.TraceServiceGrpc.AsyncService)\n- [2.11.0](/java/docs/reference/google-cloud-trace/2.11.0/com.google.devtools.cloudtrace.v1.TraceServiceGrpc.AsyncService)\n- [2.9.0](/java/docs/reference/google-cloud-trace/2.9.0/com.google.devtools.cloudtrace.v1.TraceServiceGrpc.AsyncService)\n- [2.8.0](/java/docs/reference/google-cloud-trace/2.8.0/com.google.devtools.cloudtrace.v1.TraceServiceGrpc.AsyncService)\n- [2.7.0](/java/docs/reference/google-cloud-trace/2.7.0/com.google.devtools.cloudtrace.v1.TraceServiceGrpc.AsyncService)\n- [2.6.0](/java/docs/reference/google-cloud-trace/2.6.0/com.google.devtools.cloudtrace.v1.TraceServiceGrpc.AsyncService)\n- [2.5.0](/java/docs/reference/google-cloud-trace/2.5.0/com.google.devtools.cloudtrace.v1.TraceServiceGrpc.AsyncService)\n- [2.4.0](/java/docs/reference/google-cloud-trace/2.4.0/com.google.devtools.cloudtrace.v1.TraceServiceGrpc.AsyncService)\n- [2.3.7](/java/docs/reference/google-cloud-trace/2.3.7/com.google.devtools.cloudtrace.v1.TraceServiceGrpc.AsyncService)\n- [2.2.0](/java/docs/reference/google-cloud-trace/2.2.0/com.google.devtools.cloudtrace.v1.TraceServiceGrpc.AsyncService)\n- [2.1.13](/java/docs/reference/google-cloud-trace/2.1.13/com.google.devtools.cloudtrace.v1.TraceServiceGrpc.AsyncService) \n\n public static interface TraceServiceGrpc.AsyncService\n\nThis file describes an API for collecting and viewing traces and spans\nwithin a trace. A Trace is a collection of spans corresponding to a single\noperation or set of operations for an application. A span is an individual\ntimed event which forms a node of the trace tree. Spans for a single trace\nmay span multiple services.\n\nMethods\n-------\n\n### getTrace(GetTraceRequest request, StreamObserver\\\u003cTrace\\\u003e responseObserver)\n\n public default void getTrace(GetTraceRequest request, StreamObserver\u003cTrace\u003e responseObserver)\n\nGets a single trace by its ID.\n\n### listTraces(ListTracesRequest request, StreamObserver\\\u003cListTracesResponse\\\u003e responseObserver)\n\n public default void listTraces(ListTracesRequest request, StreamObserver\u003cListTracesResponse\u003e responseObserver)\n\nReturns of a list of traces that match the specified filter conditions.\n\n### patchTraces(PatchTracesRequest request, StreamObserver\\\u003cEmpty\\\u003e responseObserver)\n\n public default void patchTraces(PatchTracesRequest request, StreamObserver\u003cEmpty\u003e responseObserver)\n\nSends new traces to Stackdriver Trace or updates existing traces. If the ID\nof a trace that you send matches that of an existing trace, any fields\nin the existing trace and its spans are overwritten by the provided values,\nand any new fields provided are merged with the existing trace data. If the\nID does not match, a new trace is created."]]
