grafana/public/app/plugins/datasource/dashboard/DashboardQueryEditor.tsx
Kyle Cunningham bf4906ed34
Dashboard Datasource: Update Query List & Improve UX (#64429)
* Update query display

* Remove links as they don't work

* Remove unused CSS

* Improve styling and add description for data field

* Update docs

* Fix up docs some more

* Move special data sources back to the bottom

* Add language back

* Change order of special datasrouces in docs
2023-04-03 14:27:21 +07:00

221 lines
6.5 KiB
TypeScript

import { css } from '@emotion/css';
import { useId } from '@react-aria/utils';
import pluralize from 'pluralize';
import React, { useCallback, useMemo } from 'react';
import { useAsync } from 'react-use';
import { DataQuery, GrafanaTheme2, PanelData, SelectableValue, DataTopic } from '@grafana/data';
import {
Card,
Field,
Select,
useStyles2,
VerticalGroup,
HorizontalGroup,
Spinner,
Switch,
RadioButtonGroup,
} from '@grafana/ui';
import config from 'app/core/config';
import { getDashboardSrv } from 'app/features/dashboard/services/DashboardSrv';
import { PanelModel } from 'app/features/dashboard/state';
import { getDatasourceSrv } from 'app/features/plugins/datasource_srv';
import { filterPanelDataToQuery } from 'app/features/query/components/QueryEditorRow';
import { DashboardQuery, ResultInfo, SHARED_DASHBOARD_QUERY } from './types';
function getQueryDisplayText(query: DataQuery): string {
return JSON.stringify(query);
}
interface Props {
queries: DataQuery[];
panelData: PanelData;
onChange: (queries: DataQuery[]) => void;
onRunQueries: () => void;
}
const topics = [
{ label: 'All data', value: false },
{ label: 'Annotations', value: true, description: 'Include annotations as regular data' },
];
export function DashboardQueryEditor({ panelData, queries, onChange, onRunQueries }: Props) {
const { value: defaultDatasource } = useAsync(() => getDatasourceSrv().get());
const query = queries[0] as DashboardQuery;
const panel = useMemo(() => {
const dashboard = getDashboardSrv().getCurrent();
return dashboard?.getPanelById(query.panelId ?? -124134);
}, [query.panelId]);
const { value: results, loading: loadingResults } = useAsync(async (): Promise<ResultInfo[]> => {
if (!panel) {
return [];
}
const mainDS = await getDatasourceSrv().get(panel.datasource);
return Promise.all(
panel.targets.map(async (query) => {
const ds = query.datasource ? await getDatasourceSrv().get(query.datasource) : mainDS;
const fmt = ds.getQueryDisplayText || getQueryDisplayText;
const queryData = filterPanelDataToQuery(panelData, query.refId) ?? panelData;
return {
refId: query.refId,
query: fmt(query),
name: ds.name,
img: ds.meta.info.logos.small,
data: queryData.series,
error: queryData.error,
};
})
);
}, [panelData, panel]);
const onUpdateQuery = useCallback(
(query: DashboardQuery) => {
onChange([query]);
onRunQueries();
},
[onChange, onRunQueries]
);
const onPanelChanged = useCallback(
(id: number) => {
onUpdateQuery({
...query,
panelId: id,
});
},
[query, onUpdateQuery]
);
const onTransformToggle = useCallback(() => {
onUpdateQuery({
...query,
withTransforms: !query.withTransforms,
});
}, [query, onUpdateQuery]);
const onTopicChanged = useCallback(
(t: boolean) => {
onUpdateQuery({
...query,
topic: t ? DataTopic.Annotations : undefined,
});
},
[query, onUpdateQuery]
);
const getPanelDescription = useCallback(
(panel: PanelModel): string => {
const datasource = panel.datasource ?? defaultDatasource;
const dsname = getDatasourceSrv().getInstanceSettings(datasource)?.name;
const queryCount = panel.targets.length;
return `${queryCount} ${pluralize('query', queryCount)} to ${dsname}`;
},
[defaultDatasource]
);
const dashboard = getDashboardSrv().getCurrent();
const showTransforms = Boolean(query.withTransforms || panel?.transformations?.length);
const panels: Array<SelectableValue<number>> = useMemo(
() =>
dashboard?.panels
.filter(
(panel) =>
config.panels[panel.type] &&
panel.targets &&
panel.id !== dashboard.panelInEdit?.id &&
panel.datasource?.uid !== SHARED_DASHBOARD_QUERY
)
.map((panel) => ({
value: panel.id,
label: panel.title ?? 'Panel ' + panel.id,
description: getPanelDescription(panel),
imgUrl: config.panels[panel.type].info.logos.small,
})) ?? [],
[dashboard, getPanelDescription]
);
const styles = useStyles2(getStyles);
const selectId = useId();
if (!dashboard) {
return null;
}
if (panels.length < 1) {
return (
<p className={styles.noQueriesText}>
This dashboard does not have any other panels. Add queries to other panels and try again.
</p>
);
}
const selected = panels.find((panel) => panel.value === query.panelId);
return (
<>
<Field label="Source" description="Use the same results as panel">
<Select
inputId={selectId}
placeholder="Choose panel"
isSearchable={true}
options={panels}
value={selected}
onChange={(item) => onPanelChanged(item.value!)}
/>
</Field>
<HorizontalGroup height="auto" wrap={true} align="flex-start">
<Field
label="Data Source"
description="Use data or annotations from the panel"
className={styles.horizontalField}
>
<RadioButtonGroup options={topics} value={query.topic === DataTopic.Annotations} onChange={onTopicChanged} />
</Field>
{showTransforms && (
<Field label="Transform" description="Apply panel transformations from the source panel">
<Switch value={Boolean(query.withTransforms)} onChange={onTransformToggle} />
</Field>
)}
</HorizontalGroup>
{loadingResults ? (
<Spinner />
) : (
<>
{results && Boolean(results.length) && (
<Field label="Available queries from panel">
<VerticalGroup spacing="sm">
{results.map((target, i) => (
<Card key={`DashboardQueryRow-${i}`}>
<Card.Heading>{target.refId}</Card.Heading>
<Card.Figure>
<img src={target.img} alt={target.name} title={target.name} width={40} />
</Card.Figure>
<Card.Meta>{target.query}</Card.Meta>
</Card>
))}
</VerticalGroup>
</Field>
)}
</>
)}
</>
);
}
function getStyles(theme: GrafanaTheme2) {
return {
horizontalField: css({
marginRight: theme.spacing(2),
}),
noQueriesText: css({
padding: theme.spacing(1.25),
}),
};
}