Files
floci-ui/packages/frontend/src/components/LogsExplorerPanel.tsx
T
2026-09-30 17:43:42 -04:00

349 lines
19 KiB
TypeScript

import {useEffect, useRef, useState} from 'react'
import {createPortal} from 'react-dom'
import {ChevronRight, Maximize2, Minimize2, Radio, RefreshCw, Search, ScrollText, Square} from 'lucide-react'
import {useQueries} from '@tanstack/react-query'
import {filterLogEvents, listChildCollections, listCollectionItems} from '@/api/cloudProxyClient'
import {EmptyState} from '@/components/EmptyState'
import {ServiceIcon} from '@/components/serviceIcons'
import {formatBytes, formatDateTime} from '@/lib/format'
import {timeAgo} from '@/lib/utils'
import type {CloudProvider} from '@/types/cloud'
import type {CloudResource} from '@/types/resource'
const LIVE_TAIL_INTERVAL_MS = 2_000
interface LogsExplorerPanelProps {
cloud: CloudProvider
resource?: CloudResource
runtimeReachable: boolean
}
/**
* Lives in ResourceInspector next to a selected log group's metadata and the
* Insights query panel, rather than as a full-width section under the
* resource table. This is the two-level drill-in beneath a selected group:
* streams (a child collection) and events (the leaf item), both served by the
* generic child-collections SPI that AwsLogsAdapter implements — three
* min-width columns (~1000px), too wide for the inspector's narrow column, so
* the inline view is a compact summary and the real browser opens in the same
* full-page modal the query panel uses.
*
* Both streams and events use one query per loaded cursor page (via
* useQueries) rather than useInfiniteQuery, following the precedent set for
* events by the original implementation this panel ported from. Refresh
* resets the cursor array to a single page and explicitly refetches it,
* rather than only refetching the first query: with more than one page
* loaded, refetching in place would otherwise combine a fresh first page
* with stale trailing pages built from the old cursor chain.
*/
export function LogsExplorerPanel({cloud, resource, runtimeReachable}: LogsExplorerPanelProps) {
const groupId = resource?.id
const [selectedStreamId, setSelectedStreamId] = useState<string | undefined>()
const [streamCursors, setStreamCursors] = useState<Array<string | undefined>>([undefined])
const [eventCursors, setEventCursors] = useState<Array<string | undefined>>([undefined])
const [expanded, setExpanded] = useState(false)
const [eventMode, setEventMode] = useState<'stream' | 'filter'>('stream')
const [filterPattern, setFilterPattern] = useState('')
const [appliedFilterPattern, setAppliedFilterPattern] = useState('')
const [filteredEvents, setFilteredEvents] = useState<Awaited<ReturnType<typeof filterLogEvents>>['items']>([])
const [filterCursor, setFilterCursor] = useState<string | null>(null)
const [filterLoading, setFilterLoading] = useState(false)
const [filterError, setFilterError] = useState<string>()
const [liveTail, setLiveTail] = useState(false)
const filteredEventsRef = useRef(filteredEvents)
useEffect(() => {
filteredEventsRef.current = filteredEvents
}, [filteredEvents])
useEffect(() => {
setSelectedStreamId(undefined)
setStreamCursors([undefined])
setEventCursors([undefined])
setEventMode('stream')
setFilterPattern('')
setAppliedFilterPattern('')
setFilteredEvents([])
setFilterCursor(null)
setFilterError(undefined)
setLiveTail(false)
}, [cloud, groupId])
useEffect(() => {
setEventCursors([undefined])
}, [selectedStreamId])
const streamPages = useQueries({
queries: streamCursors.map((cursor) => ({
queryKey: ['log-streams', cloud, groupId, cursor],
queryFn: ({signal}: {signal: AbortSignal}) => listChildCollections(cloud, 'logs', groupId ?? '', cursor, signal),
enabled: Boolean(groupId) && runtimeReachable,
})),
})
const firstStreamPage = streamPages[0]
const lastStreamPage = streamPages[streamPages.length - 1]
const streams = streamPages.flatMap((page) => page.data?.items ?? [])
const nextStreamCursor = lastStreamPage?.data?.nextCursor ?? null
const loadingMoreStreams = streamPages.length > 1 && lastStreamPage?.isLoading
const eventPages = useQueries({
queries: eventCursors.map((cursor) => ({
queryKey: ['log-events', cloud, groupId, selectedStreamId, cursor],
queryFn: ({signal}: {signal: AbortSignal}) => listCollectionItems(cloud, 'logs', groupId ?? '', selectedStreamId ?? '', cursor, signal),
enabled: Boolean(groupId && selectedStreamId) && runtimeReachable,
})),
})
const firstEventPage = eventPages[0]
const lastEventPage = eventPages[eventPages.length - 1]
const events = eventPages.flatMap((page) => page.data?.items ?? [])
const nextEventCursor = lastEventPage?.data?.nextCursor ?? null
const loadingMoreEvents = eventPages.length > 1 && lastEventPage?.isLoading
function refreshStreams() {
setStreamCursors([undefined])
void firstStreamPage?.refetch()
}
function refreshEvents() {
setEventCursors([undefined])
void firstEventPage?.refetch()
}
async function loadFilteredEvents(pattern: string, cursor?: string, append = false, signal?: AbortSignal) {
setFilterLoading(true)
setFilterError(undefined)
try {
const page = await filterLogEvents(cloud, groupId ?? '', {filterPattern: pattern || undefined}, cursor, signal)
setFilteredEvents((current) => append ? mergeEvents(current, page.items) : page.items)
setFilterCursor(page.nextCursor)
} catch (error) {
if (!signal?.aborted) setFilterError(error instanceof Error ? error.message : 'Unable to filter log events.')
} finally {
if (!signal?.aborted) setFilterLoading(false)
}
}
useEffect(() => {
if (!liveTail || !runtimeReachable || !groupId) return
const controller = new AbortController()
let timer: ReturnType<typeof setTimeout> | undefined
const poll = async () => {
try {
const latestTimestamp = filteredEventsRef.current.reduce((latest, event) => {
const timestamp = event.timestamp ? Date.parse(event.timestamp) : 0
return Math.max(latest, timestamp)
}, 0)
let cursor: string | undefined
do {
const page = await filterLogEvents(cloud, groupId, {
filterPattern: appliedFilterPattern || undefined,
startTime: latestTimestamp || undefined,
}, cursor, controller.signal)
setFilteredEvents((current) => mergeEvents(current, page.items))
cursor = page.nextCursor ?? undefined
} while (cursor && !controller.signal.aborted)
if (!controller.signal.aborted) timer = setTimeout(poll, LIVE_TAIL_INTERVAL_MS)
} catch (error) {
if (!controller.signal.aborted) {
setFilterError(error instanceof Error ? error.message : 'Live tail stopped after an error.')
setLiveTail(false)
}
}
}
void poll()
return () => {
controller.abort()
if (timer) clearTimeout(timer)
}
}, [appliedFilterPattern, cloud, groupId, liveTail, runtimeReachable])
if (!groupId) return null
const content = (
<section className="cosmos-panel">
<div className="cosmos-column">
<div className="cosmos-panel-header">
<ServiceIcon cloud="aws" iconKey="logs" size={18}/>
<span>
<small>Streams</small>
<strong>{groupId}</strong>
<em>{streams.length} log streams</em>
</span>
<button className="icon-btn" type="button" title="Collapse" onClick={() => setExpanded(false)}>
<Minimize2 size={14}/>
</button>
</div>
<div className="cosmos-toolbar">
<button className="button" type="button" disabled={!runtimeReachable || firstStreamPage?.isFetching} onClick={refreshStreams}>
<RefreshCw size={14}/>
Refresh
</button>
</div>
{firstStreamPage?.error instanceof Error && <div className="form-error">{firstStreamPage.error.message}</div>}
<div className="cosmos-list">
{firstStreamPage?.isLoading && <div className="muted padded">Loading log streams</div>}
{!firstStreamPage?.isLoading && streams.length === 0 && (
<EmptyState
icon={ScrollText}
title="No log streams"
description="Log streams created in this group will appear here."
/>
)}
{streams.map((stream) => (
<button
key={stream.id}
className={`cosmos-list-row ${selectedStreamId === stream.id ? 'selected' : ''}`}
type="button"
onClick={() => setSelectedStreamId(stream.id)}
>
<span>
<strong>{stream.name}</strong>
<small>Last event {timeAgo(typeof stream.metadata.lastEventTimestamp === 'string' ? stream.metadata.lastEventTimestamp : undefined)}</small>
</span>
<em>{typeof stream.metadata.storedBytes === 'number' ? formatBytes(stream.metadata.storedBytes) : '-'}</em>
<ChevronRight size={13}/>
</button>
))}
{nextStreamCursor && (
<div style={{display: 'flex', justifyContent: 'center', padding: '12px 0'}}>
<button
className="button"
type="button"
disabled={Boolean(loadingMoreStreams)}
onClick={() => setStreamCursors((prev) => [...prev, nextStreamCursor])}
>
{loadingMoreStreams ? 'Loading…' : 'Load more'}
</button>
</div>
)}
</div>
</div>
<div className="cosmos-column cosmos-column--wide">
<div className="cosmos-panel-header">
<ServiceIcon cloud="aws" iconKey="logs" size={18}/>
<span>
<small>Events</small>
<strong>{selectedStreamId ?? 'Select a stream'}</strong>
<em>{events.length} events loaded</em>
</span>
</div>
<div className="cosmos-toolbar">
<div className="logs-mode-toggle" role="group" aria-label="Log event mode">
<button className={`button compact${eventMode === 'stream' ? ' active' : ''}`} type="button" onClick={() => { setEventMode('stream'); setLiveTail(false) }}>Selected stream</button>
<button className={`button compact${eventMode === 'filter' ? ' active' : ''}`} type="button" onClick={() => setEventMode('filter')}>Filter all streams</button>
</div>
{eventMode === 'stream' ? <button className="button" type="button" disabled={!runtimeReachable || !selectedStreamId || firstEventPage?.isFetching} onClick={refreshEvents}>
<RefreshCw size={14}/> Refresh
</button> : <form className="logs-filter-toolbar" onSubmit={(event) => {
event.preventDefault()
setAppliedFilterPattern(filterPattern.trim())
setLiveTail(false)
void loadFilteredEvents(filterPattern.trim())
}}>
<label><span className="sr-only">Filter pattern</span><input className="input logs-filter-pattern" aria-label="Filter pattern" value={filterPattern} onChange={(event) => setFilterPattern(event.target.value)} placeholder='Filter pattern, for example "ERROR"'/></label>
<button className="button" type="submit" disabled={!runtimeReachable || filterLoading}><Search size={14}/>{filterLoading ? 'Filtering' : 'Filter'}</button>
<button className={`button${liveTail ? ' danger' : ''}`} type="button" disabled={!runtimeReachable || filterLoading} onClick={() => {
if (!liveTail && appliedFilterPattern !== filterPattern.trim()) {
setAppliedFilterPattern(filterPattern.trim())
void loadFilteredEvents(filterPattern.trim())
}
setLiveTail((current) => !current)
}}>{liveTail ? <Square size={13}/> : <Radio size={13}/>} {liveTail ? 'Stop tail' : 'Live tail'}</button>
</form>}
</div>
{eventMode === 'stream' && firstEventPage?.error instanceof Error && <div className="form-error">{firstEventPage.error.message}</div>}
{eventMode === 'filter' && filterError && <div className="form-error">{filterError}</div>}
<div className="cosmos-items-table">
{eventMode === 'stream' && !selectedStreamId && (
<div className="empty compact"><h3>Select a stream</h3><p>Events are scoped to a log stream.</p></div>
)}
{eventMode === 'stream' && selectedStreamId && !firstEventPage?.isLoading && events.length === 0 && (
<EmptyState
icon={ScrollText}
title="No log events"
description="Events written to this stream will appear here."
/>
)}
{eventMode === 'stream' && selectedStreamId && (firstEventPage?.isLoading ? (
<div className="muted padded">Loading log events</div>
) : events.length > 0 && (
<>
<table className="table">
<thead>
<tr>
<th>Timestamp</th>
<th>Message</th>
</tr>
</thead>
<tbody>
{events.map((event) => (
<tr key={event.id}>
<td className="mono" style={{color: '#8d9cad', whiteSpace: 'nowrap'}}>
{formatDateTime(event.timestamp) ?? '-'}
</td>
<td className="mono">{String(event.body.message ?? '')}</td>
</tr>
))}
</tbody>
</table>
{nextEventCursor && (
<div style={{display: 'flex', justifyContent: 'center', padding: '12px 0'}}>
<button
className="button"
type="button"
disabled={Boolean(loadingMoreEvents)}
onClick={() => setEventCursors((prev) => [...prev, nextEventCursor])}
>
{loadingMoreEvents ? 'Loading…' : 'Load more'}
</button>
</div>
)}
</>
))}
{eventMode === 'filter' && !filterLoading && filteredEvents.length === 0 && <EmptyState icon={Search} title="No matching events" description="Apply a filter pattern or start live tail to search every stream in this group."/>}
{eventMode === 'filter' && filteredEvents.length > 0 && <>
{liveTail && <div className="logs-live-status"><Radio size={12}/> Live tail active</div>}
<table className="table logs-events-table"><thead><tr><th>Timestamp</th><th>Log stream</th><th>Message</th></tr></thead><tbody>{filteredEvents.map((event) => <tr key={event.id}><td className="mono">{formatDateTime(event.timestamp) ?? '-'}</td><td className="mono logs-event-stream">{event.collectionId ?? '-'}</td><td className="mono">{String(event.body.message ?? '')}</td></tr>)}</tbody></table>
{filterCursor && !liveTail && <div style={{display: 'flex', justifyContent: 'center', padding: '12px 0'}}><button className="button" type="button" disabled={filterLoading} onClick={() => void loadFilteredEvents(appliedFilterPattern, filterCursor, true)}>{filterLoading ? 'Loading…' : 'Load more'}</button></div>}
</>}
</div>
</div>
</section>
)
const summary = (
<section className="logs-query-panel">
<div className="logs-query-header">
<ServiceIcon cloud="aws" iconKey="logs" size={18}/>
<span>
<small>Streams &amp; events</small>
<strong>{groupId}</strong>
<em>{firstStreamPage?.isLoading ? 'Loading…' : `${streams.length} log streams`}</em>
</span>
<button className="icon-btn" type="button" title="Expand to full page" onClick={() => setExpanded(true)}>
<Maximize2 size={14}/>
</button>
</div>
</section>
)
if (!expanded) return summary
return createPortal(
<div className="modal-overlay" onClick={() => setExpanded(false)}>
<div className="logs-query-modal" onClick={(event) => event.stopPropagation()}>
{content}
</div>
</div>,
document.body,
)
}
function mergeEvents(current: Awaited<ReturnType<typeof filterLogEvents>>['items'], incoming: Awaited<ReturnType<typeof filterLogEvents>>['items']) {
const byId = new Map(current.map((event) => [event.id, event]))
for (const event of incoming) byId.set(event.id, event)
return [...byId.values()].sort((left, right) => Date.parse(left.timestamp ?? '') - Date.parse(right.timestamp ?? ''))
}