File: tracing_v2.projects.traces.spans.html

package info (click to toggle)
python-googleapi 1.7.11-4
links: PTS
area: main
in suites: bullseye
size: 110,952 kB
sloc: python: 7,784; javascript: 249; makefile: 59; sh: 53; xml: 5
file content (677 lines) | stat: -rw-r--r-- 38,687 bytes
parent folder | download | duplicates (2)
<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>