@parca/profile 0.19.151 → 0.19.153

package/src/ProfileFlameGraph/FlameGraphArrow/MemoizedTooltip.tsx

@@ -11,7 +11,7 @@
 // See the License for the specific language governing permissions and
 // limitations under the License.
 
-import React, {memo, useEffect, useState} from 'react';
+import React, {memo, useEffect, useRef, useState} from 'react';
 
 import GraphTooltipArrow from '../../GraphTooltipArrow';
 import GraphTooltipArrowContent from '../../GraphTooltipArrow/Content';
@@ -28,13 +28,45 @@ export const MemoizedTooltip = memo(function MemoizedTooltip({
   dockedMetainfo,
 }: MemoizedTooltipProps): React.JSX.Element | null {
   const [tooltipRow, setTooltipRow] = useState<number | null>(null);
+  const [shiftHeld, setShiftHeld] = useState(false);
+  const shiftHeldRef = useRef(false);
+
+  useEffect(() => {
+    shiftHeldRef.current = shiftHeld;
+  }, [shiftHeld]);
+
   const {table, total, totalUnfiltered, profileType, unit, compareAbsolute, tooltipId} =
     useTooltipContext();
 
+  useEffect(() => {
+    const onKeyDown = (e: KeyboardEvent): void => {
+      if (e.key === 'Shift') setShiftHeld(true);
+    };
+    const onKeyUp = (e: KeyboardEvent): void => {
+      if (e.key === 'Shift') setShiftHeld(false);
+    };
+    // If the user opens the attribution link, releases Shift in the new tab,
+    // and comes back — our window never saw the keyup, so the frozen state
+    // would stick. Clear it whenever focus leaves the tab.
+    const onBlurOrHide = (): void => setShiftHeld(false);
+    window.addEventListener('keydown', onKeyDown);
+    window.addEventListener('keyup', onKeyUp);
+    window.addEventListener('blur', onBlurOrHide);
+    document.addEventListener('visibilitychange', onBlurOrHide);
+    return () => {
+      window.removeEventListener('keydown', onKeyDown);
+      window.removeEventListener('keyup', onKeyUp);
+      window.removeEventListener('blur', onBlurOrHide);
+      document.removeEventListener('visibilitychange', onBlurOrHide);
+    };
+  }, []);
+
   // This component subscribes to tooltip updates through a callback
   // passed to the TooltipProvider, avoiding the need to lift state
   useEffect(() => {
     const handleTooltipUpdate = (event: CustomEvent<{row: number | null}>): void => {
+      // While Shift is held, lock the tooltip to its original frame.
+      if (shiftHeldRef.current) return;
       setTooltipRow(event.detail.row);
     };
 
@@ -82,7 +114,7 @@ export const MemoizedTooltip = memo(function MemoizedTooltip({
     return null;
   }
   return (
-    <GraphTooltipArrow contextElement={contextElement}>
+    <GraphTooltipArrow contextElement={contextElement} frozen={shiftHeld}>
       <GraphTooltipArrowContent
         table={table}
         row={tooltipRow}
@@ -92,6 +124,7 @@ export const MemoizedTooltip = memo(function MemoizedTooltip({
         profileType={profileType}
         unit={unit}
         compareAbsolute={compareAbsolute}
+        frozen={shiftHeld}
       />
     </GraphTooltipArrow>
   );

package/src/ProfileMetricsGraph/index.tsx

@@ -368,9 +368,15 @@ const ProfileMetricsGraph = ({
           yAxisLabel = 'CPU Cores';
           yAxisUnit = '';
         }
-        if (sampleType === 'cuda') {
+        if (sampleType === 'cuda' || sampleType === 'gpu_time') {
           yAxisLabel = 'GPU Time';
         }
+        if (sampleType === 'gpu_kernel_time') {
+          yAxisLabel = 'GPU Kernel Time';
+        }
+        if (sampleType === 'gpu_stall_time') {
+          yAxisLabel = 'GPU Stall Time';
+        }
       }
       if (sampleUnit === 'bytes') {
         yAxisLabel = 'Bytes per Second';

package/src/ProfileTypeSelector/index.tsx

@@ -111,6 +111,18 @@ export const wellKnownProfiles: WellKnownProfiles = {
     name: 'On-GPU',
     help: 'Time spent on the GPU.',
   },
+  'parca_agent:gpu_time:nanoseconds:gpu_time:nanoseconds:delta': {
+    name: 'On-GPU',
+    help: 'Time spent on the GPU. Combines kernel execution time and PC stall samples; the gpu_view label distinguishes the two views.',
+  },
+  'parca_agent:gpu_kernel_time:nanoseconds:gpu_kernel_time:nanoseconds:delta': {
+    name: 'On-GPU',
+    help: 'GPU kernel execution time measured via CUDA runtime callbacks.',
+  },
+  'parca_agent:gpu_stall_time:nanoseconds:gpu_stall_time:nanoseconds:delta': {
+    name: 'GPU Stalls',
+    help: 'GPU stall time accumulated from PC sampling — shows where threads were waiting on the GPU.',
+  },
 };
 
 export function flexibleWellKnownProfileMatching(name: string): WellKnownProfile | undefined {