TraceServiceClient(*, credentials: google.auth.credentials.Credentials = None, transport: Union[str, google.cloud.trace_v1.services.trace_service.transports.base.TraceServiceTransport] = None, client_options: <module 'google.api_core.client_options' from '/workspace/python-trace/.nox/docfx/lib/python3.9/site-packages/google/api_core/client_options.py'> = None, client_info: google.api_core.gapic_v1.client_info.ClientInfo = <google.api_core.gapic_v1.client_info.ClientInfo object>)
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.
Methods
TraceServiceClient
TraceServiceClient(*, credentials: google.auth.credentials.Credentials = None, transport: Union[str, google.cloud.trace_v1.services.trace_service.transports.base.TraceServiceTransport] = None, client_options: <module 'google.api_core.client_options' from '/workspace/python-trace/.nox/docfx/lib/python3.9/site-packages/google/api_core/client_options.py'> = None, client_info: google.api_core.gapic_v1.client_info.ClientInfo = <google.api_core.gapic_v1.client_info.ClientInfo object>)
Instantiate the trace service client.
Name | Description |
credentials |
Optional[google.auth.credentials.Credentials]
The authorization credentials to attach to requests. These credentials identify the application to the service; if none are specified, the client will attempt to ascertain the credentials from the environment. |
transport |
Union[str,
The transport to use. If set to None, a transport is chosen automatically. |
client_options |
ClientOptions
Custom options for the client. It won't take effect if a |
client_info |
google.api_core.gapic_v1.client_info.ClientInfo
The client info used to send a user-agent string along with API requests. If |
Type | Description |
google.auth.exceptions.MutualTLSChannelError | If mutual TLS transport creation failed for any reason. |
from_service_account_file
from_service_account_file(filename: str, *args, **kwargs)
Creates an instance of this client using the provided credentials file.
Name | Description |
filename |
str
The path to the service account private key json file. |
Type | Description |
{@api.name} | The constructed client. |
from_service_account_json
from_service_account_json(filename: str, *args, **kwargs)
Creates an instance of this client using the provided credentials file.
Name | Description |
filename |
str
The path to the service account private key json file. |
Type | Description |
{@api.name} | The constructed client. |
get_trace
get_trace(request: Optional[google.cloud.trace_v1.types.trace.GetTraceRequest] = None, *, project_id: Optional[str] = None, trace_id: Optional[str] = None, retry: google.api_core.retry.Retry = <_MethodDefault._DEFAULT_VALUE: <object object>>, timeout: Optional[float] = None, metadata: Sequence[Tuple[str, str]] = ())
Gets a single trace by its ID.
Name | Description |
request |
The request object. The request message for the |
project_id |
Required. ID of the Cloud project where the trace data is stored. This corresponds to the |
trace_id |
Required. ID of the trace to return. This corresponds to the |
retry |
google.api_core.retry.Retry
Designation of what errors, if any, should be retried. |
timeout |
float
The timeout for this request. |
metadata |
Sequence[Tuple[str, str]]
Strings which should be sent along with the request as metadata. |
Type | Description |
| A trace describes how long it takes for an application to perform an operation. It consists of a set of spans, each of which represent a single timed event within the operation. |
list_traces
list_traces(request: Optional[google.cloud.trace_v1.types.trace.ListTracesRequest] = None, *, project_id: Optional[str] = None, retry: google.api_core.retry.Retry = <_MethodDefault._DEFAULT_VALUE: <object object>>, timeout: Optional[float] = None, metadata: Sequence[Tuple[str, str]] = ())
Returns of a list of traces that match the specified filter conditions.
Name | Description |
request |
The request object. The request message for the |
project_id |
Required. ID of the Cloud project where the trace data is stored. This corresponds to the |
retry |
google.api_core.retry.Retry
Designation of what errors, if any, should be retried. |
timeout |
float
The timeout for this request. |
metadata |
Sequence[Tuple[str, str]]
Strings which should be sent along with the request as metadata. |
Type | Description |
| The response message for the ListTraces method. Iterating over this object will yield results and resolve additional pages automatically. |
patch_traces
patch_traces(request: Optional[google.cloud.trace_v1.types.trace.PatchTracesRequest] = None, *, project_id: Optional[str] = None, traces: Optional[google.cloud.trace_v1.types.trace.Traces] = None, retry: google.api_core.retry.Retry = <_MethodDefault._DEFAULT_VALUE: <object object>>, timeout: Optional[float] = None, metadata: Sequence[Tuple[str, str]] = ())
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.
Name | Description |
request |
The request object. The request message for the |
project_id |
Required. ID of the Cloud project where the trace data is stored. This corresponds to the |
traces |
Required. The body of the message. This corresponds to the |
retry |
google.api_core.retry.Retry
Designation of what errors, if any, should be retried. |
timeout |
float
The timeout for this request. |
metadata |
Sequence[Tuple[str, str]]
Strings which should be sent along with the request as metadata. |