OpenRAG is a comprehensive, single package Retrieval-Augmented Generation platform built on Langflow, Docling, and Opensearch.
Python
import {
type UseQueryOptions,
useQuery,
useQueryClient,
} from "@tanstack/react-query";
import { apiClient } from "@/lib/api-client";
export interface DoclingHealthResponse {
// "degraded": docling-serve is up but slow to answer (busy converting), so
// ingest still works and the "stopped" banner must not show.
status: "healthy" | "degraded" | "unhealthy" | "backend-unavailable";
message?: string;
}
async function checkDoclingHealth(): Promise<DoclingHealthResponse> {
try {
const response =
await apiClient.get<DoclingHealthResponse>("/docling/health");
if (response.status >= 200 && response.status < 300) {
const body = response.data;
if (body?.status === "degraded") {
return { status: "degraded", message: body.message };
}
return { status: "healthy" };
} else if (response.status === 503) {
return {
status: "unhealthy",
message: `Health check failed with status: ${response.status}`,
};
} else {
return {
status: "unhealthy",
message: `Health check failed with status: ${response.status}`,
};
}
} catch (error) {
return {
status: "backend-unavailable",
message: error instanceof Error ? error.message : "Connection failed",
};
}
}
export const useDoclingHealthQuery = (
options?: Omit<
UseQueryOptions<DoclingHealthResponse>,
"queryKey" | "queryFn"
>,
) => {
const queryClient = useQueryClient();
return useQuery(
{
queryKey: ["docling-health"],
queryFn: checkDoclingHealth,
retry: 1,
refetchInterval: (query) => {
// Up (healthy or busy): check every 30 seconds; down: every 3 seconds.
// Polling a busy docling-serve fast would only add to its load.
const status = query.state.data?.status;
return status === "healthy" || status === "degraded" ? 30000 : 3000;
},
refetchOnWindowFocus: false, // Disabled to reduce unnecessary calls on tab switches
refetchOnMount: true,
staleTime: 30000, // Consider data fresh for 30 seconds
...options,
},
queryClient,
);
};