feat: Add custom attributes for individual rows (#1379)

Closes HDX-2776
Closes HDX-2752

# Summary

This PR extends the custom attributes feature from #1356 to support custom attributes on individual rows (rather than entire traces). Further, attributes which are URLs are now rendered as links, supporting use-cases which require building custom external links from queried data.

## Demo

Source Configuration:

<img width="972" height="649" alt="Screenshot 2025-11-18 at 6 01 55 PM" src="https://github.com/user-attachments/assets/42e9cc95-d9e3-4155-8e25-58e4dcf0b787" />

Side panel:
<img width="1587" height="511" alt="Screenshot 2025-11-18 at 6 02 12 PM" src="https://github.com/user-attachments/assets/3a1d7683-eb79-4925-99fe-4e2d7cdad78f" />

Inferred link:
<img width="727" height="173" alt="Screenshot 2025-11-18 at 6 02 32 PM" src="https://github.com/user-attachments/assets/68f42f95-598c-4b30-b616-9556e32945bf" />


<details>
<summary>logview attribute definition</summary>

```sql
if(
  NOT empty(TraceId) AND NOT empty(SpanId) AND NOT empty(ServiceName),
  concat('https://logview.com?q=',
    'trace_id=', TraceId,
    '&span_id=', SpanId,
    '&service=', ServiceName,
    '&start_time=', formatDateTime(Timestamp - INTERVAL 1 SECOND, '%FT%T.%fZ'),
    '&end_time=', formatDateTime(Timestamp + Duration/1e9 + INTERVAL 1 SECOND, '%FT%T.%fZ')
  ),
  ''
)
```
</details>

Author: pulpdrew

.changeset/slow-eyes-attack.md

@@ -0,0 +1,6 @@
+---
+"@hyperdx/common-utils": patch
+"@hyperdx/app": patch
+---
+
+feat: Add custom attributes for individual rows

packages/api/src/models/source.ts

@@ -69,6 +69,9 @@ export const Source = mongoose.model<ISource>(
       highlightedTraceAttributeExpressions: {
         type: mongoose.Schema.Types.Array,
       },
+      highlightedRowAttributeExpressions: {
+        type: mongoose.Schema.Types.Array,
+      },
 
       metricTables: {
         type: {

packages/app/src/components/DBHighlightedAttributesList.tsx

@@ -39,7 +39,7 @@ export function DBHighlightedAttributesList({
           displayedKey={displayedKey}
           name={lucene ? lucene : sql}
           nameLanguage={lucene ? 'lucene' : 'sql'}
-          value={value as string}
+          value={value}
           key={`${displayedKey}-${value}-${source.id}`}
           {...(onPropertyAddClick && contextSource?.id === source.id
             ? {

packages/app/src/components/DBRowDataPanel.tsx

@@ -6,6 +6,7 @@ import { Box } from '@mantine/core';
 
 import { useQueriedChartConfig } from '@/hooks/useChartConfig';
 import { getDisplayedTimestampValueExpression, getEventBody } from '@/source';
+import { getSelectExpressionsForHighlightedAttributes } from '@/utils/highlightedAttributes';
 
 import { DBRowJsonViewer } from './DBRowJsonViewer';
 
@@ -37,6 +38,13 @@ export function useRowData({
   const severityTextExpr =
     source.severityTextExpression || source.statusCodeExpression;
 
+  const selectHighlightedRowAttributes =
+    source.kind === SourceKind.Trace || source.kind === SourceKind.Log
+      ? getSelectExpressionsForHighlightedAttributes(
+          source.highlightedRowAttributeExpressions,
+        )
+      : [];
+
   const queryResult = useQueriedChartConfig(
     {
       connection: source.connection,
@@ -116,6 +124,7 @@ export function useRowData({
               },
             ]
           : []),
+        ...selectHighlightedRowAttributes,
       ],
       where: rowId ?? '0=1',
       from: source.from,

packages/app/src/components/DBRowOverviewPanel.tsx

@@ -165,7 +165,6 @@ export function RowOverviewPanel({
         <Box px="32px" pt="md">
           <DBRowSidePanelHeader
             date={new Date(firstRow?.__hdx_timestamp ?? 0)}
-            tags={{}}
             mainContent={mainContent}
             mainContentHeader={mainContentColumn}
             severityText={firstRow?.__hdx_severity_text}

packages/app/src/components/DBRowSidePanel.tsx

@@ -12,7 +12,7 @@ import { isString } from 'lodash';
 import { parseAsStringEnum, useQueryState } from 'nuqs';
 import { ErrorBoundary } from 'react-error-boundary';
 import { useHotkeys } from 'react-hotkeys-hook';
-import { TSource } from '@hyperdx/common-utils/dist/types';
+import { SourceKind, TSource } from '@hyperdx/common-utils/dist/types';
 import { ChartConfigWithDateRange } from '@hyperdx/common-utils/dist/types';
 import { Box, Drawer, Flex, Stack } from '@mantine/core';
 
@@ -26,6 +26,7 @@ import { LogSidePanelKbdShortcuts } from '@/LogSidePanelElements';
 import { getEventBody } from '@/source';
 import TabBar from '@/TabBar';
 import { SearchConfig } from '@/types';
+import { getHighlightedAttributesFromData } from '@/utils/highlightedAttributes';
 import { useZIndex, ZIndexContext } from '@/zIndex';
 
 import ServiceMapSidePanel from './ServiceMap/ServiceMapSidePanel';
@@ -188,15 +189,34 @@ const DBRowSidePanel = ({
       : undefined;
   const severityText: string | undefined =
     normalizedRow?.['__hdx_severity_text'];
-  const serviceName = normalizedRow?.['__hdx_service_name'];
 
-  const tags = useMemo(() => {
-    const tags: Record<string, string> = {};
-    if (serviceName && source.serviceNameExpression) {
-      tags[source.serviceNameExpression] = serviceName;
+  const highlightedAttributeValues = useMemo(() => {
+    const attributeExpressions: TSource['highlightedRowAttributeExpressions'] =
+      [];
+    if (
+      (source.kind === SourceKind.Trace || source.kind === SourceKind.Log) &&
+      source.highlightedRowAttributeExpressions
+    ) {
+      attributeExpressions.push(...source.highlightedRowAttributeExpressions);
     }
-    return tags;
-  }, [serviceName, source.serviceNameExpression]);
+
+    // Add service name expression to all sources, to maintain compatibility with
+    // the behavior prior to the addition of highlightedRowAttributeExpressions
+    if (source.serviceNameExpression) {
+      attributeExpressions.push({
+        sqlExpression: source.serviceNameExpression,
+      });
+    }
+
+    return rowData
+      ? getHighlightedAttributesFromData(
+          source,
+          attributeExpressions,
+          rowData.data || [],
+          rowData.meta || [],
+        )
+      : [];
+  }, [source, rowData]);
 
   const oneHourRange = useMemo(() => {
     return [
@@ -275,7 +295,7 @@ const DBRowSidePanel = ({
       <Box p="sm">
         <DBRowSidePanelHeader
           date={timestampDate}
-          tags={tags}
+          attributes={highlightedAttributeValues}
           mainContent={mainContent}
           mainContentHeader={mainContentColumn}
           severityText={severityText}

packages/app/src/components/DBRowSidePanelHeader.tsx

@@ -17,11 +17,14 @@ import {
   UnstyledButton,
 } from '@mantine/core';
 
-import EventTag from '@/components/EventTag';
 import { FormatTime } from '@/useFormatTime';
 import { useUserPreferences } from '@/useUserPreferences';
 import { formatDistanceToNowStrictShort } from '@/utils';
 
+import {
+  DBHighlightedAttributesList,
+  HighlightedAttribute,
+} from './DBHighlightedAttributesList';
 import { RowSidePanelContext } from './DBRowSidePanel';
 import LogLevel from './LogLevel';
 
@@ -119,7 +122,7 @@ function BreadcrumbNavigation({
 }
 
 export default function DBRowSidePanelHeader({
-  tags,
+  attributes = [],
   mainContent = '',
   mainContentHeader,
   date,
@@ -130,7 +133,7 @@ export default function DBRowSidePanelHeader({
   date: Date;
   mainContent?: string;
   mainContentHeader?: string;
-  tags: Record<string, string>;
+  attributes?: HighlightedAttribute[];
   severityText?: string;
   breadcrumbPath?: BreadcrumbPath;
   onBreadcrumbClick?: BreadcrumbNavigationCallback;
@@ -264,35 +267,9 @@ export default function DBRowSidePanelHeader({
           </Text>
         </Paper>
       )}
-      <Flex mt="sm">
-        {Object.entries(tags).map(([sqlKey, value]) => {
-          // Convert SQL syntax to Lucene syntax
-          // SQL: column['property.foo'] -> Lucene: column.property.foo
-          // or SQL: column -> Lucene: column
-          const luceneKey = sqlKey.replace(/\['([^']+)'\]/g, '.$1');
-
-          return (
-            <EventTag
-              {...(onPropertyAddClick
-                ? {
-                    onPropertyAddClick,
-                    sqlExpression: sqlKey,
-                  }
-                : {
-                    onPropertyAddClick: undefined,
-                    sqlExpression: undefined,
-                  })}
-              generateSearchUrl={
-                generateSearchUrl ? _generateSearchUrl : undefined
-              }
-              displayedKey={luceneKey}
-              name={luceneKey}
-              value={value}
-              key={sqlKey}
-            />
-          );
-        })}
-      </Flex>
+      <Box mt="xs">
+        <DBHighlightedAttributesList attributes={attributes} />
+      </Box>
     </>
   );
 }

packages/app/src/components/EventTag.tsx

@@ -2,7 +2,10 @@ import { useState } from 'react';
 import Link from 'next/link';
 import SqlString from 'sqlstring';
 import { SearchConditionLanguage } from '@hyperdx/common-utils/dist/types';
-import { Button, Popover, Stack } from '@mantine/core';
+import { Button, Popover, Stack, Tooltip } from '@mantine/core';
+import { IconLink } from '@tabler/icons-react';
+
+import { isLinkableUrl } from '@/utils/highlightedAttributes';
 
 export default function EventTag({
   displayedKey,
@@ -44,6 +47,8 @@ export default function EventTag({
     );
   }
 
+  const isLink = isLinkableUrl(value);
+
   const searchCondition =
     nameLanguage === 'sql'
       ? SqlString.format('? = ?', [SqlString.raw(name), value])
@@ -58,13 +63,32 @@ export default function EventTag({
       onChange={setOpened}
     >
       <Popover.Target>
-        <div
-          key={name}
-          className="bg-highlighted px-2 py-0.5 me-1 my-1 cursor-pointer"
-          onClick={() => setOpened(!opened)}
-        >
-          {displayedKey || name}: {value}
-        </div>
+        {isLink ? (
+          <Tooltip
+            label={value}
+            withArrow
+            maw={400}
+            multiline
+            style={{ wordBreak: 'break-word' }}
+          >
+            <a
+              href={encodeURI(value)}
+              target="_blank"
+              rel="noopener noreferrer"
+              className="d-flex flex-row align-items-center bg-highlighted px-2 py-0.5 me-1 my-1 cursor-pointer"
+            >
+              {displayedKey || name}
+              <IconLink size={14} className="ms-1" />
+            </a>
+          </Tooltip>
+        ) : (
+          <div
+            className="bg-highlighted px-2 py-0.5 me-1 my-1 cursor-pointer"
+            onClick={() => setOpened(!opened)}
+          >
+            {displayedKey || name}: {value}
+          </div>
+        )}
       </Popover.Target>
       <Popover.Dropdown p={2}>
         <Stack gap={0} justify="stretch">

packages/app/src/components/SourceForm.tsx

@@ -151,7 +151,16 @@ function FormRow({
 function HighlightedAttributeExpressionsFormRow({
   control,
   watch,
-}: TableModelProps) {
+  name,
+  label,
+  helpText,
+}: TableModelProps & {
+  name:
+    | 'highlightedTraceAttributeExpressions'
+    | 'highlightedRowAttributeExpressions';
+  label: string;
+  helpText?: string;
+}) {
   const databaseName = watch(`from.databaseName`, DEFAULT_DATABASE);
   const tableName = watch(`from.tableName`);
   const connectionId = watch(`connection`);
@@ -162,14 +171,11 @@ function HighlightedAttributeExpressionsFormRow({
     remove: removeHighlightedAttribute,
   } = useFieldArray({
     control,
-    name: 'highlightedTraceAttributeExpressions',
+    name,
   });
 
   return (
-    <FormRow
-      label={'Highlighted Attributes'}
-      helpText="Expressions defining trace-level attributes which are displayed in the search side panel."
-    >
+    <FormRow label={label} helpText={helpText}>
       <Grid columns={5}>
         {highlightedAttributes.map((field, index) => (
           <React.Fragment key={field.id}>
@@ -181,7 +187,7 @@ function HighlightedAttributeExpressionsFormRow({
                   connectionId,
                 }}
                 control={control}
-                name={`highlightedTraceAttributeExpressions.${index}.sqlExpression`}
+                name={`${name}.${index}.sqlExpression`}
                 disableKeywordAutocomplete
                 placeholder="ResourceAttributes['http.host']"
               />
@@ -191,7 +197,7 @@ function HighlightedAttributeExpressionsFormRow({
                 <Text c="gray">AS</Text>
                 <SQLInlineEditorControlled
                   control={control}
-                  name={`highlightedTraceAttributeExpressions.${index}.alias`}
+                  name={`${name}.${index}.alias`}
                   placeholder="Optional Alias"
                   disableKeywordAutocomplete
                 />
@@ -208,7 +214,7 @@ function HighlightedAttributeExpressionsFormRow({
             <Grid.Col span={3} pe={0}>
               <InputControlled
                 control={control}
-                name={`highlightedTraceAttributeExpressions.${index}.luceneExpression`}
+                name={`${name}.${index}.luceneExpression`}
                 placeholder="ResourceAttributes.http.host (Optional) "
               />
             </Grid.Col>
@@ -489,7 +495,18 @@ export function LogTableModelForm(props: TableModelProps) {
           />
         </FormRow>
         <Divider />
-        <HighlightedAttributeExpressionsFormRow {...props} />
+        <HighlightedAttributeExpressionsFormRow
+          {...props}
+          name="highlightedRowAttributeExpressions"
+          label="Highlighted Attributes"
+          helpText="Expressions defining row-level attributes which are displayed in the search side panel."
+        />
+        <HighlightedAttributeExpressionsFormRow
+          {...props}
+          name="highlightedTraceAttributeExpressions"
+          label="Highlighted Trace Attributes"
+          helpText="Expressions defining trace-level attributes which are displayed in the search side panel."
+        />
       </Stack>
     </>
   );
@@ -758,7 +775,18 @@ export function TraceTableModelForm(props: TableModelProps) {
         />
       </FormRow>
       <Divider />
-      <HighlightedAttributeExpressionsFormRow {...props} />
+      <HighlightedAttributeExpressionsFormRow
+        {...props}
+        name="highlightedRowAttributeExpressions"
+        label="Highlighted Attributes"
+        helpText="Expressions defining row-level attributes which are displayed in the search side panel."
+      />
+      <HighlightedAttributeExpressionsFormRow
+        {...props}
+        name="highlightedTraceAttributeExpressions"
+        label="Highlighted Trace Attributes"
+        helpText="Expressions defining trace-level attributes which are displayed in the search side panel."
+      />
     </Stack>
   );
 }