Repository navigation
Welcome to the v0.3.0 release!
This release is about helping LLMs do more with Perses, while using fewer tokens and making fewer mistakes.
The highlight is a new set of Prometheus tools. Instead of calling the Prometheus API through the raw datasource proxy, the LLM can now discover the metric names, the label names and values, and the metadata of the metrics, then run a PromQL query and get a compact result: the value of each series for an instant query, and statistics per series (min, max, avg, last...) for a range query. For example, a range query over 6 hours returning 61 series is now about 3 KB instead of 240 KB. The MCP server also sends instructions to the MCP clients explaining how to combine these tools.
On the dashboard side, reading a dashboard returns a compact outline by default, and three new tools edit the panels, the variables or the layout of a dashboard without sending the complete dashboard again. To write valid dashboards, the LLM can also read the CUE schemas of the plugins installed in Perses, and validate a dashboard or a variable without saving it. Finally, Grafana dashboards can be migrated to Perses.
Except for the dashboard edit tools, all the new tools are read-only and stay available in read-only mode. They belong to four new resources, prometheus, schema, validate and migrate: if you restrict the tools with resources, add them to your configuration to use these tools.
This release also comes with breaking changes in the dashboard tools and in the datasource query tools. If your prompts, scripts or agents rely on their parameters or their responses, please read the [BREAKINGCHANGE] entries below.
The MCP server now has its own documentation, covering the installation, the setup of the MCP clients, the deployment, the configuration and all the tools.
- [FEATURE] Add the resource
migratewith the toolperses_migrate_dashboardto convert a Grafana dashboard into a Perses dashboard. When the MCP client supports elicitation, the user chooses whether to keep the datasources of the Grafana dashboard or to use the default datasource of Perses (#104) - [FEATURE] Add the resource
schemawith the toolsperses_list_plugin_schemasandperses_get_plugin_schemato get the CUE schemas of the plugins installed in Perses. Requires Perses v0.55 or later (#114) - [FEATURE] Add the resource
validatewith the toolsperses_validate_dashboardandperses_validate_variableto validate a resource without saving it (#115) - [FEATURE] Add the tools
perses_set_dashboard_panels,perses_set_dashboard_variablesandperses_set_dashboard_layoutto add, replace or remove panels, variables or panel groups without sending the complete dashboard (#118) - [FEATURE] Add the resource
prometheuswith the toolsperses_list_prometheus_metric_names,perses_list_prometheus_label_names,perses_list_prometheus_label_values,perses_get_prometheus_metric_metadataandperses_query_prometheusto discover and query the metrics of the Prometheus datasources with compact results (#135) - [FEATURE] Send instructions to the MCP clients on how to combine the tools, in particular the Prometheus ones. They only mention the registered tools (#136)
- [ENHANCEMENT]
perses_create_dashboardandperses_update_dashboard: adddry_runto validate the dashboard without saving it, andexpected_version(update only) to detect a dashboard modified in the meantime (#117) - [ENHANCEMENT] Tool responses no longer escape
<,>and&, so PromQL queries are returned as written (#131) - [BUGFIX] Docker images: expose the port 8000 used by the HTTP transport instead of 8080 (#110)
- [BUGFIX]
perses_create_project: accept descriptions with spaces (#111) - [BUGFIX]
perses_create_project_variable: set the value of the variable with the new parametervalue, instead of the name of the variable (#112) - [BUGFIX] Return a tool error instead of crashing the MCP server when a tool panics (#132)
- [BUGFIX] Exit with the status code 1 when the MCP transport fails, for example when the HTTP address is already in use (#133)
- [BREAKINGCHANGE]
perses_create_dashboardandperses_update_dashboard: the parameterdashboardis a JSON object instead of a JSON string, and the response is a short summary instead of the saved dashboard. Setinclude_dashboard: trueto get the saved dashboard (#117) - [BREAKINGCHANGE]
perses_get_dashboard_by_namereturns an outline of the dashboard by default: setsummary: falseto get the complete dashboard, orpanelsto get only some panels.perses_list_dashboardsreturns a summary of each dashboard instead of the complete dashboards (#117) - [BREAKINGCHANGE]
perses_query_project_datasourceandperses_query_global_datasourcereturn the response body of the datasource unchanged, instead of the object{status_code, headers, body}. An HTTP error status is now returned as a tool error (#126) - [DOC] Add the documentation of the MCP server (overview, installation, MCP clients, deployment, configuration and tools) and fix the configuration example of the README (#109)
What's Changed
- build(deps): Bump the gomod group across 1 directory with 2 updates by @dependabot[bot] in #101
- build(deps): Bump the gomod group with 2 updates by @dependabot[bot] in #102
- [FEATURE]: Add dashboard migration tool with elicitation support by @ibakshay in #104
- ci: bump golangci-lint to v2.14.0 and fix deprecated MCP server options by @ibakshay in #106
- build(deps): Bump perses/github-actions from 0.12.0 to 0.13.0 in the actions group across 1 directory by @dependabot[bot] in #103
- build(deps): Bump the gomod group across 1 directory with 2 updates by @dependabot[bot] in #105
- [IGNORE] bump perses/spec and perses/perses by @Nexucis in #108
- [DOC] Add the documentation of the MCP server by @Nexucis in #109
- [BUGFIX] Docker images: expose the port 8000 used by the HTTP transport by @Nexucis in #110
- [BUGFIX] perses_create_project: accept descriptions with spaces by @Nexucis in #111
- [BUGFIX] perses_create_project_variable: set the value of the variable by @Nexucis in #112
- fix(datasource): return the datasource response body unchanged from query tools by @ibakshay in #126
- Use shared helpers to build tool results by @ibakshay in #131
- feat: add plugin schema tools by @ibakshay in #114
- build(deps): Bump github.com/perses/common from 0.31.2 to 0.32.0 in the gomod group by @dependabot[bot] in #133
- feat: add dashboard and variable validation tools by @ibakshay in #115
- [IGNORE] bump perses/common to v0.33.0 by @Nexucis in #134
- fix(server): turn panics in tool handlers into tool errors by @ibakshay in #132
- feat: compact dashboard reads and safer create/update by @ibakshay in #117
- feat(dashboard): add incremental dashboard edit tools by @ibakshay in #118
- [FEATURE] add Prometheus discovery and query tools by @ibakshay in #135
- [FEATURE] add server instructions by @ibakshay in #136
Full Changelog: v0.2.0...v0.3.0