You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
677 lines
38 KiB
677 lines
38 KiB
<html><body>
|
|
<style>
|
|
|
|
body, h1, h2, h3, div, span, p, pre, a {
|
|
margin: 0;
|
|
padding: 0;
|
|
border: 0;
|
|
font-weight: inherit;
|
|
font-style: inherit;
|
|
font-size: 100%;
|
|
font-family: inherit;
|
|
vertical-align: baseline;
|
|
}
|
|
|
|
body {
|
|
font-size: 13px;
|
|
padding: 1em;
|
|
}
|
|
|
|
h1 {
|
|
font-size: 26px;
|
|
margin-bottom: 1em;
|
|
}
|
|
|
|
h2 {
|
|
font-size: 24px;
|
|
margin-bottom: 1em;
|
|
}
|
|
|
|
h3 {
|
|
font-size: 20px;
|
|
margin-bottom: 1em;
|
|
margin-top: 1em;
|
|
}
|
|
|
|
pre, code {
|
|
line-height: 1.5;
|
|
font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
|
|
}
|
|
|
|
pre {
|
|
margin-top: 0.5em;
|
|
}
|
|
|
|
h1, h2, h3, p {
|
|
font-family: Arial, sans serif;
|
|
}
|
|
|
|
h1, h2, h3 {
|
|
border-bottom: solid #CCC 1px;
|
|
}
|
|
|
|
.toc_element {
|
|
margin-top: 0.5em;
|
|
}
|
|
|
|
.firstline {
|
|
margin-left: 2 em;
|
|
}
|
|
|
|
.method {
|
|
margin-top: 1em;
|
|
border: solid 1px #CCC;
|
|
padding: 1em;
|
|
background: #EEE;
|
|
}
|
|
|
|
.details {
|
|
font-weight: bold;
|
|
font-size: 14px;
|
|
}
|
|
|
|
</style>
|
|
|
|
<h1><a href="tracing_v2.html">Google Tracing API</a> . <a href="tracing_v2.projects.html">projects</a> . <a href="tracing_v2.projects.traces.html">traces</a> . <a href="tracing_v2.projects.traces.spans.html">spans</a></h1>
|
|
<h2>Instance Methods</h2>
|
|
<p class="toc_element">
|
|
<code><a href="#create">create(name, body, x__xgafv=None)</a></code></p>
|
|
<p class="firstline">Creates a new Span.</p>
|
|
<h3>Method Details</h3>
|
|
<div class="method">
|
|
<code class="details" id="create">create(name, body, x__xgafv=None)</code>
|
|
<pre>Creates a new Span.
|
|
|
|
Args:
|
|
name: string, The resource name of Span in the format
|
|
`projects/PROJECT_ID/traces/TRACE_ID/spans/SPAN_ID`.
|
|
`TRACE_ID` is a unique identifier for a trace within a project and is a
|
|
base16-encoded, case-insensitive string and is required to be 32 char long.
|
|
`SPAN_ID` is a unique identifier for a span within a trace. It is a
|
|
base 16-encoded, case-insensitive string of a 8-bytes array and is required
|
|
to be 16 char long. (required)
|
|
body: object, The request body. (required)
|
|
The object takes the form of:
|
|
|
|
{ # A span represents a single operation within a trace. Spans can be nested
|
|
# to form a trace tree. Often, a trace contains a root span that
|
|
# describes the end-to-end latency and, optionally, one or more subspans for
|
|
# its sub-operations. (A trace could alternatively contain multiple root spans,
|
|
# or none at all.) Spans do not need to be contiguous. There may be gaps
|
|
# and/or overlaps between spans in a trace.
|
|
"status": { # The `Status` type defines a logical error model that is suitable for different # An optional final status for this span.
|
|
# programming environments, including REST APIs and RPC APIs. It is used by
|
|
# [gRPC](https://github.com/grpc). The error model is designed to be:
|
|
#
|
|
# - Simple to use and understand for most users
|
|
# - Flexible enough to meet unexpected needs
|
|
#
|
|
# # Overview
|
|
#
|
|
# The `Status` message contains three pieces of data: error code, error message,
|
|
# and error details. The error code should be an enum value of
|
|
# google.rpc.Code, but it may accept additional error codes if needed. The
|
|
# error message should be a developer-facing English message that helps
|
|
# developers *understand* and *resolve* the error. If a localized user-facing
|
|
# error message is needed, put the localized message in the error details or
|
|
# localize it in the client. The optional error details may contain arbitrary
|
|
# information about the error. There is a predefined set of error detail types
|
|
# in the package `google.rpc` that can be used for common error conditions.
|
|
#
|
|
# # Language mapping
|
|
#
|
|
# The `Status` message is the logical representation of the error model, but it
|
|
# is not necessarily the actual wire format. When the `Status` message is
|
|
# exposed in different client libraries and different wire protocols, it can be
|
|
# mapped differently. For example, it will likely be mapped to some exceptions
|
|
# in Java, but more likely mapped to some error codes in C.
|
|
#
|
|
# # Other uses
|
|
#
|
|
# The error model and the `Status` message can be used in a variety of
|
|
# environments, either with or without APIs, to provide a
|
|
# consistent developer experience across different environments.
|
|
#
|
|
# Example uses of this error model include:
|
|
#
|
|
# - Partial errors. If a service needs to return partial errors to the client,
|
|
# it may embed the `Status` in the normal response to indicate the partial
|
|
# errors.
|
|
#
|
|
# - Workflow errors. A typical workflow has multiple steps. Each step may
|
|
# have a `Status` message for error reporting.
|
|
#
|
|
# - Batch operations. If a client uses batch request and batch response, the
|
|
# `Status` message should be used directly inside batch response, one for
|
|
# each error sub-response.
|
|
#
|
|
# - Asynchronous operations. If an API call embeds asynchronous operation
|
|
# results in its response, the status of those operations should be
|
|
# represented directly using the `Status` message.
|
|
#
|
|
# - Logging. If some API errors are stored in logs, the message `Status` could
|
|
# be used directly after any stripping needed for security/privacy reasons.
|
|
"message": "A String", # A developer-facing error message, which should be in English. Any
|
|
# user-facing error message should be localized and sent in the
|
|
# google.rpc.Status.details field, or localized by the client.
|
|
"code": 42, # The status code, which should be an enum value of google.rpc.Code.
|
|
"details": [ # A list of messages that carry the error details. There will be a
|
|
# common set of message types for APIs to use.
|
|
{
|
|
"a_key": "", # Properties of the object. Contains field @type with type URL.
|
|
},
|
|
],
|
|
},
|
|
"stackTrace": { # StackTrace collected in a trace. # Stack trace captured at the start of the span.
|
|
"stackTraceHashId": "A String", # The hash ID is used to conserve network bandwidth for duplicate
|
|
# stack traces within a single trace.
|
|
#
|
|
# Often multiple spans will have identical stack traces.
|
|
# The first occurrence of a stack trace should contain both the
|
|
# `stackFrame` content and a value in `stackTraceHashId`.
|
|
#
|
|
# Subsequent spans within the same request can refer
|
|
# to that stack trace by only setting `stackTraceHashId`.
|
|
"stackFrames": { # Represents collection of StackFrames that can be truncated. # Stack frames in this stack trace. A maximum of 128 frames are allowed.
|
|
"frame": [ # Stack frames in this stack trace.
|
|
{ # Represents a single stack frame in a stack trace.
|
|
"columnNumber": "A String", # Column number is important in JavaScript (anonymous functions).
|
|
# May not be available in some languages.
|
|
"functionName": { # Represents a string value that might be truncated. # The fully-qualified name that uniquely identifies this function or
|
|
# method (up to 1024 characters).
|
|
"truncatedCharacterCount": 42, # The number of characters truncated from the original string value. If 0 it
|
|
# means that the string value was not truncated.
|
|
"value": "A String", # The truncated string value. E.g. for a string attribute this may have up to
|
|
# 256 bytes.
|
|
},
|
|
"fileName": { # Represents a string value that might be truncated. # The filename of the file containing this frame (up to 256 characters).
|
|
"truncatedCharacterCount": 42, # The number of characters truncated from the original string value. If 0 it
|
|
# means that the string value was not truncated.
|
|
"value": "A String", # The truncated string value. E.g. for a string attribute this may have up to
|
|
# 256 bytes.
|
|
},
|
|
"originalFunctionName": { # Represents a string value that might be truncated. # Used when the function name is
|
|
# [mangled](http://www.avabodh.com/cxxin/namemangling.html). May be
|
|
# fully-qualified (up to 1024 characters).
|
|
"truncatedCharacterCount": 42, # The number of characters truncated from the original string value. If 0 it
|
|
# means that the string value was not truncated.
|
|
"value": "A String", # The truncated string value. E.g. for a string attribute this may have up to
|
|
# 256 bytes.
|
|
},
|
|
"loadModule": { # Binary module. # Binary module the code is loaded from.
|
|
"buildId": { # Represents a string value that might be truncated. # Build_id is a unique identifier for the module, usually a hash of its
|
|
# contents (up to 128 characters).
|
|
"truncatedCharacterCount": 42, # The number of characters truncated from the original string value. If 0 it
|
|
# means that the string value was not truncated.
|
|
"value": "A String", # The truncated string value. E.g. for a string attribute this may have up to
|
|
# 256 bytes.
|
|
},
|
|
"module": { # Represents a string value that might be truncated. # E.g. main binary, kernel modules, and dynamic libraries
|
|
# such as libc.so, sharedlib.so (up to 256 characters).
|
|
"truncatedCharacterCount": 42, # The number of characters truncated from the original string value. If 0 it
|
|
# means that the string value was not truncated.
|
|
"value": "A String", # The truncated string value. E.g. for a string attribute this may have up to
|
|
# 256 bytes.
|
|
},
|
|
},
|
|
"lineNumber": "A String", # Line number of the frame.
|
|
"sourceVersion": { # Represents a string value that might be truncated. # The version of the deployed source code (up to 128 characters).
|
|
"truncatedCharacterCount": 42, # The number of characters truncated from the original string value. If 0 it
|
|
# means that the string value was not truncated.
|
|
"value": "A String", # The truncated string value. E.g. for a string attribute this may have up to
|
|
# 256 bytes.
|
|
},
|
|
},
|
|
],
|
|
"droppedFramesCount": 42, # The number of dropped stack frames after the maximum size was enforced.
|
|
# If 0 then no frames were dropped.
|
|
},
|
|
},
|
|
"displayName": { # Represents a string value that might be truncated. # Description of the operation in the span. It is sanitized and displayed in
|
|
# the Stackdriver Trace tool in the
|
|
# {% dynamic print site_values.console_name %}.
|
|
# The display_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 operation name, which makes it easier to correlate
|
|
# cross-trace spans.
|
|
# The maximum length for the display_name is 128 bytes.
|
|
"truncatedCharacterCount": 42, # The number of characters truncated from the original string value. If 0 it
|
|
# means that the string value was not truncated.
|
|
"value": "A String", # The truncated string value. E.g. for a string attribute this may have up to
|
|
# 256 bytes.
|
|
},
|
|
"name": "A String", # The resource name of Span in the format
|
|
# `projects/PROJECT_ID/traces/TRACE_ID/spans/SPAN_ID`.
|
|
# `TRACE_ID` is a unique identifier for a trace within a project and is a
|
|
# base16-encoded, case-insensitive string and is required to be 32 char long.
|
|
# `SPAN_ID` is a unique identifier for a span within a trace. It is a
|
|
# base 16-encoded, case-insensitive string of a 8-bytes array and is required
|
|
# to be 16 char long.
|
|
"links": { # A collection of links, which are references from this span to a span # A maximum of 128 links are allowed per Span.
|
|
# in the same or different trace.
|
|
"droppedLinksCount": 42, # The number of dropped links after the maximum size was enforced. If
|
|
# 0 then no links were dropped.
|
|
"link": [ # A collection of links.
|
|
{ # A pointer from this span to another span in a different `Trace` within
|
|
# the same service project or within a different service project. Used
|
|
# (for example) in batching operations, where a single batch handler
|
|
# processes multiple requests from different traces or when receives a
|
|
# request from a different service project.
|
|
"spanId": "A String", # `SPAN_ID` is a unique identifier for a span within a trace. It is a
|
|
# base16-encoded, case-insensitive string of a 8-bytes array and is
|
|
# required to be 16 char long.
|
|
"traceId": "A String", # `TRACE_ID` is a unique identifier for a trace within a project. It is
|
|
# a base16-encoded, case-insensitive string of a 16-bytes array and is
|
|
# required to be 32 char long.
|
|
"type": "A String", # The relationship of the current span relative to the linked span.
|
|
},
|
|
],
|
|
},
|
|
"parentSpanId": "A String", # ID of parent span which is a base 16-encoded, case-insensitive string of
|
|
# a 8-bytes array and is required to be 16 char long. If this is a root span,
|
|
# the value must be empty.
|
|
"startTime": "A String", # Start time of the span.
|
|
# On the client side, this is the local machine clock time at which the span
|
|
# execution was started; on the server
|
|
# side, this is the time at which the server application handler started
|
|
# running.
|
|
"spanId": "A String", # Unique identifier for a span within a trace. It is a base 16-encoded,
|
|
# case-insensitive string of a 8-bytes array and is required.
|
|
"attributes": { # Attributes of a span with a key:value format. # A set of attributes on the span. A maximum of 32 attributes are allowed per
|
|
# Span.
|
|
"droppedAttributesCount": 42, # The number of dropped attributes after the maximum size was enforced. If
|
|
# 0 then no attributes were dropped.
|
|
"attributeMap": { # The maximum key length is 128 bytes (attributes are dropped if the
|
|
# key size is larger than the maximum allowed). The value can be a string
|
|
# (up to 256 bytes), integer, or boolean (true/false). Some common pair
|
|
# examples:
|
|
#
|
|
# "/instance_id": "my-instance"
|
|
# "/zone": "us-central1-a"
|
|
# "/grpc/peer_address": "ip:port" (dns, etc.)
|
|
# "/grpc/deadline": "Duration"
|
|
# "/http/user_agent"
|
|
# "/http/request_bytes": 300
|
|
# "/http/response_bytes": 1200
|
|
# "/http/url": google.com/apis
|
|
# "abc.com/myattribute": true
|
|
"a_key": { # The allowed types for the value side of an attribute key:value pair.
|
|
"stringValue": { # Represents a string value that might be truncated. # A string value (up to 256 bytes).
|
|
"truncatedCharacterCount": 42, # The number of characters truncated from the original string value. If 0 it
|
|
# means that the string value was not truncated.
|
|
"value": "A String", # The truncated string value. E.g. for a string attribute this may have up to
|
|
# 256 bytes.
|
|
},
|
|
"intValue": "A String", # An integer value.
|
|
"boolValue": True or False, # A boolean value.
|
|
},
|
|
},
|
|
},
|
|
"timeEvents": { # A collection of `TimeEvent`s. A `TimeEvent` is a time-stamped annotation # A maximum of 32 annotations and 128 network events are allowed per Span.
|
|
# on the span, consisting of either user-supplied key:value pairs, or
|
|
# details of an RPC message sent/received on the network.
|
|
"timeEvent": [ # A collection of `TimeEvent`s.
|
|
{ # A time-stamped annotation in the Span.
|
|
"networkEvent": { # An event describing an RPC message sent/received on the network. A # An event describing an RPC message sent/received on the network.
|
|
# maximum of 128 network events are allowed per Span.
|
|
"messageSize": "A String", # The number of bytes sent or received.
|
|
"messageId": "A String", # An identifier for the message, which must be unique in this span.
|
|
"type": "A String", # Type of NetworkEvent. Indicates whether the RPC message was sent or
|
|
# received.
|
|
"time": "A String", # If available, this is the kernel time:
|
|
#
|
|
# * For sent messages, this is the time at which the first bit was sent.
|
|
# * For received messages, this is the time at which the last bit was
|
|
# received.
|
|
},
|
|
"annotation": { # Text annotation with a set of attributes. A maximum of 32 annotations are # One or more key:value pairs.
|
|
# allowed per Span.
|
|
"attributes": { # Attributes of a span with a key:value format. # A set of attributes on the annotation. A maximum of 4 attributes are
|
|
# allowed per Annotation.
|
|
"droppedAttributesCount": 42, # The number of dropped attributes after the maximum size was enforced. If
|
|
# 0 then no attributes were dropped.
|
|
"attributeMap": { # The maximum key length is 128 bytes (attributes are dropped if the
|
|
# key size is larger than the maximum allowed). The value can be a string
|
|
# (up to 256 bytes), integer, or boolean (true/false). Some common pair
|
|
# examples:
|
|
#
|
|
# "/instance_id": "my-instance"
|
|
# "/zone": "us-central1-a"
|
|
# "/grpc/peer_address": "ip:port" (dns, etc.)
|
|
# "/grpc/deadline": "Duration"
|
|
# "/http/user_agent"
|
|
# "/http/request_bytes": 300
|
|
# "/http/response_bytes": 1200
|
|
# "/http/url": google.com/apis
|
|
# "abc.com/myattribute": true
|
|
"a_key": { # The allowed types for the value side of an attribute key:value pair.
|
|
"stringValue": { # Represents a string value that might be truncated. # A string value (up to 256 bytes).
|
|
"truncatedCharacterCount": 42, # The number of characters truncated from the original string value. If 0 it
|
|
# means that the string value was not truncated.
|
|
"value": "A String", # The truncated string value. E.g. for a string attribute this may have up to
|
|
# 256 bytes.
|
|
},
|
|
"intValue": "A String", # An integer value.
|
|
"boolValue": True or False, # A boolean value.
|
|
},
|
|
},
|
|
},
|
|
"description": { # Represents a string value that might be truncated. # A user-supplied message describing the event. The maximum length for
|
|
# the description is 256 bytes.
|
|
"truncatedCharacterCount": 42, # The number of characters truncated from the original string value. If 0 it
|
|
# means that the string value was not truncated.
|
|
"value": "A String", # The truncated string value. E.g. for a string attribute this may have up to
|
|
# 256 bytes.
|
|
},
|
|
},
|
|
"time": "A String", # The timestamp indicating the time the event occurred.
|
|
},
|
|
],
|
|
"droppedNetworkEventsCount": 42, # The number of dropped network events after the maximum size was enforced.
|
|
# If 0 then no annotations were dropped.
|
|
"droppedAnnotationsCount": 42, # The number of dropped annotations after the maximum size was enforced. If
|
|
# 0 then no annotations were dropped.
|
|
},
|
|
"endTime": "A String", # End time of the span.
|
|
# On the client side, this is the local machine clock time at which the span
|
|
# execution was ended; on the server
|
|
# side, this is the time at which the server application handler stopped
|
|
# running.
|
|
}
|
|
|
|
x__xgafv: string, V1 error format.
|
|
Allowed values
|
|
1 - v1 error format
|
|
2 - v2 error format
|
|
|
|
Returns:
|
|
An object of the form:
|
|
|
|
{ # A span represents a single operation within a trace. Spans can be nested
|
|
# to form a trace tree. Often, a trace contains a root span that
|
|
# describes the end-to-end latency and, optionally, one or more subspans for
|
|
# its sub-operations. (A trace could alternatively contain multiple root spans,
|
|
# or none at all.) Spans do not need to be contiguous. There may be gaps
|
|
# and/or overlaps between spans in a trace.
|
|
"status": { # The `Status` type defines a logical error model that is suitable for different # An optional final status for this span.
|
|
# programming environments, including REST APIs and RPC APIs. It is used by
|
|
# [gRPC](https://github.com/grpc). The error model is designed to be:
|
|
#
|
|
# - Simple to use and understand for most users
|
|
# - Flexible enough to meet unexpected needs
|
|
#
|
|
# # Overview
|
|
#
|
|
# The `Status` message contains three pieces of data: error code, error message,
|
|
# and error details. The error code should be an enum value of
|
|
# google.rpc.Code, but it may accept additional error codes if needed. The
|
|
# error message should be a developer-facing English message that helps
|
|
# developers *understand* and *resolve* the error. If a localized user-facing
|
|
# error message is needed, put the localized message in the error details or
|
|
# localize it in the client. The optional error details may contain arbitrary
|
|
# information about the error. There is a predefined set of error detail types
|
|
# in the package `google.rpc` that can be used for common error conditions.
|
|
#
|
|
# # Language mapping
|
|
#
|
|
# The `Status` message is the logical representation of the error model, but it
|
|
# is not necessarily the actual wire format. When the `Status` message is
|
|
# exposed in different client libraries and different wire protocols, it can be
|
|
# mapped differently. For example, it will likely be mapped to some exceptions
|
|
# in Java, but more likely mapped to some error codes in C.
|
|
#
|
|
# # Other uses
|
|
#
|
|
# The error model and the `Status` message can be used in a variety of
|
|
# environments, either with or without APIs, to provide a
|
|
# consistent developer experience across different environments.
|
|
#
|
|
# Example uses of this error model include:
|
|
#
|
|
# - Partial errors. If a service needs to return partial errors to the client,
|
|
# it may embed the `Status` in the normal response to indicate the partial
|
|
# errors.
|
|
#
|
|
# - Workflow errors. A typical workflow has multiple steps. Each step may
|
|
# have a `Status` message for error reporting.
|
|
#
|
|
# - Batch operations. If a client uses batch request and batch response, the
|
|
# `Status` message should be used directly inside batch response, one for
|
|
# each error sub-response.
|
|
#
|
|
# - Asynchronous operations. If an API call embeds asynchronous operation
|
|
# results in its response, the status of those operations should be
|
|
# represented directly using the `Status` message.
|
|
#
|
|
# - Logging. If some API errors are stored in logs, the message `Status` could
|
|
# be used directly after any stripping needed for security/privacy reasons.
|
|
"message": "A String", # A developer-facing error message, which should be in English. Any
|
|
# user-facing error message should be localized and sent in the
|
|
# google.rpc.Status.details field, or localized by the client.
|
|
"code": 42, # The status code, which should be an enum value of google.rpc.Code.
|
|
"details": [ # A list of messages that carry the error details. There will be a
|
|
# common set of message types for APIs to use.
|
|
{
|
|
"a_key": "", # Properties of the object. Contains field @type with type URL.
|
|
},
|
|
],
|
|
},
|
|
"stackTrace": { # StackTrace collected in a trace. # Stack trace captured at the start of the span.
|
|
"stackTraceHashId": "A String", # The hash ID is used to conserve network bandwidth for duplicate
|
|
# stack traces within a single trace.
|
|
#
|
|
# Often multiple spans will have identical stack traces.
|
|
# The first occurrence of a stack trace should contain both the
|
|
# `stackFrame` content and a value in `stackTraceHashId`.
|
|
#
|
|
# Subsequent spans within the same request can refer
|
|
# to that stack trace by only setting `stackTraceHashId`.
|
|
"stackFrames": { # Represents collection of StackFrames that can be truncated. # Stack frames in this stack trace. A maximum of 128 frames are allowed.
|
|
"frame": [ # Stack frames in this stack trace.
|
|
{ # Represents a single stack frame in a stack trace.
|
|
"columnNumber": "A String", # Column number is important in JavaScript (anonymous functions).
|
|
# May not be available in some languages.
|
|
"functionName": { # Represents a string value that might be truncated. # The fully-qualified name that uniquely identifies this function or
|
|
# method (up to 1024 characters).
|
|
"truncatedCharacterCount": 42, # The number of characters truncated from the original string value. If 0 it
|
|
# means that the string value was not truncated.
|
|
"value": "A String", # The truncated string value. E.g. for a string attribute this may have up to
|
|
# 256 bytes.
|
|
},
|
|
"fileName": { # Represents a string value that might be truncated. # The filename of the file containing this frame (up to 256 characters).
|
|
"truncatedCharacterCount": 42, # The number of characters truncated from the original string value. If 0 it
|
|
# means that the string value was not truncated.
|
|
"value": "A String", # The truncated string value. E.g. for a string attribute this may have up to
|
|
# 256 bytes.
|
|
},
|
|
"originalFunctionName": { # Represents a string value that might be truncated. # Used when the function name is
|
|
# [mangled](http://www.avabodh.com/cxxin/namemangling.html). May be
|
|
# fully-qualified (up to 1024 characters).
|
|
"truncatedCharacterCount": 42, # The number of characters truncated from the original string value. If 0 it
|
|
# means that the string value was not truncated.
|
|
"value": "A String", # The truncated string value. E.g. for a string attribute this may have up to
|
|
# 256 bytes.
|
|
},
|
|
"loadModule": { # Binary module. # Binary module the code is loaded from.
|
|
"buildId": { # Represents a string value that might be truncated. # Build_id is a unique identifier for the module, usually a hash of its
|
|
# contents (up to 128 characters).
|
|
"truncatedCharacterCount": 42, # The number of characters truncated from the original string value. If 0 it
|
|
# means that the string value was not truncated.
|
|
"value": "A String", # The truncated string value. E.g. for a string attribute this may have up to
|
|
# 256 bytes.
|
|
},
|
|
"module": { # Represents a string value that might be truncated. # E.g. main binary, kernel modules, and dynamic libraries
|
|
# such as libc.so, sharedlib.so (up to 256 characters).
|
|
"truncatedCharacterCount": 42, # The number of characters truncated from the original string value. If 0 it
|
|
# means that the string value was not truncated.
|
|
"value": "A String", # The truncated string value. E.g. for a string attribute this may have up to
|
|
# 256 bytes.
|
|
},
|
|
},
|
|
"lineNumber": "A String", # Line number of the frame.
|
|
"sourceVersion": { # Represents a string value that might be truncated. # The version of the deployed source code (up to 128 characters).
|
|
"truncatedCharacterCount": 42, # The number of characters truncated from the original string value. If 0 it
|
|
# means that the string value was not truncated.
|
|
"value": "A String", # The truncated string value. E.g. for a string attribute this may have up to
|
|
# 256 bytes.
|
|
},
|
|
},
|
|
],
|
|
"droppedFramesCount": 42, # The number of dropped stack frames after the maximum size was enforced.
|
|
# If 0 then no frames were dropped.
|
|
},
|
|
},
|
|
"displayName": { # Represents a string value that might be truncated. # Description of the operation in the span. It is sanitized and displayed in
|
|
# the Stackdriver Trace tool in the
|
|
# {% dynamic print site_values.console_name %}.
|
|
# The display_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 operation name, which makes it easier to correlate
|
|
# cross-trace spans.
|
|
# The maximum length for the display_name is 128 bytes.
|
|
"truncatedCharacterCount": 42, # The number of characters truncated from the original string value. If 0 it
|
|
# means that the string value was not truncated.
|
|
"value": "A String", # The truncated string value. E.g. for a string attribute this may have up to
|
|
# 256 bytes.
|
|
},
|
|
"name": "A String", # The resource name of Span in the format
|
|
# `projects/PROJECT_ID/traces/TRACE_ID/spans/SPAN_ID`.
|
|
# `TRACE_ID` is a unique identifier for a trace within a project and is a
|
|
# base16-encoded, case-insensitive string and is required to be 32 char long.
|
|
# `SPAN_ID` is a unique identifier for a span within a trace. It is a
|
|
# base 16-encoded, case-insensitive string of a 8-bytes array and is required
|
|
# to be 16 char long.
|
|
"links": { # A collection of links, which are references from this span to a span # A maximum of 128 links are allowed per Span.
|
|
# in the same or different trace.
|
|
"droppedLinksCount": 42, # The number of dropped links after the maximum size was enforced. If
|
|
# 0 then no links were dropped.
|
|
"link": [ # A collection of links.
|
|
{ # A pointer from this span to another span in a different `Trace` within
|
|
# the same service project or within a different service project. Used
|
|
# (for example) in batching operations, where a single batch handler
|
|
# processes multiple requests from different traces or when receives a
|
|
# request from a different service project.
|
|
"spanId": "A String", # `SPAN_ID` is a unique identifier for a span within a trace. It is a
|
|
# base16-encoded, case-insensitive string of a 8-bytes array and is
|
|
# required to be 16 char long.
|
|
"traceId": "A String", # `TRACE_ID` is a unique identifier for a trace within a project. It is
|
|
# a base16-encoded, case-insensitive string of a 16-bytes array and is
|
|
# required to be 32 char long.
|
|
"type": "A String", # The relationship of the current span relative to the linked span.
|
|
},
|
|
],
|
|
},
|
|
"parentSpanId": "A String", # ID of parent span which is a base 16-encoded, case-insensitive string of
|
|
# a 8-bytes array and is required to be 16 char long. If this is a root span,
|
|
# the value must be empty.
|
|
"startTime": "A String", # Start time of the span.
|
|
# On the client side, this is the local machine clock time at which the span
|
|
# execution was started; on the server
|
|
# side, this is the time at which the server application handler started
|
|
# running.
|
|
"spanId": "A String", # Unique identifier for a span within a trace. It is a base 16-encoded,
|
|
# case-insensitive string of a 8-bytes array and is required.
|
|
"attributes": { # Attributes of a span with a key:value format. # A set of attributes on the span. A maximum of 32 attributes are allowed per
|
|
# Span.
|
|
"droppedAttributesCount": 42, # The number of dropped attributes after the maximum size was enforced. If
|
|
# 0 then no attributes were dropped.
|
|
"attributeMap": { # The maximum key length is 128 bytes (attributes are dropped if the
|
|
# key size is larger than the maximum allowed). The value can be a string
|
|
# (up to 256 bytes), integer, or boolean (true/false). Some common pair
|
|
# examples:
|
|
#
|
|
# "/instance_id": "my-instance"
|
|
# "/zone": "us-central1-a"
|
|
# "/grpc/peer_address": "ip:port" (dns, etc.)
|
|
# "/grpc/deadline": "Duration"
|
|
# "/http/user_agent"
|
|
# "/http/request_bytes": 300
|
|
# "/http/response_bytes": 1200
|
|
# "/http/url": google.com/apis
|
|
# "abc.com/myattribute": true
|
|
"a_key": { # The allowed types for the value side of an attribute key:value pair.
|
|
"stringValue": { # Represents a string value that might be truncated. # A string value (up to 256 bytes).
|
|
"truncatedCharacterCount": 42, # The number of characters truncated from the original string value. If 0 it
|
|
# means that the string value was not truncated.
|
|
"value": "A String", # The truncated string value. E.g. for a string attribute this may have up to
|
|
# 256 bytes.
|
|
},
|
|
"intValue": "A String", # An integer value.
|
|
"boolValue": True or False, # A boolean value.
|
|
},
|
|
},
|
|
},
|
|
"timeEvents": { # A collection of `TimeEvent`s. A `TimeEvent` is a time-stamped annotation # A maximum of 32 annotations and 128 network events are allowed per Span.
|
|
# on the span, consisting of either user-supplied key:value pairs, or
|
|
# details of an RPC message sent/received on the network.
|
|
"timeEvent": [ # A collection of `TimeEvent`s.
|
|
{ # A time-stamped annotation in the Span.
|
|
"networkEvent": { # An event describing an RPC message sent/received on the network. A # An event describing an RPC message sent/received on the network.
|
|
# maximum of 128 network events are allowed per Span.
|
|
"messageSize": "A String", # The number of bytes sent or received.
|
|
"messageId": "A String", # An identifier for the message, which must be unique in this span.
|
|
"type": "A String", # Type of NetworkEvent. Indicates whether the RPC message was sent or
|
|
# received.
|
|
"time": "A String", # If available, this is the kernel time:
|
|
#
|
|
# * For sent messages, this is the time at which the first bit was sent.
|
|
# * For received messages, this is the time at which the last bit was
|
|
# received.
|
|
},
|
|
"annotation": { # Text annotation with a set of attributes. A maximum of 32 annotations are # One or more key:value pairs.
|
|
# allowed per Span.
|
|
"attributes": { # Attributes of a span with a key:value format. # A set of attributes on the annotation. A maximum of 4 attributes are
|
|
# allowed per Annotation.
|
|
"droppedAttributesCount": 42, # The number of dropped attributes after the maximum size was enforced. If
|
|
# 0 then no attributes were dropped.
|
|
"attributeMap": { # The maximum key length is 128 bytes (attributes are dropped if the
|
|
# key size is larger than the maximum allowed). The value can be a string
|
|
# (up to 256 bytes), integer, or boolean (true/false). Some common pair
|
|
# examples:
|
|
#
|
|
# "/instance_id": "my-instance"
|
|
# "/zone": "us-central1-a"
|
|
# "/grpc/peer_address": "ip:port" (dns, etc.)
|
|
# "/grpc/deadline": "Duration"
|
|
# "/http/user_agent"
|
|
# "/http/request_bytes": 300
|
|
# "/http/response_bytes": 1200
|
|
# "/http/url": google.com/apis
|
|
# "abc.com/myattribute": true
|
|
"a_key": { # The allowed types for the value side of an attribute key:value pair.
|
|
"stringValue": { # Represents a string value that might be truncated. # A string value (up to 256 bytes).
|
|
"truncatedCharacterCount": 42, # The number of characters truncated from the original string value. If 0 it
|
|
# means that the string value was not truncated.
|
|
"value": "A String", # The truncated string value. E.g. for a string attribute this may have up to
|
|
# 256 bytes.
|
|
},
|
|
"intValue": "A String", # An integer value.
|
|
"boolValue": True or False, # A boolean value.
|
|
},
|
|
},
|
|
},
|
|
"description": { # Represents a string value that might be truncated. # A user-supplied message describing the event. The maximum length for
|
|
# the description is 256 bytes.
|
|
"truncatedCharacterCount": 42, # The number of characters truncated from the original string value. If 0 it
|
|
# means that the string value was not truncated.
|
|
"value": "A String", # The truncated string value. E.g. for a string attribute this may have up to
|
|
# 256 bytes.
|
|
},
|
|
},
|
|
"time": "A String", # The timestamp indicating the time the event occurred.
|
|
},
|
|
],
|
|
"droppedNetworkEventsCount": 42, # The number of dropped network events after the maximum size was enforced.
|
|
# If 0 then no annotations were dropped.
|
|
"droppedAnnotationsCount": 42, # The number of dropped annotations after the maximum size was enforced. If
|
|
# 0 then no annotations were dropped.
|
|
},
|
|
"endTime": "A String", # End time of the span.
|
|
# On the client side, this is the local machine clock time at which the span
|
|
# execution was ended; on the server
|
|
# side, this is the time at which the server application handler stopped
|
|
# running.
|
|
}</pre>
|
|
</div>
|
|
|
|
</body></html> |