Skip to content

Commit c3c8a31

Browse files
yoshi-automationyoshi-automation
committed
feat(dataflow): update the api
#### dataflow:v1b3 The following keys were added: - resources.projects.resources.jobs.resources.debug.methods.getWorkerStacktraces (Total Keys: 14) - schemas.GetWorkerStacktracesRequest (Total Keys: 3) - schemas.GetWorkerStacktracesResponse (Total Keys: 4) - schemas.Sdk (Total Keys: 5) - schemas.Stack (Total Keys: 9)
1 parent 47197f2 commit c3c8a31

File tree

2 files changed

+151
-1
lines changed

2 files changed

+151
-1
lines changed

‎docs/dyn/dataflow_v1b3.projects.jobs.debug.html

Lines changed: 43 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -80,6 +80,9 @@ <h2>Instance Methods</h2>
8080
<p class="toc_element">
8181
<code><a href="#getConfig">getConfig(projectId, jobId, body=None, x__xgafv=None)</a></code></p>
8282
<p class="firstline">Get encoded debug configuration for component. Not cacheable.</p>
83+
<p class="toc_element">
84+
<code><a href="#getWorkerStacktraces">getWorkerStacktraces(projectId, jobId, body=None, x__xgafv=None)</a></code></p>
85+
<p class="firstline">Get worker stacktraces from debug capture.</p>
8386
<p class="toc_element">
8487
<code><a href="#sendCapture">sendCapture(projectId, jobId, body=None, x__xgafv=None)</a></code></p>
8588
<p class="firstline">Send encoded debug capture data for component.</p>
@@ -118,6 +121,46 @@ <h3>Method Details</h3>
118121
}</pre>
119122
</div>
120123

124+
<div class="method">
125+
<code class="details" id="getWorkerStacktraces">getWorkerStacktraces(projectId, jobId, body=None, x__xgafv=None)</code>
126+
<pre>Get worker stacktraces from debug capture.
127+
128+
Args:
129+
projectId: string, The project id. (required)
130+
jobId: string, The job for which to get stacktraces. (required)
131+
body: object, The request body.
132+
The object takes the form of:
133+
134+
{ # Request to get worker stacktraces from debug capture.
135+
&quot;workerId&quot;: &quot;A String&quot;, # The worker for which to get stacktraces. The returned stacktraces will be for the SDK harness running on this worker.
136+
}
137+
138+
x__xgafv: string, V1 error format.
139+
Allowed values
140+
1 - v1 error format
141+
2 - v2 error format
142+
143+
Returns:
144+
An object of the form:
145+
146+
{ # Response to get worker stacktraces from debug capture.
147+
&quot;sdks&quot;: [ # Repeated as unified worker may have multiple SDK processes.
148+
{ # A structured representation of an SDK.
149+
&quot;sdkId&quot;: &quot;A String&quot;, # The SDK harness id.
150+
&quot;stacks&quot;: [ # The stacktraces for the processes running on the SDK harness.
151+
{ # A structuredstacktrace for a process running on the worker.
152+
&quot;stackContent&quot;: &quot;A String&quot;, # The raw stack trace.
153+
&quot;threadCount&quot;: 42, # With java thread dumps we may get collapsed stacks e.g., N threads in stack &quot;&quot;. Instead of having to copy over the same stack trace N times, this int field captures this.
154+
&quot;threadName&quot;: &quot;A String&quot;, # Thread name. For example, &quot;CommitThread-0,10,main&quot;
155+
&quot;threadState&quot;: &quot;A String&quot;, # The state of the thread. For example, &quot;WAITING&quot;.
156+
&quot;timestamp&quot;: &quot;A String&quot;, # Timestamp at which the stack was captured.
157+
},
158+
],
159+
},
160+
],
161+
}</pre>
162+
</div>
163+
121164
<div class="method">
122165
<code class="details" id="sendCapture">sendCapture(projectId, jobId, body=None, x__xgafv=None)</code>
123166
<pre>Send encoded debug capture data for component.

‎googleapiclient/discovery_cache/documents/dataflow.v1b3.json

