The time when the work item attempt became a straggler.
Uses RFC 3339, where generated output will always be Z-normalized and uses 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" or "2014-10-02T15:01:23+05:30".
The straggler causes, keyed by the string representation of the StragglerCause enum and contains specialized debugging information for each straggler cause.
StragglerDebuggingInfo
Information useful for debugging a straggler. Each type will provide specialized debugging information relevant for a particular cause. The StragglerDebuggingInfo will be 1:1 mapping to the StragglerCause enum.
JSON representation
{// Union field straggler_debugging_info_value can be only one of the following:"hotKey": {object (HotKeyDebuggingInfo)}// End of list of possible types for union field// straggler_debugging_info_value.}
Fields
Union field straggler_debugging_info_value.
straggler_debugging_info_value can be only one of the following:
The age of the hot key measured from when it was first detected.
A duration in seconds with up to nine fractional digits, ending with 's'. Example: "3.5s".
key
string
A detected hot key that is causing limited parallelism. This field will be populated only if the following flag is set to true: "--enableHotKeyLogging".
keyTruncated
boolean
If true, then the above key is truncated and cannot be deserialized. This occurs if the key above is populated and the key size is >5MB.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-04-30 UTC."],[[["\u003cp\u003eThis content provides details on debugging information related to stragglers, which are slow-running work items in data processing.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eStragglerDebuggingInfo\u003c/code\u003e section outlines a structure for specialized debugging insights for specific straggler causes, including a union field for different types.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eHotKeyDebuggingInfo\u003c/code\u003e details how to debug detected hot keys, which are data keys that are causing reduced parallelism, and provides a map of these keys for examination.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eHotKeyInfo\u003c/code\u003e gives specific information about each detected hot key, such as its age, the key itself (if logging is enabled), and whether it has been truncated due to size.\u003c/p\u003e\n"],["\u003cp\u003eThe content defines the structure and fields of various debugging data objects in JSON format, including details on timestamps, durations, and key representations.\u003c/p\u003e\n"]]],[],null,["# StragglerInfo\n\n- [JSON representation](#SCHEMA_REPRESENTATION)\n- [StragglerDebuggingInfo](#StragglerDebuggingInfo)\n - [JSON representation](#StragglerDebuggingInfo.SCHEMA_REPRESENTATION)\n- [HotKeyDebuggingInfo](#HotKeyDebuggingInfo)\n - [JSON representation](#HotKeyDebuggingInfo.SCHEMA_REPRESENTATION)\n- [HotKeyInfo](#HotKeyInfo)\n - [JSON representation](#HotKeyInfo.SCHEMA_REPRESENTATION)\n\nInformation useful for straggler identification and debugging.\n\nStragglerDebuggingInfo\n----------------------\n\nInformation useful for debugging a straggler. Each type will provide specialized debugging information relevant for a particular cause. The StragglerDebuggingInfo will be 1:1 mapping to the StragglerCause enum.\n\nHotKeyDebuggingInfo\n-------------------\n\nInformation useful for debugging a hot key detection.\n\nHotKeyInfo\n----------\n\nInformation about a hot key."]]