docs: update docs (#916)
* fix: re-run script
* test: fix noxfile
diff --git a/docs/dyn/cloudtrace_v2.projects.traces.spans.html b/docs/dyn/cloudtrace_v2.projects.traces.spans.html
index fc681bc..445a610 100644
--- a/docs/dyn/cloudtrace_v2.projects.traces.spans.html
+++ b/docs/dyn/cloudtrace_v2.projects.traces.spans.html
@@ -101,36 +101,6 @@
# its sub-operations. A trace can also contain multiple root spans,
# or none at all. Spans do not need to be contiguous—there may be
# gaps or overlaps between spans in a trace.
- "attributes": { # A set of attributes, each in the format `[KEY]:[VALUE]`. # A set of attributes on the span. You can have up to 32 attributes per
- # span.
- "droppedAttributesCount": 42, # The number of attributes that were discarded. Attributes can be discarded
- # because their keys are too long or because there are too many attributes.
- # If this value is 0 then all attributes are valid.
- "attributeMap": { # The set of attributes. Each attribute's key can be up to 128 bytes
- # long. The value can be a string up to 256 bytes, a signed 64-bit integer,
- # or the Boolean values `true` and `false`. For example:
- #
- # "/instance_id": { "string_value": { "value": "my-instance" } }
- # "/http/request_bytes": { "int_value": 300 }
- # "abc.com/myattribute": { "bool_value": false }
- "a_key": { # The allowed types for [VALUE] in a `[KEY]:[VALUE]` attribute.
- "intValue": "A String", # A 64-bit signed integer.
- "stringValue": { # Represents a string that might be shortened to a specified length. # A string up to 256 bytes long.
- "truncatedByteCount": 42, # The number of bytes removed from the original string. If this
- # value is 0, then the string was not shortened.
- "value": "A String", # The shortened string. For example, if the original string is 500
- # bytes long and the limit of the string is 128 bytes, then
- # `value` contains the first 128 bytes of the 500-byte string.
- #
- # Truncation always happens on a UTF8 character boundary. If there
- # are multi-byte characters in the string, then the length of the
- # shortened string might be less than the size limit.
- },
- "boolValue": True or False, # A Boolean value represented by `true` or `false`.
- },
- },
- },
- "spanId": "A String", # Required. The [SPAN_ID] portion of the span's resource name.
"childSpanCount": 42, # Optional. The number of child spans that were generated while this span
# was active. If set, allows implementation to detect missing child spans.
"sameProcessAsParentSpan": True or False, # Optional. Set this parameter to indicate whether this span is in
@@ -144,7 +114,6 @@
#
# You can find out more about this error model and how to work with it in the
# [API Design Guide](https://cloud.google.com/apis/design/errors).
- "code": 42, # The status code, which should be an enum value of google.rpc.Code.
"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.
@@ -154,6 +123,7 @@
"a_key": "", # Properties of the object. Contains field @type with type URL.
},
],
+ "code": 42, # The status code, which should be an enum value of google.rpc.Code.
},
"name": "A String", # The resource name of the span in the following format:
#
@@ -163,19 +133,7 @@
# [SPAN_ID] is a unique identifier for a span within a trace; it
# is a 16-character hexadecimal encoding of an 8-byte array.
"stackTrace": { # A call stack appearing 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": { # A collection of stack frames, which can be truncated. # Stack frames in this stack trace. A maximum of 128 frames are allowed.
- "droppedFramesCount": 42, # The number of stack frames that were dropped because there
- # were too many stack frames.
- # If this value is 0, then no stack frames were dropped.
"frame": [ # Stack frames in this call stack.
{ # Represents a single stack frame in a stack trace.
"lineNumber": "A String", # The line number in `file_name` where the function call appears.
@@ -257,7 +215,19 @@
},
},
],
+ "droppedFramesCount": 42, # The number of stack frames that were dropped because there
+ # were too many stack frames.
+ # If this value is 0, then no stack frames were dropped.
},
+ "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`.
},
"parentSpanId": "A String", # The [SPAN_ID] of this span's parent span. If this is a root span,
# then this field must be empty.
@@ -291,23 +261,10 @@
# events per span.
# on the span, consisting of either user-supplied key:value pairs, or
# details of a message sent/received between Spans.
- "droppedAnnotationsCount": 42, # The number of dropped annotations in all the included time events.
- # If the value is 0, then no annotations were dropped.
"droppedMessageEventsCount": 42, # The number of dropped message events in all the included time events.
# If the value is 0, then no message events were dropped.
"timeEvent": [ # A collection of `TimeEvent`s.
{ # A time-stamped annotation or message event in the Span.
- "messageEvent": { # An event describing a message sent/received between Spans. # An event describing a message sent/received between Spans.
- "type": "A String", # Type of MessageEvent. Indicates whether the message was sent or
- # received.
- "id": "A String", # An identifier for the MessageEvent's message that can be used to match
- # SENT and RECEIVED MessageEvents. It is recommended to be unique within
- # a Span.
- "compressedSizeBytes": "A String", # The number of compressed bytes sent or received. If missing assumed to
- # be the same size as uncompressed.
- "uncompressedSizeBytes": "A String", # The number of uncompressed bytes sent or received.
- },
- "time": "A String", # The timestamp indicating the time the event occurred.
"annotation": { # Text annotation with a set of attributes. # Text annotation with a set of attributes.
"description": { # Represents a string that might be shortened to a specified length. # A user-supplied message describing the event. The maximum length for
# the description is 256 bytes.
@@ -351,8 +308,21 @@
},
},
},
+ "messageEvent": { # An event describing a message sent/received between Spans. # An event describing a message sent/received between Spans.
+ "id": "A String", # An identifier for the MessageEvent's message that can be used to match
+ # SENT and RECEIVED MessageEvents. It is recommended to be unique within
+ # a Span.
+ "compressedSizeBytes": "A String", # The number of compressed bytes sent or received. If missing assumed to
+ # be the same size as uncompressed.
+ "uncompressedSizeBytes": "A String", # The number of uncompressed bytes sent or received.
+ "type": "A String", # Type of MessageEvent. Indicates whether the message was sent or
+ # received.
+ },
+ "time": "A String", # The timestamp indicating the time the event occurred.
},
],
+ "droppedAnnotationsCount": 42, # The number of dropped annotations in all the included time events.
+ # If the value is 0, then no annotations were dropped.
},
"links": { # A collection of links, which are references from this span to a span # Links associated with the span. You can have up to 128 links per Span.
# in the same or different trace.
@@ -398,6 +368,36 @@
"droppedLinksCount": 42, # The number of dropped links after the maximum size was enforced. If
# this value is 0, then no links were dropped.
},
+ "attributes": { # A set of attributes, each in the format `[KEY]:[VALUE]`. # A set of attributes on the span. You can have up to 32 attributes per
+ # span.
+ "droppedAttributesCount": 42, # The number of attributes that were discarded. Attributes can be discarded
+ # because their keys are too long or because there are too many attributes.
+ # If this value is 0 then all attributes are valid.
+ "attributeMap": { # The set of attributes. Each attribute's key can be up to 128 bytes
+ # long. The value can be a string up to 256 bytes, a signed 64-bit integer,
+ # or the Boolean values `true` and `false`. For example:
+ #
+ # "/instance_id": { "string_value": { "value": "my-instance" } }
+ # "/http/request_bytes": { "int_value": 300 }
+ # "abc.com/myattribute": { "bool_value": false }
+ "a_key": { # The allowed types for [VALUE] in a `[KEY]:[VALUE]` attribute.
+ "intValue": "A String", # A 64-bit signed integer.
+ "stringValue": { # Represents a string that might be shortened to a specified length. # A string up to 256 bytes long.
+ "truncatedByteCount": 42, # The number of bytes removed from the original string. If this
+ # value is 0, then the string was not shortened.
+ "value": "A String", # The shortened string. For example, if the original string is 500
+ # bytes long and the limit of the string is 128 bytes, then
+ # `value` contains the first 128 bytes of the 500-byte string.
+ #
+ # Truncation always happens on a UTF8 character boundary. If there
+ # are multi-byte characters in the string, then the length of the
+ # shortened string might be less than the size limit.
+ },
+ "boolValue": True or False, # A Boolean value represented by `true` or `false`.
+ },
+ },
+ },
+ "spanId": "A String", # Required. The [SPAN_ID] portion of the span's resource name.
}
x__xgafv: string, V1 error format.
@@ -414,36 +414,6 @@
# its sub-operations. A trace can also contain multiple root spans,
# or none at all. Spans do not need to be contiguous—there may be
# gaps or overlaps between spans in a trace.
- "attributes": { # A set of attributes, each in the format `[KEY]:[VALUE]`. # A set of attributes on the span. You can have up to 32 attributes per
- # span.
- "droppedAttributesCount": 42, # The number of attributes that were discarded. Attributes can be discarded
- # because their keys are too long or because there are too many attributes.
- # If this value is 0 then all attributes are valid.
- "attributeMap": { # The set of attributes. Each attribute's key can be up to 128 bytes
- # long. The value can be a string up to 256 bytes, a signed 64-bit integer,
- # or the Boolean values `true` and `false`. For example:
- #
- # "/instance_id": { "string_value": { "value": "my-instance" } }
- # "/http/request_bytes": { "int_value": 300 }
- # "abc.com/myattribute": { "bool_value": false }
- "a_key": { # The allowed types for [VALUE] in a `[KEY]:[VALUE]` attribute.
- "intValue": "A String", # A 64-bit signed integer.
- "stringValue": { # Represents a string that might be shortened to a specified length. # A string up to 256 bytes long.
- "truncatedByteCount": 42, # The number of bytes removed from the original string. If this
- # value is 0, then the string was not shortened.
- "value": "A String", # The shortened string. For example, if the original string is 500
- # bytes long and the limit of the string is 128 bytes, then
- # `value` contains the first 128 bytes of the 500-byte string.
- #
- # Truncation always happens on a UTF8 character boundary. If there
- # are multi-byte characters in the string, then the length of the
- # shortened string might be less than the size limit.
- },
- "boolValue": True or False, # A Boolean value represented by `true` or `false`.
- },
- },
- },
- "spanId": "A String", # Required. The [SPAN_ID] portion of the span's resource name.
"childSpanCount": 42, # Optional. The number of child spans that were generated while this span
# was active. If set, allows implementation to detect missing child spans.
"sameProcessAsParentSpan": True or False, # Optional. Set this parameter to indicate whether this span is in
@@ -457,7 +427,6 @@
#
# You can find out more about this error model and how to work with it in the
# [API Design Guide](https://cloud.google.com/apis/design/errors).
- "code": 42, # The status code, which should be an enum value of google.rpc.Code.
"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.
@@ -467,6 +436,7 @@
"a_key": "", # Properties of the object. Contains field @type with type URL.
},
],
+ "code": 42, # The status code, which should be an enum value of google.rpc.Code.
},
"name": "A String", # The resource name of the span in the following format:
#
@@ -476,19 +446,7 @@
# [SPAN_ID] is a unique identifier for a span within a trace; it
# is a 16-character hexadecimal encoding of an 8-byte array.
"stackTrace": { # A call stack appearing 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": { # A collection of stack frames, which can be truncated. # Stack frames in this stack trace. A maximum of 128 frames are allowed.
- "droppedFramesCount": 42, # The number of stack frames that were dropped because there
- # were too many stack frames.
- # If this value is 0, then no stack frames were dropped.
"frame": [ # Stack frames in this call stack.
{ # Represents a single stack frame in a stack trace.
"lineNumber": "A String", # The line number in `file_name` where the function call appears.
@@ -570,7 +528,19 @@
},
},
],
+ "droppedFramesCount": 42, # The number of stack frames that were dropped because there
+ # were too many stack frames.
+ # If this value is 0, then no stack frames were dropped.
},
+ "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`.
},
"parentSpanId": "A String", # The [SPAN_ID] of this span's parent span. If this is a root span,
# then this field must be empty.
@@ -604,23 +574,10 @@
# events per span.
# on the span, consisting of either user-supplied key:value pairs, or
# details of a message sent/received between Spans.
- "droppedAnnotationsCount": 42, # The number of dropped annotations in all the included time events.
- # If the value is 0, then no annotations were dropped.
"droppedMessageEventsCount": 42, # The number of dropped message events in all the included time events.
# If the value is 0, then no message events were dropped.
"timeEvent": [ # A collection of `TimeEvent`s.
{ # A time-stamped annotation or message event in the Span.
- "messageEvent": { # An event describing a message sent/received between Spans. # An event describing a message sent/received between Spans.
- "type": "A String", # Type of MessageEvent. Indicates whether the message was sent or
- # received.
- "id": "A String", # An identifier for the MessageEvent's message that can be used to match
- # SENT and RECEIVED MessageEvents. It is recommended to be unique within
- # a Span.
- "compressedSizeBytes": "A String", # The number of compressed bytes sent or received. If missing assumed to
- # be the same size as uncompressed.
- "uncompressedSizeBytes": "A String", # The number of uncompressed bytes sent or received.
- },
- "time": "A String", # The timestamp indicating the time the event occurred.
"annotation": { # Text annotation with a set of attributes. # Text annotation with a set of attributes.
"description": { # Represents a string that might be shortened to a specified length. # A user-supplied message describing the event. The maximum length for
# the description is 256 bytes.
@@ -664,8 +621,21 @@
},
},
},
+ "messageEvent": { # An event describing a message sent/received between Spans. # An event describing a message sent/received between Spans.
+ "id": "A String", # An identifier for the MessageEvent's message that can be used to match
+ # SENT and RECEIVED MessageEvents. It is recommended to be unique within
+ # a Span.
+ "compressedSizeBytes": "A String", # The number of compressed bytes sent or received. If missing assumed to
+ # be the same size as uncompressed.
+ "uncompressedSizeBytes": "A String", # The number of uncompressed bytes sent or received.
+ "type": "A String", # Type of MessageEvent. Indicates whether the message was sent or
+ # received.
+ },
+ "time": "A String", # The timestamp indicating the time the event occurred.
},
],
+ "droppedAnnotationsCount": 42, # The number of dropped annotations in all the included time events.
+ # If the value is 0, then no annotations were dropped.
},
"links": { # A collection of links, which are references from this span to a span # Links associated with the span. You can have up to 128 links per Span.
# in the same or different trace.
@@ -711,6 +681,36 @@
"droppedLinksCount": 42, # The number of dropped links after the maximum size was enforced. If
# this value is 0, then no links were dropped.
},
+ "attributes": { # A set of attributes, each in the format `[KEY]:[VALUE]`. # A set of attributes on the span. You can have up to 32 attributes per
+ # span.
+ "droppedAttributesCount": 42, # The number of attributes that were discarded. Attributes can be discarded
+ # because their keys are too long or because there are too many attributes.
+ # If this value is 0 then all attributes are valid.
+ "attributeMap": { # The set of attributes. Each attribute's key can be up to 128 bytes
+ # long. The value can be a string up to 256 bytes, a signed 64-bit integer,
+ # or the Boolean values `true` and `false`. For example:
+ #
+ # "/instance_id": { "string_value": { "value": "my-instance" } }
+ # "/http/request_bytes": { "int_value": 300 }
+ # "abc.com/myattribute": { "bool_value": false }
+ "a_key": { # The allowed types for [VALUE] in a `[KEY]:[VALUE]` attribute.
+ "intValue": "A String", # A 64-bit signed integer.
+ "stringValue": { # Represents a string that might be shortened to a specified length. # A string up to 256 bytes long.
+ "truncatedByteCount": 42, # The number of bytes removed from the original string. If this
+ # value is 0, then the string was not shortened.
+ "value": "A String", # The shortened string. For example, if the original string is 500
+ # bytes long and the limit of the string is 128 bytes, then
+ # `value` contains the first 128 bytes of the 500-byte string.
+ #
+ # Truncation always happens on a UTF8 character boundary. If there
+ # are multi-byte characters in the string, then the length of the
+ # shortened string might be less than the size limit.
+ },
+ "boolValue": True or False, # A Boolean value represented by `true` or `false`.
+ },
+ },
+ },
+ "spanId": "A String", # Required. The [SPAN_ID] portion of the span's resource name.
}</pre>
</div>