Lines changed: 108 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -693,6 +693,41 @@
693693
"https://www.googleapis.com/auth/compute"
694694
]
695695
},
696+
"getWorkerStacktraces": {
697+
"description": "Get worker stacktraces from debug capture.",
698+
"flatPath": "v1b3/projects/{projectId}/jobs/{jobId}/debug/getWorkerStacktraces",
699+
"httpMethod": "POST",
700+
"id": "dataflow.projects.jobs.debug.getWorkerStacktraces",
701+
"parameterOrder": [
702+
"projectId",
703+
"jobId"
704+
],
705+
"parameters": {
706+
"jobId": {
707+
"description": "The job for which to get stacktraces.",
708+
"location": "path",
709+
"required": true,
710+
"type": "string"
711+
},
712+
"projectId": {
713+
"description": "The project id.",
714+
"location": "path",
715+
"required": true,
716+
"type": "string"
717+
}
718+
},
719+
"path": "v1b3/projects/{projectId}/jobs/{jobId}/debug/getWorkerStacktraces",
720+
"request": {
721+
"$ref": "GetWorkerStacktracesRequest"
722+
},
723+
"response": {
724+
"$ref": "GetWorkerStacktracesResponse"
725+
},
726+
"scopes": [
727+
"https://www.googleapis.com/auth/cloud-platform",
728+
"https://www.googleapis.com/auth/compute"
729+
]
730+
},
696731
"sendCapture": {
697732
"description": "Send encoded debug capture data for component.",
698733
"flatPath": "v1b3/projects/{projectId}/jobs/{jobId}/debug/sendCapture",
@@ -2208,7 +2243,7 @@
22082243
}
22092244
}
22102245
},
2211-
"revision": "20250505",
2246+
"revision": "20250519",
22122247
"rootUrl": "https://dataflow.googleapis.com/",
22132248
"schemas": {
22142249
"ApproximateProgress": {
@@ -3796,6 +3831,31 @@
37963831
},
37973832
"type": "object"
37983833
},
3834+
"GetWorkerStacktracesRequest": {
3835+
"description": "Request to get worker stacktraces from debug capture.",
3836+
"id": "GetWorkerStacktracesRequest",
3837+
"properties": {
3838+
"workerId": {
3839+
"description": "The worker for which to get stacktraces. The returned stacktraces will be for the SDK harness running on this worker.",
3840+
"type": "string"
3841+
}
3842+
},
3843+
"type": "object"
3844+
},
3845+
"GetWorkerStacktracesResponse": {
3846+
"description": "Response to get worker stacktraces from debug capture.",
3847+
"id": "GetWorkerStacktracesResponse",
3848+
"properties": {
3849+
"sdks": {
3850+
"description": "Repeated as unified worker may have multiple SDK processes.",
3851+
"items": {
3852+
"$ref": "Sdk"
3853+
},
3854+
"type": "array"
3855+
}
3856+
},
3857+
"type": "object"
3858+
},
37993859
"Histogram": {
38003860
"description": "Histogram of value counts for a distribution. Buckets have an inclusive lower bound and exclusive upper bound and use \"1,2,5 bucketing\": The first bucket range is from [0,1) and all subsequent bucket boundaries are powers of ten multiplied by 1, 2, or 5. Thus, bucket boundaries are 0, 1, 2, 5, 10, 20, 50, 100, 200, 500, 1000, ... Negative values are not supported.",
38013861
"id": "Histogram",
@@ -5788,6 +5848,24 @@ false
57885848
},
57895849
"type": "object"
57905850
},
5851+
"Sdk": {
5852+
"description": "A structured representation of an SDK.",
5853+
"id": "Sdk",
5854+
"properties": {
5855+
"sdkId": {
5856+
"description": "The SDK harness id.",
5857+
"type": "string"
5858+
},
5859+
"stacks": {
5860+
"description": "The stacktraces for the processes running on the SDK harness.",
5861+
"items": {
5862+
"$ref": "Stack"
5863+
},
5864+
"type": "array"
5865+
}
5866+
},
5867+
"type": "object"
5868+
},
57915869
"SdkBug": {
57925870
"description": "A bug found in the Dataflow SDK.",
57935871
"id": "SdkBug",
@@ -6494,6 +6572,35 @@ false
64946572
},
64956573
"type": "object"
64966574
},
6575+
"Stack": {
6576+
"description": "A structuredstacktrace for a process running on the worker.",
6577+
"id": "Stack",
6578+
"properties": {
6579+
"stackContent": {
6580+
"description": "The raw stack trace.",
6581+
"type": "string"
6582+
},
6583+
"threadCount": {
6584+
"description": "With java thread dumps we may get collapsed stacks e.g., N threads in stack \"\". Instead of having to copy over the same stack trace N times, this int field captures this.",
6585+
"format": "int32",
6586+
"type": "integer"
6587+
},
6588+
"threadName": {
6589+
"description": "Thread name. For example, \"CommitThread-0,10,main\"",
6590+
"type": "string"
6591+
},
6592+
"threadState": {
6593+
"description": "The state of the thread. For example, \"WAITING\".",
6594+
"type": "string"
6595+
},
6596+
"timestamp": {
6597+
"description": "Timestamp at which the stack was captured.",
6598+
"format": "google-datetime",
6599+
"type": "string"
6600+
}
6601+
},
6602+
"type": "object"
6603+
},
64976604
"StageExecutionDetails": {
64986605
"description": "Information about the workers and work items within a stage.",
64996606
"id": "StageExecutionDetails",

0 commit comments

Comments
 (0)