[FEATURE] Add GreptimeDB datasource Plugin

[sunchanglong]

Description

This pull request adds a new GreptimeDB plugin to the plugins repository so Perses can query and visualize metrics & logs data from GreptimeDB.

The implementation covers the main GreptimeDB query workflows used in Perses dashboards:

querying time series data from GreptimeDB based on panel time range
converting GreptimeDB responses into the data format expected by Perses panels, so charts and related visual components can consume results without additional handling

A few points worth calling out for review:

GreptimeDB response data is normalized and mapped into Perses-compatible series/frames, including timestamps, values, and label dimensions
plugin schemas, SDK integration helpers, datasource configuration, query editor support, and tests are included in the same change
only files required for the GreptimeDB plugin and workspace/plugin registration were touched
This change is intended to address GreptimeDB datasource support discussed in the linked issue and related follow-up conversations.

Screenshots

Checklist

• Pull request has a descriptive title and context useful to a reviewer.
• Pull request title follows the [<catalog_entry>] <commit message> naming convention using one of the
  following catalog_entry values: FEATURE, ENHANCEMENT, BUGFIX, BREAKINGCHANGE, DOC,IGNORE.
• All commits have DCO signoffs.

UI Changes

• Changes that impact the UI include screenshots and/or screencasts of the relevant changes.
• Code follows the UI guidelines.

[sunchanglong]

The CI workflow failure seems unrelated to the changes in this PR.
Could you please try rerunning the job？

[sunchanglong]

Added GreptimeDBResponseData to refine the unknown types. This ensures better type safety and clarifies the expected data structure from GreptimeDB.

[sunchanglong]

Hi team, @jgbernalp we have addressed most review issues could you please check again.
We're using the Perses GreptimeDB plugin in our project: dashboard

[sunchanglong]

the CI error was caused by perses-dev peerDependencies upgration, should be fixed

[jgbernalp]

Code review

Found 1 issue:

1. Missing Trace Explorer plugin registration and export. The GreptimeDBTraceExplorer component is fully implemented in src/explore/ but is never exported from src/index.ts and not registered in package.json under perses.plugins with kind: "Explore". Without these, the explorer is inaccessible to users. Compare with the Tempo plugin which exports explore at src/index.ts:16 and registers it at package.json:79-86.

greptimedb/src/index.ts is missing export * from './explore';:
https://github.com/perses/plugins/blob/21a1d260f3884018719a27554fdaaeeb87f9e140/greptimedb/src/index.ts#L13-L17

greptimedb/package.json is missing an Explore plugin entry (compare with Tempo's registration):

plugins/greptimedb/package.json

Lines 44 to 85 in 21a1d26

	"perses": {
	"moduleName": "GreptimeDB",
	"schemasPath": "schemas",
	"plugins": [
	{
	"kind": "Datasource",
	"spec": {
	"display": {
	"name": "GreptimeDB Datasource"
	},
	"name": "GreptimeDBDatasource"
	}
	},
	{
	"kind": "TimeSeriesQuery",
	"spec": {
	"display": {
	"name": "GreptimeDB Time Series Query"
	},
	"name": "GreptimeDBTimeSeriesQuery"
	}
	},
	{
	"kind": "LogQuery",
	"spec": {
	"display": {
	"name": "GreptimeDB Log Query"
	},
	"name": "GreptimeDBLogQuery"
	}
	},
	{
	"kind": "TraceQuery",
	"spec": {
	"display": {
	"name": "GreptimeDB Trace Query"
	},
	"name": "GreptimeDBTraceQuery"
	}
	}
	]
	}

The component exists but is dead code without proper wiring:

plugins/greptimedb/src/explore/GreptimeDBTraceExplorer.tsx

Lines 1 to 5 in 21a1d26

	// Copyright The Perses Authors
	// Licensed under the Apache License, Version 2.0 (the "License");
	// you may not use this file except in compliance with the License.
	// You may obtain a copy of the License at
	//

Reference: Tempo plugin's correct pattern:

plugins/tempo/src/index.ts

Lines 14 to 18 in 21a1d26

	export { getPluginModule } from './getPluginModule';
	export * from './components';
	export * from './explore';
	export * from './model';
	export * from './plugins';

plugins/tempo/package.json

Lines 78 to 87 in 21a1d26

	{
	"kind": "Explore",
	"spec": {
	"display": {
	"name": "Tempo Traces Explorer"
	},
	"name": "TempoExplorer"
	}
	}
	]

🤖 Generated with Claude Code

[sunchanglong]

Code review

Found 1 issue:

1. Missing Trace Explorer plugin registration and export. The GreptimeDBTraceExplorer component is fully implemented in src/explore/ but is never exported from src/index.ts and not registered in package.json under perses.plugins with kind: "Explore". Without these, the explorer is inaccessible to users. Compare with the Tempo plugin which exports explore at src/index.ts:16 and registers it at package.json:79-86.

greptimedb/src/index.ts is missing export * from './explore';: https://github.com/perses/plugins/blob/21a1d260f3884018719a27554fdaaeeb87f9e140/greptimedb/src/index.ts#L13-L17

greptimedb/package.json is missing an Explore plugin entry (compare with Tempo's registration):

plugins/greptimedb/package.json

Lines 44 to 85 in 21a1d26

	"perses": {
	"moduleName": "GreptimeDB",
	"schemasPath": "schemas",
	"plugins": [
	{
	"kind": "Datasource",
	"spec": {
	"display": {
	"name": "GreptimeDB Datasource"
	},
	"name": "GreptimeDBDatasource"
	}
	},
	{
	"kind": "TimeSeriesQuery",
	"spec": {
	"display": {
	"name": "GreptimeDB Time Series Query"
	},
	"name": "GreptimeDBTimeSeriesQuery"
	}
	},
	{
	"kind": "LogQuery",
	"spec": {
	"display": {
	"name": "GreptimeDB Log Query"
	},
	"name": "GreptimeDBLogQuery"
	}
	},
	{
	"kind": "TraceQuery",
	"spec": {
	"display": {
	"name": "GreptimeDB Trace Query"
	},
	"name": "GreptimeDBTraceQuery"
	}
	}
	]
	}

The component exists but is dead code without proper wiring:

plugins/greptimedb/src/explore/GreptimeDBTraceExplorer.tsx

Lines 1 to 5 in 21a1d26

	// Copyright The Perses Authors
	// Licensed under the Apache License, Version 2.0 (the "License");
	// you may not use this file except in compliance with the License.
	// You may obtain a copy of the License at
	//

Reference: Tempo plugin's correct pattern:

plugins/tempo/src/index.ts

Lines 14 to 18 in 21a1d26

	export { getPluginModule } from './getPluginModule';
	export * from './components';
	export * from './explore';
	export * from './model';
	export * from './plugins';

plugins/tempo/package.json

Lines 78 to 87 in 21a1d26

	{
	"kind": "Explore",
	"spec": {
	"display": {
	"name": "Tempo Traces Explorer"
	},
	"name": "TempoExplorer"
	}
	}
	]

🤖 Generated with Claude Code

yes, it is a knowned issue.
To keep this PR clean and avoid delaying the review, we've left Trace Explorer out for now, especially since we don't have an immediate need for it. We plan to follow up and open another PR for it in a future release, unless you prefer having it included now.

[jgbernalp]

@sunchanglong in that case, please remove the dead code and create an GitHub issue for later implementation

[sunchanglong]

the dead code has been removed.
#660 the issue has been recorded here