Struct google_cloudtrace1::TraceSpan

pub struct TraceSpan {
    pub kind: Option<String>,
    pub parent_span_id: Option<String>,
    pub name: Option<String>,
    pub start_time: Option<String>,
    pub span_id: Option<String>,
    pub labels: Option<HashMap<String, String>>,
    pub end_time: Option<String>,
}

A span represents a single timed event within a trace. Spans can be nested and form a trace tree. Often, a trace contains a root span that describes the end-to-end latency of an operation and, optionally, one or more subspans for its suboperations. Spans do not need to be contiguous. There may be gaps between spans in a trace.

This type is not used in any activity, and only used as part of another schema.

Fields

kind: Option<String>

Distinguishes between spans generated in a particular context. For example, two spans with the same name may be distinguished using RPC_CLIENT and RPC_SERVER to identify queueing latency associated with the span.

parent_span_id: Option<String>

ID of the parent span, if any. Optional.

name: Option<String>

Name of the span. Must be less than 128 bytes. The span name is sanitized and displayed in the Stackdriver Trace tool in the {% dynamic print site_values.console_name %}. The name may be a method name or some other per-call site name. For the same executable and the same call point, a best practice is to use a consistent name, which makes it easier to correlate cross-trace spans.

start_time: Option<String>

Start time of the span in nanoseconds from the UNIX epoch.

span_id: Option<String>

Identifier for the span. Must be a 64-bit integer other than 0 and unique within a trace.

labels: Option<HashMap<String, String>>

Collection of labels associated with the span. Label keys must be less than 128 bytes. Label values must be less than 16 kilobytes (10MB for /stacktrace values).

Some predefined label keys exist, or you may create your own. When creating your own, we recommend the following formats:

• /category/product/key for agents of well-known products (e.g. /db/mongodb/read_size).
• short_host/path/key for domain-specific keys (e.g. foo.com/myproduct/bar)

Predefined labels include:

• /agent
• /component
• /error/message
• /error/name
• /http/client_city
• /http/client_country
• /http/client_protocol
• /http/client_region
• /http/host
• /http/method
• /http/redirected_url
• /http/request/size
• /http/response/size
• /http/status_code
• /http/url
• /http/user_agent
• /pid
• /stacktrace
• /tid

end_time: Option<String>

End time of the span in nanoseconds from the UNIX epoch.

Trait Implementations

impl Default for TraceSpan

fn default() -> TraceSpan

Returns the "default value" for a type.

impl Clone for TraceSpan

fn clone(&self) -> TraceSpan

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for TraceSpan

fn fmt(&self, f: &mut Formatter) -> Result

Formats the value using the given formatter.

impl Part for TraceSpan