;开发人员;构建插件;添加对Explore查询的支持

添加对Explore查询的支持

本指南解释如何改进对探索在现有的数据源插件中。

本指南假设您已经熟悉如何构建一个数据源插件

使用Explore,用户可以在不使用仪表板的情况下进行特别查询。当用户希望排除故障或了解有关数据的更多信息时,这非常有用。

默认情况下,数据源支持Explore,并使用数据源的现有查询编辑器。

添加一个特定于explorer的查询编辑器

要为数据源扩展Explore功能,可以定义一个特定于Explore的查询编辑器。

  1. 创建文件ExploreQueryEditor.tsxsrc你的插件目录,包含以下内容:

    import React fromimport {QueryEditorProps} from '@grafana/data';import {QueryField} from '@grafana/ui';import {DataSource} from './DataSource';import {MyQuery, MyDataSourceOptions} from './types';type Props = QueryEditorProps;export default (props: props) => {return 

    My explorer特定的查询编辑器

    ;};
  2. 中修改基本查询编辑器QueryEditor.tsx以呈现特定于explorer的查询编辑器。例如:

    / /[…import {CoreApp} from '@grafana/data';import ExploreQueryEditor from './ExploreQueryEditor';type Props = QueryEditorProps;export default (props: props) => {const {app} = props;switch (app) {case CoreApp。探索:return ; default: return 
    My base query editor
    ; } };

选择首选的可视化

Explore默认情况下应该为您的数据选择一个合理的可视化,这样用户就不必调整和玩弄可视化,只需关注查询。这通常工作得相当好,Explore可以确定返回的数据是时间序列数据还是日志或其他数据。

如果这对您不起作用,或者您想在特定的可视化中显示一些数据,请使用preferredVisualisationType元属性。

你可以用特定的元数据构造一个数据帧:

const firstResult = new MutableDataFrame({fields:[…]], meta: {preferredVisualisationType: 'logs',},});

有关可能的选项,请参阅PreferredVisualisationType