Dashboard Migrations: V21 data links (#108950)

---------

Co-authored-by: Ivan Ortega <ivanortegaalba@gmail.com>
This commit is contained in:
Haris Rozajac
2025-08-08 08:55:32 +00:00
committed by GitHub
co-authored by Ivan Ortega
parent 99c7cd60e6
commit 8f2d27044d
5 changed files with 605 additions and 1 deletions
@@ -5,7 +5,7 @@ import (
)
const (
MIN_VERSION = 21
MIN_VERSION = 20
LATEST_VERSION = 41
)
@@ -38,6 +38,7 @@ type PanelPluginInfoProvider interface {
func GetMigrations(dsInfoProvider DataSourceInfoProvider, panelProvider PanelPluginInfoProvider) map[int]SchemaVersionMigrationFunc {
return map[int]SchemaVersionMigrationFunc{
21: V21,
22: V22,
23: V23,
24: V24(panelProvider),
@@ -0,0 +1,120 @@
package schemaversion
import (
"strings"
"github.com/grafana/grafana/apps/dashboard/pkg/migration/utils"
)
// V21 migrates data links to replace __series.labels with __field.labels.
// This migration updates the variable syntax used in data links from the old series-based
// syntax to the new field-based syntax.
//
// Example before migration:
//
// "panels": [
// {
// "options": {
// "dataLinks": [
// {
// "url": "http://example.com?series=${__series.labels}&${__series.labels.a}"
// }
// ],
// "fieldOptions": {
// "defaults": {
// "links": [
// {
// "url": "http://example.com?series=${__series.labels}&${__series.labels.x}"
// }
// ]
// }
// }
// }
// }
// ]
//
// Example after migration:
//
// "panels": [
// {
// "options": {
// "dataLinks": [
// {
// "url": "http://example.com?series=${__field.labels}&${__field.labels.a}"
// }
// ],
// "fieldOptions": {
// "defaults": {
// "links": [
// {
// "url": "http://example.com?series=${__field.labels}&${__field.labels.x}"
// }
// ]
// }
// }
// }
// }
// ]
func V21(dashboard map[string]interface{}) error {
dashboard["schemaVersion"] = 21
panels, ok := dashboard["panels"].([]interface{})
if !ok {
return nil
}
for _, p := range panels {
panel, ok := p.(map[string]interface{})
if !ok {
continue
}
// Update data links in panel options
if options, ok := panel["options"].(map[string]interface{}); ok {
updateDataLinks(options)
updateFieldOptionsLinks(options)
}
}
return nil
}
func updateDataLinks(options map[string]interface{}) {
dataLinks, ok := options["dataLinks"].([]interface{})
if !ok || !utils.IsArray(dataLinks) {
return
}
for _, link := range dataLinks {
if linkMap, ok := link.(map[string]interface{}); ok {
if url, ok := linkMap["url"].(string); ok {
linkMap["url"] = strings.ReplaceAll(url, "__series.labels", "__field.labels")
}
}
}
}
func updateFieldOptionsLinks(options map[string]interface{}) {
fieldOptions, ok := options["fieldOptions"].(map[string]interface{})
if !ok {
return
}
defaults, ok := fieldOptions["defaults"].(map[string]interface{})
if !ok {
return
}
links, ok := defaults["links"].([]interface{})
if !ok {
return
}
for _, link := range links {
if linkMap, ok := link.(map[string]interface{}); ok {
if url, ok := linkMap["url"].(string); ok {
linkMap["url"] = strings.ReplaceAll(url, "__series.labels", "__field.labels")
}
}
}
}
@@ -0,0 +1,232 @@
package schemaversion_test
import (
"testing"
"github.com/grafana/grafana/apps/dashboard/pkg/migration/schemaversion"
)
func TestV21(t *testing.T) {
tests := []migrationTestCase{
{
name: "panel with data links gets migrated",
input: map[string]interface{}{
"title": "V21 Data Links Migration Test Dashboard",
"schemaVersion": 20,
"panels": []interface{}{
map[string]interface{}{
"type": "timeseries",
"title": "Panel with data links",
"id": 1,
"options": map[string]interface{}{
"dataLinks": []interface{}{
map[string]interface{}{
"url": "http://mylink.com?series=${__series.labels}&${__series.labels.a}",
},
},
},
},
},
},
expected: map[string]interface{}{
"title": "V21 Data Links Migration Test Dashboard",
"schemaVersion": 21,
"panels": []interface{}{
map[string]interface{}{
"type": "timeseries",
"title": "Panel with data links",
"id": 1,
"options": map[string]interface{}{
"dataLinks": []interface{}{
map[string]interface{}{
"url": "http://mylink.com?series=${__field.labels}&${__field.labels.a}",
},
},
},
},
},
},
},
{
name: "panel with field options links gets migrated",
input: map[string]interface{}{
"title": "V21 Field Options Links Migration Test Dashboard",
"schemaVersion": 20,
"panels": []interface{}{
map[string]interface{}{
"type": "stat",
"title": "Panel with field options links",
"id": 2,
"options": map[string]interface{}{
"fieldOptions": map[string]interface{}{
"defaults": map[string]interface{}{
"links": []interface{}{
map[string]interface{}{
"url": "http://mylink.com?series=${__series.labels}&${__series.labels.x}",
},
},
},
},
},
},
},
},
expected: map[string]interface{}{
"title": "V21 Field Options Links Migration Test Dashboard",
"schemaVersion": 21,
"panels": []interface{}{
map[string]interface{}{
"type": "stat",
"title": "Panel with field options links",
"id": 2,
"options": map[string]interface{}{
"fieldOptions": map[string]interface{}{
"defaults": map[string]interface{}{
"links": []interface{}{
map[string]interface{}{
"url": "http://mylink.com?series=${__field.labels}&${__field.labels.x}",
},
},
},
},
},
},
},
},
},
{
name: "panel with both data links and field options links gets migrated",
input: map[string]interface{}{
"title": "V21 Both Links Migration Test Dashboard",
"schemaVersion": 20,
"panels": []interface{}{
map[string]interface{}{
"type": "graph",
"title": "Panel with both link types",
"id": 3,
"options": map[string]interface{}{
"dataLinks": []interface{}{
map[string]interface{}{
"url": "http://mylink.com?series=${__series.labels}",
},
},
"fieldOptions": map[string]interface{}{
"defaults": map[string]interface{}{
"links": []interface{}{
map[string]interface{}{
"url": "http://mylink.com?field=${__series.labels}",
},
},
},
},
},
},
},
},
expected: map[string]interface{}{
"title": "V21 Both Links Migration Test Dashboard",
"schemaVersion": 21,
"panels": []interface{}{
map[string]interface{}{
"type": "graph",
"title": "Panel with both link types",
"id": 3,
"options": map[string]interface{}{
"dataLinks": []interface{}{
map[string]interface{}{
"url": "http://mylink.com?series=${__field.labels}",
},
},
"fieldOptions": map[string]interface{}{
"defaults": map[string]interface{}{
"links": []interface{}{
map[string]interface{}{
"url": "http://mylink.com?field=${__field.labels}",
},
},
},
},
},
},
},
},
},
{
name: "panel without __series.labels is unchanged",
input: map[string]interface{}{
"title": "V21 No Series Labels Test Dashboard",
"schemaVersion": 20,
"panels": []interface{}{
map[string]interface{}{
"type": "timeseries",
"title": "Panel without series labels",
"id": 4,
"options": map[string]interface{}{
"dataLinks": []interface{}{
map[string]interface{}{
"url": "http://mylink.com?other=${__field.labels}",
},
},
},
},
},
},
expected: map[string]interface{}{
"title": "V21 No Series Labels Test Dashboard",
"schemaVersion": 21,
"panels": []interface{}{
map[string]interface{}{
"type": "timeseries",
"title": "Panel without series labels",
"id": 4,
"options": map[string]interface{}{
"dataLinks": []interface{}{
map[string]interface{}{
"url": "http://mylink.com?other=${__field.labels}",
},
},
},
},
},
},
},
{
name: "panel without options is unchanged",
input: map[string]interface{}{
"title": "V21 No Options Test Dashboard",
"schemaVersion": 20,
"panels": []interface{}{
map[string]interface{}{
"type": "timeseries",
"title": "Panel without options",
"id": 5,
},
},
},
expected: map[string]interface{}{
"title": "V21 No Options Test Dashboard",
"schemaVersion": 21,
"panels": []interface{}{
map[string]interface{}{
"type": "timeseries",
"title": "Panel without options",
"id": 5,
},
},
},
},
{
name: "dashboard without panels is unchanged",
input: map[string]interface{}{
"title": "V21 No Panels Test Dashboard",
"schemaVersion": 20,
},
expected: map[string]interface{}{
"title": "V21 No Panels Test Dashboard",
"schemaVersion": 21,
},
},
}
runMigrationTests(t, tests, schemaversion.V21)
}