Class TraceServiceClient (1.0.0)

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.

Parameters

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, .TraceServiceTransport]` 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 `transport` instance is provided. (1) The `api_endpoint` property can be used to override the default endpoint provided by the client. GOOGLE_API_USE_MTLS environment variable can also be used to override the endpoint: "always" (always use the default mTLS endpoint), "never" (always use the default regular endpoint, this is the default value for the environment variable) and "auto" (auto switch to the default mTLS endpoint if client SSL credentials is present). However, the `api_endpoint` property takes precedence if provided. (2) The `client_cert_source` property is used to provide client SSL credentials for mutual TLS transport. If not provided, the default SSL credentials will be used if present.
`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 `None`, then default info will be used. Generally, you only need to set this if you're developing your own client library.

Exceptions

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.

Parameter

Name	Description
`filename`	`str` The path to the service account private key json file.

Returns

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.

Parameter

Name	Description
`filename`	`str` The path to the service account private key json file.

Returns

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.

Parameters

Name	Description
`request`	`.trace.GetTraceRequest` The request object. The request message for the `GetTrace` method.
`project_id`	`str` Required. ID of the Cloud project where the trace data is stored. This corresponds to the `project_id` field on the `request` instance; if `request` is provided, this should not be set.
`trace_id`	`str` Required. ID of the trace to return. This corresponds to the `trace_id` field on the `request` instance; if `request` is provided, this should not be set.
`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.

Returns

Type	Description
`.trace.Trace`	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.

Parameters

Name	Description
`request`	`.trace.ListTracesRequest` The request object. The request message for the `ListTraces` method. All fields are required unless specified.
`project_id`	`str` Required. ID of the Cloud project where the trace data is stored. This corresponds to the `project_id` field on the `request` instance; if `request` is provided, this should not be set.
`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.

Returns

Type	Description
`.pagers.ListTracesPager`	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.

Parameters

Name	Description
`request`	`.trace.PatchTracesRequest` The request object. The request message for the `PatchTraces` method.
`project_id`	`str` Required. ID of the Cloud project where the trace data is stored. This corresponds to the `project_id` field on the `request` instance; if `request` is provided, this should not be set.
`traces`	`.trace.Traces` Required. The body of the message. This corresponds to the `traces` field on the `request` instance; if `request` is provided, this should not be set.
`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.