OLD | NEW |
1 { | 1 { |
2 "auth": { | 2 "auth": { |
3 "oauth2": { | 3 "oauth2": { |
4 "scopes": { | 4 "scopes": { |
5 "https://www.googleapis.com/auth/trace.append": { | |
6 "description": "Write Trace data for a project or applicatio
n" | |
7 }, | |
8 "https://www.googleapis.com/auth/cloud-platform": { | 5 "https://www.googleapis.com/auth/cloud-platform": { |
9 "description": "View and manage your data across Google Clou
d Platform services" | 6 "description": "View and manage your data across Google Clou
d Platform services" |
10 }, | 7 }, |
11 "https://www.googleapis.com/auth/trace.readonly": { | 8 "https://www.googleapis.com/auth/trace.readonly": { |
12 "description": "Read Trace data for a project or application
" | 9 "description": "Read Trace data for a project or application
" |
| 10 }, |
| 11 "https://www.googleapis.com/auth/trace.append": { |
| 12 "description": "Write Trace data for a project or applicatio
n" |
13 } | 13 } |
14 } | 14 } |
15 } | 15 } |
16 }, | 16 }, |
17 "basePath": "", | 17 "basePath": "", |
18 "baseUrl": "https://cloudtrace.googleapis.com/", | 18 "baseUrl": "https://cloudtrace.googleapis.com/", |
19 "batchPath": "batch", | 19 "batchPath": "batch", |
20 "canonicalName": "Cloud Trace", | 20 "canonicalName": "Cloud Trace", |
21 "description": "Send and retrieve trace data from Stackdriver Trace. Data is
generated and available by default for all App Engine applications. Data from o
ther applications can be written to Stackdriver Trace for display, reporting, an
d analysis.\n", | 21 "description": "Send and retrieve trace data from Stackdriver Trace. Data is
generated and available by default for all App Engine applications. Data from o
ther applications can be written to Stackdriver Trace for display, reporting, an
d analysis.\n", |
22 "discoveryVersion": "v1", | 22 "discoveryVersion": "v1", |
23 "documentationLink": "https://cloud.google.com/trace", | 23 "documentationLink": "https://cloud.google.com/trace", |
24 "icons": { | 24 "icons": { |
25 "x16": "http://www.google.com/images/icons/product/search-16.gif", | 25 "x16": "http://www.google.com/images/icons/product/search-16.gif", |
26 "x32": "http://www.google.com/images/icons/product/search-32.gif" | 26 "x32": "http://www.google.com/images/icons/product/search-32.gif" |
27 }, | 27 }, |
28 "id": "cloudtrace:v2", | 28 "id": "cloudtrace:v2", |
29 "kind": "discovery#restDescription", | 29 "kind": "discovery#restDescription", |
30 "name": "cloudtrace", | 30 "name": "cloudtrace", |
31 "ownerDomain": "google.com", | 31 "ownerDomain": "google.com", |
32 "ownerName": "Google", | 32 "ownerName": "Google", |
33 "parameters": { | 33 "parameters": { |
34 "quotaUser": { | |
35 "description": "Available to use for quota purposes for server-side
applications. Can be any arbitrary string assigned to a user, but should not exc
eed 40 characters.", | |
36 "location": "query", | |
37 "type": "string" | |
38 }, | |
39 "pp": { | |
40 "default": "true", | |
41 "description": "Pretty-print response.", | |
42 "location": "query", | |
43 "type": "boolean" | |
44 }, | |
45 "bearer_token": { | |
46 "description": "OAuth bearer token.", | |
47 "location": "query", | |
48 "type": "string" | |
49 }, | |
50 "oauth_token": { | |
51 "description": "OAuth 2.0 token for the current user.", | |
52 "location": "query", | |
53 "type": "string" | |
54 }, | |
55 "upload_protocol": { | 34 "upload_protocol": { |
56 "description": "Upload protocol for media (e.g. \"raw\", \"multipart
\").", | 35 "description": "Upload protocol for media (e.g. \"raw\", \"multipart
\").", |
57 "location": "query", | 36 "location": "query", |
58 "type": "string" | 37 "type": "string" |
59 }, | 38 }, |
60 "prettyPrint": { | 39 "prettyPrint": { |
61 "default": "true", | 40 "default": "true", |
62 "description": "Returns response with indentations and line breaks."
, | 41 "description": "Returns response with indentations and line breaks."
, |
63 "location": "query", | 42 "location": "query", |
64 "type": "boolean" | 43 "type": "boolean" |
65 }, | 44 }, |
| 45 "uploadType": { |
| 46 "description": "Legacy upload protocol for media (e.g. \"media\", \"
multipart\").", |
| 47 "location": "query", |
| 48 "type": "string" |
| 49 }, |
66 "fields": { | 50 "fields": { |
67 "description": "Selector specifying which fields to include in a par
tial response.", | 51 "description": "Selector specifying which fields to include in a par
tial response.", |
68 "location": "query", | 52 "location": "query", |
69 "type": "string" | 53 "type": "string" |
70 }, | 54 }, |
71 "uploadType": { | |
72 "description": "Legacy upload protocol for media (e.g. \"media\", \"
multipart\").", | |
73 "location": "query", | |
74 "type": "string" | |
75 }, | |
76 "$.xgafv": { | 55 "$.xgafv": { |
77 "description": "V1 error format.", | 56 "description": "V1 error format.", |
78 "enum": [ | 57 "enum": [ |
79 "1", | 58 "1", |
80 "2" | 59 "2" |
81 ], | 60 ], |
82 "enumDescriptions": [ | 61 "enumDescriptions": [ |
83 "v1 error format", | 62 "v1 error format", |
84 "v2 error format" | 63 "v2 error format" |
85 ], | 64 ], |
(...skipping 23 matching lines...) Expand all Loading... |
109 }, | 88 }, |
110 "access_token": { | 89 "access_token": { |
111 "description": "OAuth access token.", | 90 "description": "OAuth access token.", |
112 "location": "query", | 91 "location": "query", |
113 "type": "string" | 92 "type": "string" |
114 }, | 93 }, |
115 "key": { | 94 "key": { |
116 "description": "API key. Your API key identifies your project and pr
ovides you with API access, quota, and reports. Required unless you provide an O
Auth 2.0 token.", | 95 "description": "API key. Your API key identifies your project and pr
ovides you with API access, quota, and reports. Required unless you provide an O
Auth 2.0 token.", |
117 "location": "query", | 96 "location": "query", |
118 "type": "string" | 97 "type": "string" |
| 98 }, |
| 99 "quotaUser": { |
| 100 "description": "Available to use for quota purposes for server-side
applications. Can be any arbitrary string assigned to a user, but should not exc
eed 40 characters.", |
| 101 "location": "query", |
| 102 "type": "string" |
| 103 }, |
| 104 "pp": { |
| 105 "default": "true", |
| 106 "description": "Pretty-print response.", |
| 107 "location": "query", |
| 108 "type": "boolean" |
| 109 }, |
| 110 "bearer_token": { |
| 111 "description": "OAuth bearer token.", |
| 112 "location": "query", |
| 113 "type": "string" |
| 114 }, |
| 115 "oauth_token": { |
| 116 "description": "OAuth 2.0 token for the current user.", |
| 117 "location": "query", |
| 118 "type": "string" |
119 } | 119 } |
120 }, | 120 }, |
121 "protocol": "rest", | 121 "protocol": "rest", |
122 "resources": { | 122 "resources": { |
123 "projects": { | 123 "projects": { |
124 "resources": { | 124 "resources": { |
125 "traces": { | 125 "traces": { |
126 "methods": { | 126 "methods": { |
127 "listSpans": { | |
128 "description": "Returns a list of spans within a tra
ce.", | |
129 "httpMethod": "GET", | |
130 "id": "cloudtrace.projects.traces.listSpans", | |
131 "parameterOrder": [ | |
132 "parent" | |
133 ], | |
134 "parameters": { | |
135 "pageToken": { | |
136 "description": "Optional. If present, then r
etrieve the next batch of results from the\npreceding call to this method. `page
_token` must be the value of\n`next_page_token` from the previous response. The
values of other method\nparameters should be identical to those in the previous
call.", | |
137 "location": "query", | |
138 "type": "string" | |
139 }, | |
140 "parent": { | |
141 "description": "Required: The resource name
of the trace containing the spans to list.\nThe format is `projects/PROJECT_ID/t
races/TRACE_ID`.", | |
142 "location": "path", | |
143 "pattern": "^projects/[^/]+/traces/[^/]+$", | |
144 "required": true, | |
145 "type": "string" | |
146 } | |
147 }, | |
148 "path": "v2/{+parent}:listSpans", | |
149 "response": { | |
150 "$ref": "ListSpansResponse" | |
151 }, | |
152 "scopes": [ | |
153 "https://www.googleapis.com/auth/cloud-platform"
, | |
154 "https://www.googleapis.com/auth/trace.readonly" | |
155 ] | |
156 }, | |
157 "list": { | 127 "list": { |
158 "description": "Returns of a list of traces that mat
ch the specified filter conditions.", | 128 "description": "Returns of a list of traces that mat
ch the specified filter conditions.", |
159 "httpMethod": "GET", | 129 "httpMethod": "GET", |
160 "id": "cloudtrace.projects.traces.list", | 130 "id": "cloudtrace.projects.traces.list", |
161 "parameterOrder": [ | 131 "parameterOrder": [ |
162 "parent" | 132 "parent" |
163 ], | 133 ], |
164 "parameters": { | 134 "parameters": { |
165 "parent": { | |
166 "description": "Required. The project where
the trace data is stored. The format\nis `projects/PROJECT_ID`.", | |
167 "location": "path", | |
168 "pattern": "^projects/[^/]+$", | |
169 "required": true, | |
170 "type": "string" | |
171 }, | |
172 "orderBy": { | |
173 "description": "Optional. A single field use
d to sort the returned traces.\nOnly the following field names can be used:\n\n*
`trace_id`: the trace's ID field\n* `name`: the root span's resource name\
n* `duration`: the difference between the root span's start time and end time\
n* `start`: the start time of the root span\n\nSorting is in ascending order
unless `desc` is appended to the sort field name.\nExample: `\"name desc\"`).", | |
174 "location": "query", | |
175 "type": "string" | |
176 }, | |
177 "filter": { | 135 "filter": { |
178 "description": "Opional. Return only traces
that match this\n[trace filter](/trace/docs/trace-filters). Example:\n\n \"la
bel:/http/url root:/_ah/background my_label:17\"", | 136 "description": "Opional. Return only traces
that match this\n[trace filter](/trace/docs/trace-filters). Example:\n\n \"la
bel:/http/url root:/_ah/background my_label:17\"", |
179 "location": "query", | 137 "location": "query", |
180 "type": "string" | 138 "type": "string" |
181 }, | 139 }, |
182 "endTime": { | 140 "endTime": { |
183 "description": "Optional. Do not return trac
es whose start time is later than this time.", | 141 "description": "Optional. Do not return trac
es whose start time is later than this time.", |
184 "format": "google-datetime", | 142 "format": "google-datetime", |
185 "location": "query", | 143 "location": "query", |
186 "type": "string" | 144 "type": "string" |
187 }, | 145 }, |
188 "startTime": { | 146 "startTime": { |
189 "description": "Optional. Do not return trac
es whose end time is earlier than this time.", | 147 "description": "Optional. Do not return trac
es whose end time is earlier than this time.", |
190 "format": "google-datetime", | 148 "format": "google-datetime", |
191 "location": "query", | 149 "location": "query", |
192 "type": "string" | 150 "type": "string" |
193 }, | 151 }, |
194 "pageToken": { | 152 "pageToken": { |
195 "description": "Optional. If present, then r
etrieve the next batch of results from the\npreceding call to this method. `pag
e_token` must be the value of\n`next_page_token` from the previous response. Th
e values of other method\nparameters should be identical to those in the previou
s call.", | 153 "description": "Optional. If present, then r
etrieve the next batch of results from the\npreceding call to this method. `pag
e_token` must be the value of\n`next_page_token` from the previous response. Th
e values of other method\nparameters should be identical to those in the previou
s call.", |
196 "location": "query", | 154 "location": "query", |
197 "type": "string" | 155 "type": "string" |
198 }, | 156 }, |
199 "pageSize": { | 157 "pageSize": { |
200 "description": "Optional. The maximum number
of results to return from this request.\nNon-positive values are ignored. The p
resence of `next_page_token` in the\nresponse indicates that more results might
be available, even if fewer than\nthe maximum number of results is returned by t
his request.", | 158 "description": "Optional. The maximum number
of results to return from this request.\nNon-positive values are ignored. The p
resence of `next_page_token` in the\nresponse indicates that more results might
be available, even if fewer than\nthe maximum number of results is returned by t
his request.", |
201 "format": "int32", | 159 "format": "int32", |
202 "location": "query", | 160 "location": "query", |
203 "type": "integer" | 161 "type": "integer" |
| 162 }, |
| 163 "parent": { |
| 164 "description": "Required. The project where
the trace data is stored. The format\nis `projects/PROJECT_ID`.", |
| 165 "location": "path", |
| 166 "pattern": "^projects/[^/]+$", |
| 167 "required": true, |
| 168 "type": "string" |
| 169 }, |
| 170 "orderBy": { |
| 171 "description": "Optional. A single field use
d to sort the returned traces.\nOnly the following field names can be used:\n\n*
`trace_id`: the trace's ID field\n* `name`: the root span's resource name\
n* `duration`: the difference between the root span's start time and end time\
n* `start`: the start time of the root span\n\nSorting is in ascending order
unless `desc` is appended to the sort field name.\nExample: `\"name desc\"`).", |
| 172 "location": "query", |
| 173 "type": "string" |
204 } | 174 } |
205 }, | 175 }, |
206 "path": "v2/{+parent}/traces", | 176 "path": "v2/{+parent}/traces", |
207 "response": { | 177 "response": { |
208 "$ref": "ListTracesResponse" | 178 "$ref": "ListTracesResponse" |
209 }, | 179 }, |
210 "scopes": [ | 180 "scopes": [ |
211 "https://www.googleapis.com/auth/cloud-platform"
, | 181 "https://www.googleapis.com/auth/cloud-platform"
, |
212 "https://www.googleapis.com/auth/trace.readonly" | 182 "https://www.googleapis.com/auth/trace.readonly" |
213 ] | 183 ] |
(...skipping 18 matching lines...) Expand all Loading... |
232 "request": { | 202 "request": { |
233 "$ref": "BatchWriteSpansRequest" | 203 "$ref": "BatchWriteSpansRequest" |
234 }, | 204 }, |
235 "response": { | 205 "response": { |
236 "$ref": "Empty" | 206 "$ref": "Empty" |
237 }, | 207 }, |
238 "scopes": [ | 208 "scopes": [ |
239 "https://www.googleapis.com/auth/cloud-platform"
, | 209 "https://www.googleapis.com/auth/cloud-platform"
, |
240 "https://www.googleapis.com/auth/trace.append" | 210 "https://www.googleapis.com/auth/trace.append" |
241 ] | 211 ] |
| 212 }, |
| 213 "listSpans": { |
| 214 "description": "Returns a list of spans within a tra
ce.", |
| 215 "httpMethod": "GET", |
| 216 "id": "cloudtrace.projects.traces.listSpans", |
| 217 "parameterOrder": [ |
| 218 "parent" |
| 219 ], |
| 220 "parameters": { |
| 221 "parent": { |
| 222 "description": "Required: The resource name
of the trace containing the spans to list.\nThe format is `projects/PROJECT_ID/t
races/TRACE_ID`.", |
| 223 "location": "path", |
| 224 "pattern": "^projects/[^/]+/traces/[^/]+$", |
| 225 "required": true, |
| 226 "type": "string" |
| 227 }, |
| 228 "pageToken": { |
| 229 "description": "Optional. If present, then r
etrieve the next batch of results from the\npreceding call to this method. `page
_token` must be the value of\n`next_page_token` from the previous response. The
values of other method\nparameters should be identical to those in the previous
call.", |
| 230 "location": "query", |
| 231 "type": "string" |
| 232 } |
| 233 }, |
| 234 "path": "v2/{+parent}:listSpans", |
| 235 "response": { |
| 236 "$ref": "ListSpansResponse" |
| 237 }, |
| 238 "scopes": [ |
| 239 "https://www.googleapis.com/auth/cloud-platform"
, |
| 240 "https://www.googleapis.com/auth/trace.readonly" |
| 241 ] |
242 } | 242 } |
243 }, | 243 }, |
244 "resources": { | 244 "resources": { |
245 "spans": { | 245 "spans": { |
246 "methods": { | 246 "methods": { |
247 "create": { | 247 "create": { |
248 "description": "Creates a new Span.", | 248 "description": "Creates a new Span.", |
249 "httpMethod": "PUT", | 249 "httpMethod": "PUT", |
250 "id": "cloudtrace.projects.traces.spans.crea
te", | 250 "id": "cloudtrace.projects.traces.spans.crea
te", |
251 "parameterOrder": [ | 251 "parameterOrder": [ |
(...skipping 20 matching lines...) Expand all Loading... |
272 "https://www.googleapis.com/auth/trace.a
ppend" | 272 "https://www.googleapis.com/auth/trace.a
ppend" |
273 ] | 273 ] |
274 } | 274 } |
275 } | 275 } |
276 } | 276 } |
277 } | 277 } |
278 } | 278 } |
279 } | 279 } |
280 } | 280 } |
281 }, | 281 }, |
282 "revision": "20170718", | 282 "revision": "20170802", |
283 "rootUrl": "https://cloudtrace.googleapis.com/", | 283 "rootUrl": "https://cloudtrace.googleapis.com/", |
284 "schemas": { | 284 "schemas": { |
| 285 "StackFrame": { |
| 286 "description": "Represents a single stack frame in a stack trace.", |
| 287 "id": "StackFrame", |
| 288 "properties": { |
| 289 "functionName": { |
| 290 "$ref": "TruncatableString", |
| 291 "description": "The fully-qualified name that uniquely ident
ifies the function or\nmethod that is active in this frame (up to 1024 bytes)." |
| 292 }, |
| 293 "lineNumber": { |
| 294 "description": "The line number in `file_name` where the fun
ction call appears.", |
| 295 "format": "int64", |
| 296 "type": "string" |
| 297 }, |
| 298 "loadModule": { |
| 299 "$ref": "Module", |
| 300 "description": "The binary module from where the code was lo
aded." |
| 301 }, |
| 302 "columnNumber": { |
| 303 "description": "The column number where the function call ap
pears, if available.\nThis is important in JavaScript because of its anonymous f
unctions.", |
| 304 "format": "int64", |
| 305 "type": "string" |
| 306 }, |
| 307 "fileName": { |
| 308 "$ref": "TruncatableString", |
| 309 "description": "The name of the source file where the functi
on call appears (up to 256\nbytes)." |
| 310 }, |
| 311 "sourceVersion": { |
| 312 "$ref": "TruncatableString", |
| 313 "description": "The version of the deployed source code (up
to 128 bytes)." |
| 314 }, |
| 315 "originalFunctionName": { |
| 316 "$ref": "TruncatableString", |
| 317 "description": "An un-mangled function name, if `function_na
me` is\n[mangled](http://www.avabodh.com/cxxin/namemangling.html). The name can\
nbe fully-qualified (up to 1024 bytes)." |
| 318 } |
| 319 }, |
| 320 "type": "object" |
| 321 }, |
| 322 "Link": { |
| 323 "description": "A pointer from the current span to another span in t
he same trace or in a\ndifferent trace. For example, this can be used in batchin
g operations,\nwhere a single batch handler processes multiple requests from dif
ferent\ntraces or when the handler receives a request from a different project."
, |
| 324 "id": "Link", |
| 325 "properties": { |
| 326 "type": { |
| 327 "description": "The relationship of the current span relativ
e to the linked span.", |
| 328 "enum": [ |
| 329 "TYPE_UNSPECIFIED", |
| 330 "CHILD_LINKED_SPAN", |
| 331 "PARENT_LINKED_SPAN" |
| 332 ], |
| 333 "enumDescriptions": [ |
| 334 "The relationship of the two spans is unknown.", |
| 335 "The linked span is a child of the current span.", |
| 336 "The linked span is a parent of the current span." |
| 337 ], |
| 338 "type": "string" |
| 339 }, |
| 340 "attributes": { |
| 341 "$ref": "Attributes", |
| 342 "description": "A set of attributes on the link. There is a
limit of 32 attributes per\nlink." |
| 343 }, |
| 344 "traceId": { |
| 345 "description": "`TRACE_ID` identifies a trace within a proje
ct.", |
| 346 "type": "string" |
| 347 }, |
| 348 "spanId": { |
| 349 "description": "`SPAN_ID` identifies a span within a trace."
, |
| 350 "type": "string" |
| 351 } |
| 352 }, |
| 353 "type": "object" |
| 354 }, |
| 355 "Annotation": { |
| 356 "description": "Text annotation with a set of attributes.", |
| 357 "id": "Annotation", |
| 358 "properties": { |
| 359 "attributes": { |
| 360 "$ref": "Attributes", |
| 361 "description": "A set of attributes on the annotation. There
is a limit of 4 attributes\nper Annotation." |
| 362 }, |
| 363 "description": { |
| 364 "$ref": "TruncatableString", |
| 365 "description": "A user-supplied message describing the event
. The maximum length for\nthe description is 256 bytes." |
| 366 } |
| 367 }, |
| 368 "type": "object" |
| 369 }, |
| 370 "StackFrames": { |
| 371 "description": "A collection of stack frames, which can be truncated
.", |
| 372 "id": "StackFrames", |
| 373 "properties": { |
| 374 "droppedFramesCount": { |
| 375 "description": "The number of stack frames that were dropped
because there\nwere too many stack frames.\nIf this value is 0, then no stack f
rames were dropped.", |
| 376 "format": "int32", |
| 377 "type": "integer" |
| 378 }, |
| 379 "frame": { |
| 380 "description": "Stack frames in this call stack.", |
| 381 "items": { |
| 382 "$ref": "StackFrame" |
| 383 }, |
| 384 "type": "array" |
| 385 } |
| 386 }, |
| 387 "type": "object" |
| 388 }, |
| 389 "Trace": { |
| 390 "description": "A trace describes how long it takes for an applicati
on to perform some\noperations. It consists of a set of spans, each representing
\nan operation and including time information and operation details.", |
| 391 "id": "Trace", |
| 392 "properties": { |
| 393 "name": { |
| 394 "description": "The resource name of the trace in the follow
ing format:\n\n projects/[PROJECT_ID]/traces/TRACE_ID is a unique identifier
for a trace within a project.\nThe ID is assigned when the trace is created.", |
| 395 "type": "string" |
| 396 } |
| 397 }, |
| 398 "type": "object" |
| 399 }, |
285 "TimeEvents": { | 400 "TimeEvents": { |
286 "description": "A collection of `TimeEvent`s. A `TimeEvent` is a tim
e-stamped annotation\non the span, consisting of either user-supplied key:value
pairs, or\ndetails of an RPC message sent/received on the network.", | 401 "description": "A collection of `TimeEvent`s. A `TimeEvent` is a tim
e-stamped annotation\non the span, consisting of either user-supplied key:value
pairs, or\ndetails of an RPC message sent/received on the network.", |
287 "id": "TimeEvents", | 402 "id": "TimeEvents", |
288 "properties": { | 403 "properties": { |
| 404 "droppedNetworkEventsCount": { |
| 405 "description": "The number of dropped network events in all
the included time events.\nIf the value is 0, then no network events were droppe
d.", |
| 406 "format": "int32", |
| 407 "type": "integer" |
| 408 }, |
289 "droppedAnnotationsCount": { | 409 "droppedAnnotationsCount": { |
290 "description": "The number of dropped annotations in all the
included time events.\nIf the value is 0, then no annotations were dropped.", | 410 "description": "The number of dropped annotations in all the
included time events.\nIf the value is 0, then no annotations were dropped.", |
291 "format": "int32", | 411 "format": "int32", |
292 "type": "integer" | 412 "type": "integer" |
293 }, | 413 }, |
294 "timeEvent": { | 414 "timeEvent": { |
295 "description": "A collection of `TimeEvent`s.", | 415 "description": "A collection of `TimeEvent`s.", |
296 "items": { | 416 "items": { |
297 "$ref": "TimeEvent" | 417 "$ref": "TimeEvent" |
298 }, | 418 }, |
299 "type": "array" | 419 "type": "array" |
300 }, | |
301 "droppedNetworkEventsCount": { | |
302 "description": "The number of dropped network events in all
the included time events.\nIf the value is 0, then no network events were droppe
d.", | |
303 "format": "int32", | |
304 "type": "integer" | |
305 } | 420 } |
306 }, | 421 }, |
307 "type": "object" | 422 "type": "object" |
308 }, | 423 }, |
309 "Module": { | 424 "Module": { |
310 "description": "Binary module.", | 425 "description": "Binary module.", |
311 "id": "Module", | 426 "id": "Module", |
312 "properties": { | 427 "properties": { |
| 428 "module": { |
| 429 "$ref": "TruncatableString", |
| 430 "description": "For example: main binary, kernel modules, an
d dynamic libraries\nsuch as libc.so, sharedlib.so (up to 256 bytes)." |
| 431 }, |
313 "buildId": { | 432 "buildId": { |
314 "$ref": "TruncatableString", | 433 "$ref": "TruncatableString", |
315 "description": "A unique identifier for the module, usually
a hash of its\ncontents (up to 128 bytes)." | 434 "description": "A unique identifier for the module, usually
a hash of its\ncontents (up to 128 bytes)." |
316 }, | |
317 "module": { | |
318 "$ref": "TruncatableString", | |
319 "description": "For example: main binary, kernel modules, an
d dynamic libraries\nsuch as libc.so, sharedlib.so (up to 256 bytes)." | |
320 } | 435 } |
321 }, | 436 }, |
322 "type": "object" | 437 "type": "object" |
323 }, | 438 }, |
324 "Status": { | 439 "Status": { |
325 "description": "The `Status` type defines a logical error model that
is suitable for different\nprogramming environments, including REST APIs and RP
C APIs. It is used by\n[gRPC](https://github.com/grpc). The error model is desig
ned to be:\n\n- Simple to use and understand for most users\n- Flexible enough t
o meet unexpected needs\n\n# Overview\n\nThe `Status` message contains three pie
ces of data: error code, error message,\nand error details. The error code shoul
d be an enum value of\ngoogle.rpc.Code, but it may accept additional error codes
if needed. The\nerror message should be a developer-facing English message tha
t helps\ndevelopers *understand* and *resolve* the error. If a localized user-fa
cing\nerror message is needed, put the localized message in the error details or
\nlocalize it in the client. The optional error details may contain arbitrary\ni
nformation about the error. There is a predefined set of error detail types\nin
the package `google.rpc` that can be used for common error conditions.\n\n# Lang
uage mapping\n\nThe `Status` message is the logical representation of the error
model, but it\nis not necessarily the actual wire format. When the `Status` mess
age is\nexposed in different client libraries and different wire protocols, it c
an be\nmapped differently. For example, it will likely be mapped to some excepti
ons\nin Java, but more likely mapped to some error codes in C.\n\n# Other uses\n
\nThe error model and the `Status` message can be used in a variety of\nenvironm
ents, either with or without APIs, to provide a\nconsistent developer experience
across different environments.\n\nExample uses of this error model include:\n\n
- Partial errors. If a service needs to return partial errors to the client,\n
it may embed the `Status` in the normal response to indicate the partial\n
errors.\n\n- Workflow errors. A typical workflow has multiple steps. Each step m
ay\n have a `Status` message for error reporting.\n\n- Batch operations. If a
client uses batch request and batch response, the\n `Status` message should
be used directly inside batch response, one for\n each error sub-response.\n\
n- Asynchronous operations. If an API call embeds asynchronous operation\n re
sults in its response, the status of those operations should be\n represented
directly using the `Status` message.\n\n- Logging. If some API errors are store
d in logs, the message `Status` could\n be used directly after any stripping
needed for security/privacy reasons.", | 440 "description": "The `Status` type defines a logical error model that
is suitable for different\nprogramming environments, including REST APIs and RP
C APIs. It is used by\n[gRPC](https://github.com/grpc). The error model is desig
ned to be:\n\n- Simple to use and understand for most users\n- Flexible enough t
o meet unexpected needs\n\n# Overview\n\nThe `Status` message contains three pie
ces of data: error code, error message,\nand error details. The error code shoul
d be an enum value of\ngoogle.rpc.Code, but it may accept additional error codes
if needed. The\nerror message should be a developer-facing English message tha
t helps\ndevelopers *understand* and *resolve* the error. If a localized user-fa
cing\nerror message is needed, put the localized message in the error details or
\nlocalize it in the client. The optional error details may contain arbitrary\ni
nformation about the error. There is a predefined set of error detail types\nin
the package `google.rpc` that can be used for common error conditions.\n\n# Lang
uage mapping\n\nThe `Status` message is the logical representation of the error
model, but it\nis not necessarily the actual wire format. When the `Status` mess
age is\nexposed in different client libraries and different wire protocols, it c
an be\nmapped differently. For example, it will likely be mapped to some excepti
ons\nin Java, but more likely mapped to some error codes in C.\n\n# Other uses\n
\nThe error model and the `Status` message can be used in a variety of\nenvironm
ents, either with or without APIs, to provide a\nconsistent developer experience
across different environments.\n\nExample uses of this error model include:\n\n
- Partial errors. If a service needs to return partial errors to the client,\n
it may embed the `Status` in the normal response to indicate the partial\n
errors.\n\n- Workflow errors. A typical workflow has multiple steps. Each step m
ay\n have a `Status` message for error reporting.\n\n- Batch operations. If a
client uses batch request and batch response, the\n `Status` message should
be used directly inside batch response, one for\n each error sub-response.\n\
n- Asynchronous operations. If an API call embeds asynchronous operation\n re
sults in its response, the status of those operations should be\n represented
directly using the `Status` message.\n\n- Logging. If some API errors are store
d in logs, the message `Status` could\n be used directly after any stripping
needed for security/privacy reasons.", |
326 "id": "Status", | 441 "id": "Status", |
327 "properties": { | 442 "properties": { |
328 "message": { | |
329 "description": "A developer-facing error message, which shou
ld be in English. Any\nuser-facing error message should be localized and sent in
the\ngoogle.rpc.Status.details field, or localized by the client.", | |
330 "type": "string" | |
331 }, | |
332 "details": { | 443 "details": { |
333 "description": "A list of messages that carry the error deta
ils. There is a common set of\nmessage types for APIs to use.", | 444 "description": "A list of messages that carry the error deta
ils. There is a common set of\nmessage types for APIs to use.", |
334 "items": { | 445 "items": { |
335 "additionalProperties": { | 446 "additionalProperties": { |
336 "description": "Properties of the object. Contains f
ield @type with type URL.", | 447 "description": "Properties of the object. Contains f
ield @type with type URL.", |
337 "type": "any" | 448 "type": "any" |
338 }, | 449 }, |
339 "type": "object" | 450 "type": "object" |
340 }, | 451 }, |
341 "type": "array" | 452 "type": "array" |
342 }, | 453 }, |
343 "code": { | 454 "code": { |
344 "description": "The status code, which should be an enum val
ue of google.rpc.Code.", | 455 "description": "The status code, which should be an enum val
ue of google.rpc.Code.", |
345 "format": "int32", | 456 "format": "int32", |
346 "type": "integer" | 457 "type": "integer" |
| 458 }, |
| 459 "message": { |
| 460 "description": "A developer-facing error message, which shou
ld be in English. Any\nuser-facing error message should be localized and sent in
the\ngoogle.rpc.Status.details field, or localized by the client.", |
| 461 "type": "string" |
347 } | 462 } |
348 }, | 463 }, |
349 "type": "object" | 464 "type": "object" |
350 }, | 465 }, |
351 "BatchWriteSpansRequest": { | 466 "BatchWriteSpansRequest": { |
352 "description": "The request message for the `BatchWriteSpans` method
.", | 467 "description": "The request message for the `BatchWriteSpans` method
.", |
353 "id": "BatchWriteSpansRequest", | 468 "id": "BatchWriteSpansRequest", |
354 "properties": { | 469 "properties": { |
355 "spans": { | 470 "spans": { |
356 "description": "A collection of spans.", | 471 "description": "A collection of spans.", |
357 "items": { | 472 "items": { |
358 "$ref": "Span" | 473 "$ref": "Span" |
359 }, | 474 }, |
360 "type": "array" | 475 "type": "array" |
361 } | 476 } |
362 }, | 477 }, |
363 "type": "object" | 478 "type": "object" |
364 }, | 479 }, |
| 480 "Empty": { |
| 481 "description": "A generic empty message that you can re-use to avoid
defining duplicated\nempty messages in your APIs. A typical example is to use i
t as the request\nor the response type of an API method. For instance:\n\n se
rvice Foo {\n rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty
);\n }\n\nThe JSON representation for `Empty` is empty JSON object `{}`.", |
| 482 "id": "Empty", |
| 483 "properties": {}, |
| 484 "type": "object" |
| 485 }, |
365 "ListTracesResponse": { | 486 "ListTracesResponse": { |
366 "description": "The response message for the `ListTraces` method.", | 487 "description": "The response message for the `ListTraces` method.", |
367 "id": "ListTracesResponse", | 488 "id": "ListTracesResponse", |
368 "properties": { | 489 "properties": { |
369 "nextPageToken": { | 490 "nextPageToken": { |
370 "description": "If there might be more results than those ap
pearing in this response, then\n`next_page_token` is included. To get the next
set of results, call this\nmethod again using the value of `next_page_token` as
`page_token`.", | 491 "description": "If there might be more results than those ap
pearing in this response, then\n`next_page_token` is included. To get the next
set of results, call this\nmethod again using the value of `next_page_token` as
`page_token`.", |
371 "type": "string" | 492 "type": "string" |
372 }, | 493 }, |
373 "traces": { | 494 "traces": { |
374 "description": "List of trace records returned.", | 495 "description": "List of trace records returned.", |
375 "items": { | 496 "items": { |
376 "$ref": "Trace" | 497 "$ref": "Trace" |
377 }, | 498 }, |
378 "type": "array" | 499 "type": "array" |
379 } | 500 } |
380 }, | 501 }, |
381 "type": "object" | 502 "type": "object" |
382 }, | 503 }, |
383 "Span": { | 504 "Span": { |
384 "description": "A span represents a single operation within a trace.
Spans can be\nnested to form a trace tree. Often, a trace contains a root span\
nthat describes the end-to-end latency, and one or more subspans for\nits sub-op
erations. A trace can also contain multiple root spans,\nor none at all. Spans d
o not need to be contiguous—there may be\ngaps or overlaps between spans i
n a trace.", | 505 "description": "A span represents a single operation within a trace.
Spans can be\nnested to form a trace tree. Often, a trace contains a root span\
nthat describes the end-to-end latency, and one or more subspans for\nits sub-op
erations. A trace can also contain multiple root spans,\nor none at all. Spans d
o not need to be contiguous—there may be\ngaps or overlaps between spans i
n a trace.", |
385 "id": "Span", | 506 "id": "Span", |
386 "properties": { | 507 "properties": { |
387 "childSpanCount": { | |
388 "description": "An optional number of child spans that were
generated while this span\nwas active. If set, allows implementation to detect m
issing child spans.", | |
389 "format": "uint32", | |
390 "type": "integer" | |
391 }, | |
392 "sameProcessAsParentSpan": { | 508 "sameProcessAsParentSpan": { |
393 "description": "A highly recommended but not required flag t
hat identifies when a trace\ncrosses a process boundary. True when the parent_sp
an belongs to the\nsame process as the current span.", | 509 "description": "A highly recommended but not required flag t
hat identifies when a trace\ncrosses a process boundary. True when the parent_sp
an belongs to the\nsame process as the current span.", |
394 "type": "boolean" | 510 "type": "boolean" |
395 }, | 511 }, |
396 "status": { | 512 "status": { |
397 "$ref": "Status", | 513 "$ref": "Status", |
398 "description": "An optional final status for this span." | 514 "description": "An optional final status for this span." |
399 }, | 515 }, |
400 "name": { | 516 "name": { |
401 "description": "The resource name of the span in the followi
ng format:\n\n projects/[PROJECT_ID]traces/[TRACE_ID]/spans/SPAN_ID is a uniq
ue identifier for a trace within a project.\n[SPAN_ID] is a unique identifier fo
r a span within a trace,\nassigned when the span is created.", | 517 "description": "The resource name of the span in the followi
ng format:\n\n projects/[PROJECT_ID]traces/[TRACE_ID]/spans/SPAN_ID is a uniq
ue identifier for a trace within a project.\n[SPAN_ID] is a unique identifier fo
r a span within a trace,\nassigned when the span is created.", |
(...skipping 29 matching lines...) Expand all Loading... |
431 "$ref": "Links", | 547 "$ref": "Links", |
432 "description": "A maximum of 128 links are allowed per Span.
" | 548 "description": "A maximum of 128 links are allowed per Span.
" |
433 }, | 549 }, |
434 "attributes": { | 550 "attributes": { |
435 "$ref": "Attributes", | 551 "$ref": "Attributes", |
436 "description": "A set of attributes on the span. There is a
limit of 32 attributes per\nspan." | 552 "description": "A set of attributes on the span. There is a
limit of 32 attributes per\nspan." |
437 }, | 553 }, |
438 "spanId": { | 554 "spanId": { |
439 "description": "The [SPAN_ID] portion of the span's resource
name.", | 555 "description": "The [SPAN_ID] portion of the span's resource
name.", |
440 "type": "string" | 556 "type": "string" |
| 557 }, |
| 558 "childSpanCount": { |
| 559 "description": "An optional number of child spans that were
generated while this span\nwas active. If set, allows implementation to detect m
issing child spans.", |
| 560 "format": "uint32", |
| 561 "type": "integer" |
441 } | 562 } |
442 }, | 563 }, |
443 "type": "object" | 564 "type": "object" |
444 }, | 565 }, |
445 "Empty": { | |
446 "description": "A generic empty message that you can re-use to avoid
defining duplicated\nempty messages in your APIs. A typical example is to use i
t as the request\nor the response type of an API method. For instance:\n\n se
rvice Foo {\n rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty
);\n }\n\nThe JSON representation for `Empty` is empty JSON object `{}`.", | |
447 "id": "Empty", | |
448 "properties": {}, | |
449 "type": "object" | |
450 }, | |
451 "AttributeValue": { | 566 "AttributeValue": { |
452 "description": "The allowed types for [VALUE] in a `[KEY]:[VALUE]` a
ttribute.", | 567 "description": "The allowed types for [VALUE] in a `[KEY]:[VALUE]` a
ttribute.", |
453 "id": "AttributeValue", | 568 "id": "AttributeValue", |
454 "properties": { | 569 "properties": { |
455 "intValue": { | 570 "intValue": { |
456 "description": "A 64-bit signed integer.", | 571 "description": "A 64-bit signed integer.", |
457 "format": "int64", | 572 "format": "int64", |
458 "type": "string" | 573 "type": "string" |
459 }, | 574 }, |
460 "boolValue": { | 575 "boolValue": { |
461 "description": "A Boolean value represented by `true` or `fa
lse`.", | 576 "description": "A Boolean value represented by `true` or `fa
lse`.", |
462 "type": "boolean" | 577 "type": "boolean" |
463 }, | 578 }, |
464 "stringValue": { | 579 "stringValue": { |
465 "$ref": "TruncatableString", | 580 "$ref": "TruncatableString", |
466 "description": "A string up to 256 bytes long." | 581 "description": "A string up to 256 bytes long." |
467 } | 582 } |
468 }, | 583 }, |
469 "type": "object" | 584 "type": "object" |
470 }, | 585 }, |
471 "Attributes": { | 586 "Attributes": { |
472 "description": "A set of attributes, each in the format `[KEY]:[VALU
E]`.", | 587 "description": "A set of attributes, each in the format `[KEY]:[VALU
E]`.", |
473 "id": "Attributes", | 588 "id": "Attributes", |
474 "properties": { | 589 "properties": { |
475 "droppedAttributesCount": { | |
476 "description": "The number of attributes that were discarded
. Attributes can be discarded\nbecause their keys are too long or because there
are too many attributes.\nIf this value is 0 then all attributes are valid.", | |
477 "format": "int32", | |
478 "type": "integer" | |
479 }, | |
480 "attributeMap": { | 590 "attributeMap": { |
481 "additionalProperties": { | 591 "additionalProperties": { |
482 "$ref": "AttributeValue" | 592 "$ref": "AttributeValue" |
483 }, | 593 }, |
484 "description": "The set of attributes. Each attribute's key
can be up to 128 bytes\nlong. The value can be a string up to 256 bytes, an inte
ger, or the\nBoolean values `true` and `false`. For example:\n\n \"/instance_
id\": \"my-instance\"\n \"/http/user_agent\": \"\"\n \"/http/request_bytes
\": 300\n \"abc.com/myattribute\": true", | 594 "description": "The set of attributes. Each attribute's key
can be up to 128 bytes\nlong. The value can be a string up to 256 bytes, an inte
ger, or the\nBoolean values `true` and `false`. For example:\n\n \"/instance_
id\": \"my-instance\"\n \"/http/user_agent\": \"\"\n \"/http/request_bytes
\": 300\n \"abc.com/myattribute\": true", |
485 "type": "object" | 595 "type": "object" |
| 596 }, |
| 597 "droppedAttributesCount": { |
| 598 "description": "The number of attributes that were discarded
. Attributes can be discarded\nbecause their keys are too long or because there
are too many attributes.\nIf this value is 0 then all attributes are valid.", |
| 599 "format": "int32", |
| 600 "type": "integer" |
486 } | 601 } |
487 }, | 602 }, |
488 "type": "object" | 603 "type": "object" |
489 }, | 604 }, |
490 "Links": { | 605 "Links": { |
491 "description": "A collection of links, which are references from thi
s span to a span\nin the same or different trace.", | 606 "description": "A collection of links, which are references from thi
s span to a span\nin the same or different trace.", |
492 "id": "Links", | 607 "id": "Links", |
493 "properties": { | 608 "properties": { |
494 "droppedLinksCount": { | |
495 "description": "The number of dropped links after the maximu
m size was enforced. If\nthis value is 0, then no links were dropped.", | |
496 "format": "int32", | |
497 "type": "integer" | |
498 }, | |
499 "link": { | 609 "link": { |
500 "description": "A collection of links.", | 610 "description": "A collection of links.", |
501 "items": { | 611 "items": { |
502 "$ref": "Link" | 612 "$ref": "Link" |
503 }, | 613 }, |
504 "type": "array" | 614 "type": "array" |
| 615 }, |
| 616 "droppedLinksCount": { |
| 617 "description": "The number of dropped links after the maximu
m size was enforced. If\nthis value is 0, then no links were dropped.", |
| 618 "format": "int32", |
| 619 "type": "integer" |
505 } | 620 } |
506 }, | 621 }, |
507 "type": "object" | 622 "type": "object" |
508 }, | |
509 "TruncatableString": { | |
510 "description": "Represents a string that might be shortened to a spe
cified length.", | |
511 "id": "TruncatableString", | |
512 "properties": { | |
513 "truncatedByteCount": { | |
514 "description": "The number of bytes removed from the origina
l string. If this\nvalue is 0, then the string was not shortened.", | |
515 "format": "int32", | |
516 "type": "integer" | |
517 }, | |
518 "value": { | |
519 "description": "The shortened string. For example, if the or
iginal string was 500\nbytes long and the limit of the string was 128 bytes, the
n this\nvalue contains the first 128 bytes of the 500-byte string. Note that\ntr
uncation always happens on the character boundary, to ensure that\ntruncated str
ing is still valid UTF8. In case of multi-byte characters,\nsize of truncated st
ring can be less than truncation limit.", | |
520 "type": "string" | |
521 } | |
522 }, | |
523 "type": "object" | |
524 }, | 623 }, |
525 "StackTrace": { | 624 "StackTrace": { |
526 "description": "A call stack appearing in a trace.", | 625 "description": "A call stack appearing in a trace.", |
527 "id": "StackTrace", | 626 "id": "StackTrace", |
528 "properties": { | 627 "properties": { |
529 "stackFrames": { | 628 "stackFrames": { |
530 "$ref": "StackFrames", | 629 "$ref": "StackFrames", |
531 "description": "Stack frames in this stack trace. A maximum
of 128 frames are allowed." | 630 "description": "Stack frames in this stack trace. A maximum
of 128 frames are allowed." |
532 }, | 631 }, |
533 "stackTraceHashId": { | 632 "stackTraceHashId": { |
534 "description": "The hash ID is used to conserve network band
width for duplicate\nstack traces within a single trace.\n\nOften multiple spans
will have identical stack traces.\nThe first occurrence of a stack trace should
contain both the\n`stackFrame` content and a value in `stackTraceHashId`.\n\nSu
bsequent spans within the same request can refer\nto that stack trace by only se
tting `stackTraceHashId`.", | 633 "description": "The hash ID is used to conserve network band
width for duplicate\nstack traces within a single trace.\n\nOften multiple spans
will have identical stack traces.\nThe first occurrence of a stack trace should
contain both the\n`stackFrame` content and a value in `stackTraceHashId`.\n\nSu
bsequent spans within the same request can refer\nto that stack trace by only se
tting `stackTraceHashId`.", |
535 "format": "uint64", | 634 "format": "uint64", |
536 "type": "string" | 635 "type": "string" |
537 } | 636 } |
538 }, | 637 }, |
539 "type": "object" | 638 "type": "object" |
540 }, | 639 }, |
| 640 "TruncatableString": { |
| 641 "description": "Represents a string that might be shortened to a spe
cified length.", |
| 642 "id": "TruncatableString", |
| 643 "properties": { |
| 644 "value": { |
| 645 "description": "The shortened string. For example, if the or
iginal string was 500\nbytes long and the limit of the string was 128 bytes, the
n this\nvalue contains the first 128 bytes of the 500-byte string. Note that\ntr
uncation always happens on the character boundary, to ensure that\ntruncated str
ing is still valid UTF8. In case of multi-byte characters,\nsize of truncated st
ring can be less than truncation limit.", |
| 646 "type": "string" |
| 647 }, |
| 648 "truncatedByteCount": { |
| 649 "description": "The number of bytes removed from the origina
l string. If this\nvalue is 0, then the string was not shortened.", |
| 650 "format": "int32", |
| 651 "type": "integer" |
| 652 } |
| 653 }, |
| 654 "type": "object" |
| 655 }, |
541 "TimeEvent": { | 656 "TimeEvent": { |
542 "description": "A time-stamped annotation or network event in the Sp
an.", | 657 "description": "A time-stamped annotation or network event in the Sp
an.", |
543 "id": "TimeEvent", | 658 "id": "TimeEvent", |
544 "properties": { | 659 "properties": { |
| 660 "time": { |
| 661 "description": "The timestamp indicating the time the event
occurred.", |
| 662 "format": "google-datetime", |
| 663 "type": "string" |
| 664 }, |
545 "networkEvent": { | 665 "networkEvent": { |
546 "$ref": "NetworkEvent", | 666 "$ref": "NetworkEvent", |
547 "description": "An event describing an RPC message sent/rece
ived on the network." | 667 "description": "An event describing an RPC message sent/rece
ived on the network." |
548 }, | 668 }, |
549 "annotation": { | 669 "annotation": { |
550 "$ref": "Annotation", | 670 "$ref": "Annotation", |
551 "description": "One or more key:value pairs." | 671 "description": "One or more key:value pairs." |
552 }, | |
553 "time": { | |
554 "description": "The timestamp indicating the time the event
occurred.", | |
555 "format": "google-datetime", | |
556 "type": "string" | |
557 } | 672 } |
558 }, | 673 }, |
559 "type": "object" | 674 "type": "object" |
560 }, | 675 }, |
561 "NetworkEvent": { | 676 "NetworkEvent": { |
562 "description": "An event describing an RPC message sent or received
on the network.", | 677 "description": "An event describing an RPC message sent or received
on the network.", |
563 "id": "NetworkEvent", | 678 "id": "NetworkEvent", |
564 "properties": { | 679 "properties": { |
565 "messageSize": { | |
566 "description": "The number of bytes sent or received.", | |
567 "format": "uint64", | |
568 "type": "string" | |
569 }, | |
570 "time": { | 680 "time": { |
571 "description": "For sent messages, this is the time at which
the first bit was sent.\nFor received messages, this is the time at which the l
ast bit was\nreceived.", | 681 "description": "For sent messages, this is the time at which
the first bit was sent.\nFor received messages, this is the time at which the l
ast bit was\nreceived.", |
572 "format": "google-datetime", | 682 "format": "google-datetime", |
573 "type": "string" | 683 "type": "string" |
574 }, | 684 }, |
575 "type": { | 685 "type": { |
576 "description": "Type of NetworkEvent. Indicates whether the
RPC message was sent or\nreceived.", | 686 "description": "Type of NetworkEvent. Indicates whether the
RPC message was sent or\nreceived.", |
577 "enum": [ | 687 "enum": [ |
578 "TYPE_UNSPECIFIED", | 688 "TYPE_UNSPECIFIED", |
579 "SENT", | 689 "SENT", |
580 "RECV" | 690 "RECV" |
581 ], | 691 ], |
582 "enumDescriptions": [ | 692 "enumDescriptions": [ |
583 "Unknown event type.", | 693 "Unknown event type.", |
584 "Indicates a sent RPC message.", | 694 "Indicates a sent RPC message.", |
585 "Indicates a received RPC message." | 695 "Indicates a received RPC message." |
586 ], | 696 ], |
587 "type": "string" | 697 "type": "string" |
588 }, | 698 }, |
589 "messageId": { | 699 "messageId": { |
590 "description": "An identifier for the message, which must be
unique in this span.", | 700 "description": "An identifier for the message, which must be
unique in this span.", |
591 "format": "uint64", | 701 "format": "uint64", |
592 "type": "string" | 702 "type": "string" |
| 703 }, |
| 704 "messageSize": { |
| 705 "description": "The number of bytes sent or received.", |
| 706 "format": "uint64", |
| 707 "type": "string" |
593 } | 708 } |
594 }, | 709 }, |
595 "type": "object" | 710 "type": "object" |
596 }, | 711 }, |
597 "ListSpansResponse": { | 712 "ListSpansResponse": { |
598 "description": "The response message for the `ListSpans` method.", | 713 "description": "The response message for the `ListSpans` method.", |
599 "id": "ListSpansResponse", | 714 "id": "ListSpansResponse", |
600 "properties": { | 715 "properties": { |
601 "nextPageToken": { | 716 "nextPageToken": { |
602 "description": "If defined, indicates that there might be mo
re spans that match the\nrequest. Pass this as the value of `pageToken` in a sub
sequent request to\nretrieve additional spans.", | 717 "description": "If defined, indicates that there might be mo
re spans that match the\nrequest. Pass this as the value of `pageToken` in a sub
sequent request to\nretrieve additional spans.", |
603 "type": "string" | 718 "type": "string" |
604 }, | 719 }, |
605 "spans": { | 720 "spans": { |
606 "description": "The requested spans, if there are any in the
specified trace.", | 721 "description": "The requested spans, if there are any in the
specified trace.", |
607 "items": { | 722 "items": { |
608 "$ref": "Span" | 723 "$ref": "Span" |
609 }, | 724 }, |
610 "type": "array" | 725 "type": "array" |
611 } | 726 } |
612 }, | 727 }, |
613 "type": "object" | 728 "type": "object" |
614 }, | |
615 "StackFrame": { | |
616 "description": "Represents a single stack frame in a stack trace.", | |
617 "id": "StackFrame", | |
618 "properties": { | |
619 "functionName": { | |
620 "$ref": "TruncatableString", | |
621 "description": "The fully-qualified name that uniquely ident
ifies the function or\nmethod that is active in this frame (up to 1024 bytes)." | |
622 }, | |
623 "lineNumber": { | |
624 "description": "The line number in `file_name` where the fun
ction call appears.", | |
625 "format": "int64", | |
626 "type": "string" | |
627 }, | |
628 "loadModule": { | |
629 "$ref": "Module", | |
630 "description": "The binary module from where the code was lo
aded." | |
631 }, | |
632 "columnNumber": { | |
633 "description": "The column number where the function call ap
pears, if available.\nThis is important in JavaScript because of its anonymous f
unctions.", | |
634 "format": "int64", | |
635 "type": "string" | |
636 }, | |
637 "fileName": { | |
638 "$ref": "TruncatableString", | |
639 "description": "The name of the source file where the functi
on call appears (up to 256\nbytes)." | |
640 }, | |
641 "sourceVersion": { | |
642 "$ref": "TruncatableString", | |
643 "description": "The version of the deployed source code (up
to 128 bytes)." | |
644 }, | |
645 "originalFunctionName": { | |
646 "$ref": "TruncatableString", | |
647 "description": "An un-mangled function name, if `function_na
me` is\n[mangled](http://www.avabodh.com/cxxin/namemangling.html). The name can\
nbe fully-qualified (up to 1024 bytes)." | |
648 } | |
649 }, | |
650 "type": "object" | |
651 }, | |
652 "Link": { | |
653 "description": "A pointer from the current span to another span in t
he same trace or in a\ndifferent trace. For example, this can be used in batchin
g operations,\nwhere a single batch handler processes multiple requests from dif
ferent\ntraces or when the handler receives a request from a different project."
, | |
654 "id": "Link", | |
655 "properties": { | |
656 "type": { | |
657 "description": "The relationship of the current span relativ
e to the linked span.", | |
658 "enum": [ | |
659 "TYPE_UNSPECIFIED", | |
660 "CHILD_LINKED_SPAN", | |
661 "PARENT_LINKED_SPAN" | |
662 ], | |
663 "enumDescriptions": [ | |
664 "The relationship of the two spans is unknown.", | |
665 "The linked span is a child of the current span.", | |
666 "The linked span is a parent of the current span." | |
667 ], | |
668 "type": "string" | |
669 }, | |
670 "attributes": { | |
671 "$ref": "Attributes", | |
672 "description": "A set of attributes on the link. There is a
limit of 32 attributes per\nlink." | |
673 }, | |
674 "traceId": { | |
675 "description": "`TRACE_ID` identifies a trace within a proje
ct.", | |
676 "type": "string" | |
677 }, | |
678 "spanId": { | |
679 "description": "`SPAN_ID` identifies a span within a trace."
, | |
680 "type": "string" | |
681 } | |
682 }, | |
683 "type": "object" | |
684 }, | |
685 "Annotation": { | |
686 "description": "Text annotation with a set of attributes.", | |
687 "id": "Annotation", | |
688 "properties": { | |
689 "attributes": { | |
690 "$ref": "Attributes", | |
691 "description": "A set of attributes on the annotation. There
is a limit of 4 attributes\nper Annotation." | |
692 }, | |
693 "description": { | |
694 "$ref": "TruncatableString", | |
695 "description": "A user-supplied message describing the event
. The maximum length for\nthe description is 256 bytes." | |
696 } | |
697 }, | |
698 "type": "object" | |
699 }, | |
700 "StackFrames": { | |
701 "description": "A collection of stack frames, which can be truncated
.", | |
702 "id": "StackFrames", | |
703 "properties": { | |
704 "droppedFramesCount": { | |
705 "description": "The number of stack frames that were dropped
because there\nwere too many stack frames.\nIf this value is 0, then no stack f
rames were dropped.", | |
706 "format": "int32", | |
707 "type": "integer" | |
708 }, | |
709 "frame": { | |
710 "description": "Stack frames in this call stack.", | |
711 "items": { | |
712 "$ref": "StackFrame" | |
713 }, | |
714 "type": "array" | |
715 } | |
716 }, | |
717 "type": "object" | |
718 }, | |
719 "Trace": { | |
720 "description": "A trace describes how long it takes for an applicati
on to perform some\noperations. It consists of a set of spans, each representing
\nan operation and including time information and operation details.", | |
721 "id": "Trace", | |
722 "properties": { | |
723 "name": { | |
724 "description": "The resource name of the trace in the follow
ing format:\n\n projects/[PROJECT_ID]/traces/TRACE_ID is a unique identifier
for a trace within a project.\nThe ID is assigned when the trace is created.", | |
725 "type": "string" | |
726 } | |
727 }, | |
728 "type": "object" | |
729 } | 729 } |
730 }, | 730 }, |
731 "servicePath": "", | 731 "servicePath": "", |
732 "title": "Stackdriver Trace API", | 732 "title": "Stackdriver Trace API", |
733 "version": "v2" | 733 "version": "v2" |
734 } | 734 } |
OLD | NEW |