v0.243.0

What's Changed

• build(deps): bump go.opentelemetry.io/contrib/samplers/jaegerremote from 0.20.0 to 0.22.0 by @dependabot in #1033
• build(deps): bump github.com/prometheus/common from 0.54.0 to 0.55.0 by @dependabot in #1038
• build(deps): bump google.golang.org/grpc from 1.64.1 to 1.65.0 by @dependabot in #1034
• build(deps): bump golang.org/x/oauth2 from 0.21.0 to 0.22.0 by @dependabot in #1046
• build(deps): bump golang.org/x/net from 0.27.0 to 0.28.0 by @dependabot in #1047
• Add X-Grafana-Id header as const by @jkroepke in #1045
• API: Add ResourceConversion service by @toddtreece in #1044

New Contributors

• @jkroepke made their first contribution in #1045

Full Changelog: v0.242.0...v0.243.0

Compatibility

gorelease -base v0.242.0 -version v0.243.0
# github.com/grafana/grafana-plugin-sdk-go/backend
## incompatible changes
AdmissionHandler.ConvertObject: removed
ConversionRequest.Kind: removed
ConversionRequest.ObjectBytes: removed
ConversionRequest.TargetVersion: changed from string to GroupVersion
ConversionResponse.Allowed: removed
ConversionResponse.ObjectBytes: removed
ConvertObjectFunc: removed
## compatible changes
ConversionHandler: added
ConversionRequest.Objects: added
ConversionRequest.UID: added
ConversionResponse.Objects: added
ConversionResponse.UID: added
ConvertFromProtobuf.GroupVersion: added
ConvertFromProtobuf.RawObject: added
ConvertFromProtobuf.RawObjects: added
ConvertObjectsFunc: added
ConvertToProtobuf.GroupVersion: added
ConvertToProtobuf.RawObject: added
ConvertToProtobuf.RawObjects: added
GrafanaUserSignInTokenHeaderName: added
GroupVersion: added
RawObject: added
ServeOpts.ConversionHandler: added

# github.com/grafana/grafana-plugin-sdk-go/backend/app
## compatible changes
ManageOpts.ConversionHandler: added

# github.com/grafana/grafana-plugin-sdk-go/backend/datasource
## incompatible changes
github.com/grafana/grafana-plugin-sdk-go/backend.AdmissionHandler.ConvertObject, method set of *ServeOpts: removed
github.com/grafana/grafana-plugin-sdk-go/backend.AdmissionHandler.ConvertObject, method set of ServeOpts: removed
## compatible changes
ManageOpts.ConversionHandler: added
ServeOpts.ConversionHandler: added
github.com/grafana/grafana-plugin-sdk-go/backend.ConversionHandler.ConvertObjects: added

# github.com/grafana/grafana-plugin-sdk-go/backend/grpcplugin
## incompatible changes
github.com/grafana/grafana-plugin-sdk-go/genproto/pluginv2.AdmissionControlClient.ConvertObject, method set of AdmissionClient: removed
github.com/grafana/grafana-plugin-sdk-go/genproto/pluginv2.AdmissionControlServer.ConvertObject, method set of AdmissionServer: removed
github.com/grafana/grafana-plugin-sdk-go/genproto/pluginv2.ResourceClient.CallResource: changed from func(context.Context, *github.com/grafana/grafana-plugin-sdk-go/genproto/pluginv2.CallResourceRequest, ...google.golang.org/grpc.CallOption) (github.com/grafana/grafana-plugin-sdk-go/genproto/pluginv2.Resource_CallResourceClient, error) to func(context.Context, *github.com/grafana/grafana-plugin-sdk-go/genproto/pluginv2.CallResourceRequest, ...google.golang.org/grpc.CallOption) (google.golang.org/grpc.ServerStreamingClient[github.com/grafana/grafana-plugin-sdk-go/genproto/pluginv2.CallResourceResponse], error)
github.com/grafana/grafana-plugin-sdk-go/genproto/pluginv2.ResourceServer.CallResource: changed from func(*github.com/grafana/grafana-plugin-sdk-go/genproto/pluginv2.CallResourceRequest, github.com/grafana/grafana-plugin-sdk-go/genproto/pluginv2.Resource_CallResourceServer) error to func(*github.com/grafana/grafana-plugin-sdk-go/genproto/pluginv2.CallResourceRequest, google.golang.org/grpc.ServerStreamingServer[github.com/grafana/grafana-plugin-sdk-go/genproto/pluginv2.CallResourceResponse]) error
github.com/grafana/grafana-plugin-sdk-go/genproto/pluginv2.StreamClient.RunStream: changed from func(context.Context, *github.com/grafana/grafana-plugin-sdk-go/genproto/pluginv2.RunStreamRequest, ...google.golang.org/grpc.CallOption) (github.com/grafana/grafana-plugin-sdk-go/genproto/pluginv2.Stream_RunStreamClient, error) to func(context.Context, *github.com/grafana/grafana-plugin-sdk-go/genproto/pluginv2.RunStreamRequest, ...google.golang.org/grpc.CallOption) (google.golang.org/grpc.ServerStreamingClient[github.com/grafana/grafana-plugin-sdk-go/genproto/pluginv2.StreamPacket], error)
github.com/grafana/grafana-plugin-sdk-go/genproto/pluginv2.StreamServer.RunStream: changed from func(*github.com/grafana/grafana-plugin-sdk-go/genproto/pluginv2.RunStreamRequest, github.com/grafana/grafana-plugin-sdk-go/genproto/pluginv2.Stream_RunStreamServer) error to func(*github.com/grafana/grafana-plugin-sdk-go/genproto/pluginv2.RunStreamRequest, google.golang.org/grpc.ServerStreamingServer[github.com/grafana/grafana-plugin-sdk-go/genproto/pluginv2.StreamPacket]) error
## compatible changes
ConversionClient: added
ConversionGRPCPlugin: added
ConversionServer: added
ServeOpts.ConversionServer: added

# github.com/grafana/grafana-plugin-sdk-go/genproto/pluginv2
## incompatible changes
(*ConversionRequest).GetKind: removed
(*ConversionRequest).GetObjectBytes: removed
(*ConversionRequest).GetTargetVersion: changed from func() string to func() *GroupVersion
(*ConversionResponse).GetAllowed: removed
(*ConversionResponse).GetObjectBytes: removed
AdmissionControlClient.ConvertObject: removed
AdmissionControlServer.ConvertObject: removed
AdmissionControl_ConvertObject_FullMethodName: removed
ConversionRequest.Kind: removed
ConversionRequest.ObjectBytes: removed
ConversionRequest.TargetVersion: changed from string to *GroupVersion
ConversionResponse.Allowed: removed
ConversionResponse.ObjectBytes: removed
ResourceClient.CallResource: changed from func(context.Context, *CallResourceRequest, ...google.golang.org/grpc.CallOption) (Resource_CallResourceClient, error) to func(context.Context, *CallResourceRequest, ...google.golang.org/grpc.CallOption) (google.golang.org/grpc.ServerStreamingClient[CallResourceResponse], error)
ResourceServer.CallResource: changed from func(*CallResourceRequest, Resource_CallResourceServer) error to func(*CallResourceRequest, google.golang.org/grpc.ServerStreamingServer[CallResourceResponse]) error
Resource_CallResourceClient: changed from Resource_CallResourceClient to google.golang.org/grpc.ServerStreamingClient[CallResourceResponse]
Resource_CallResourceServer: changed from Resource_CallResourceServer to google.golang.org/grpc.ServerStreamingServer[CallResourceResponse]
StreamClient.RunStream: changed from func(context.Context, *RunStreamRequest, ...google.golang.org/grpc.CallOption) (Stream_RunStreamClient, error) to func(context.Context, *RunStreamRequest, ...google.golang.org/grpc.CallOption) (google.golang.org/grpc.ServerStreamingClient[StreamPacket], error)
StreamServer.RunStream: changed from func(*RunStreamRequest, Stream_RunStreamServer) error to func(*RunStreamRequest, google.golang.org/grpc.ServerStreamingServer[StreamPacket]) error
Stream_RunStreamClient: changed from Stream_RunStreamClient to google.golang.org/grpc.ServerStreamingClient[StreamPacket]
Stream_RunStreamServer: changed from Stream_RunStreamServer to google.golang.org/grpc.ServerStreamingServer[StreamPacket]
UnimplementedAdmissionControlServer.ConvertObject: removed
UnimplementedResourceServer.CallResource: changed from func(*CallResourceRequest, Resource_CallResourceServer) error to func(*CallResourceRequest, google.golang.org/grpc.ServerStreamingServer[CallResourceResponse]) error
UnimplementedStreamServer.RunStream: changed from func(*RunStreamRequest, Stream_RunStreamServer) error to func(*RunStreamRequest, google.golang.org/grpc.ServerStreamingServer[StreamPacket]) error
## compatible changes
(*ConversionRequest).GetObjects: added
(*ConversionRequest).GetUid: added
(*ConversionResponse).GetObjects: added
(*ConversionResponse).GetUid: added
ConversionRequest.Objects: added
ConversionRequest.Uid: added
ConversionResponse.Objects: added
ConversionResponse.Uid: added
GroupVersion: added
NewResourceConversionClient: added
RawObject: added
RegisterResourceConversionServer: added
ResourceConversionClient: added
ResourceConversionServer: added
ResourceConversion_ConvertObjects_FullMethodName: added
ResourceConversion_ServiceDesc: added
UnimplementedResourceConversionServer: added
UnsafeResourceConversionServer: added

# summary
v0.243.0 is a valid semantic version for this release.

v0.242.0

What's Changed

• Build: Fix plugins not reloading correctly on dev mode by @academo in #1039

Full Changelog: v0.241.0...v0.242.0

Compatibility

gorelease -base=v0.241.0 -version=v0.242.0
# summary
v0.242.0 is a valid semantic version for this release.

v0.241.0

What's Changed

• build(deps): bump golang.org/x/oauth2 from 0.20.0 to 0.21.0 by @dependabot in #1031
• build(deps): bump golang.org/x/net from 0.26.0 to 0.27.0 by @dependabot in #1035
• Return appropriate status type plugin request status handler func by @wbrowne in #1036

Full Changelog: v0.240.0...v0.241.0

Compatibility

gorelease -base=v0.240.0 -version=v0.241.0
# summary
v0.241.0 is a valid semantic version for this release.

v0.240.0

What's Changed

• Instrumentation: Improve automatic instrumentation by the SDK to include handler/request logs, metrics and traces by @marefr in #1028

Full Changelog: v0.239.0...v0.240.0

Compatibility

gorelease -base v0.239.0 -version v0.240.0
# github.com/grafana/grafana-plugin-sdk-go/backend
## compatible changes
DefaultErrorSource: added
DownstreamError: added
DownstreamErrorf: added
Endpoint.String: added
IsDownstreamError: added
RequestStatus: added
RequestStatusCancelled: added
RequestStatusError: added
RequestStatusFromError: added
RequestStatusFromErrorString: added
RequestStatusFromProtoQueryDataResponse: added
RequestStatusFromQueryDataResponse: added
RequestStatusOK: added
WithDownstreamErrorSource: added
WithErrorSource: added

# github.com/grafana/grafana-plugin-sdk-go/backend/tracing
## compatible changes
Error: added
Errorf: added

# github.com/grafana/grafana-plugin-sdk-go/experimental/errorsource
## compatible changes
Error.ErrorSource: added

# summary
v0.240.0 is a valid semantic version for this release.

v0.239.0

What's Changed

• build(deps): bump google.golang.org/grpc from 1.64.0 to 1.64.1 by @dependabot in #1026
• Tracing: Helper function to retrieve trace ID from context by @njvrzm in #1027

Full Changelog: v0.238.0...v0.239.0

Compatibility

gorelease -base v0.238.0 -version v0.239.0
# github.com/grafana/grafana-plugin-sdk-go/backend/tracing
## compatible changes
TraceIDFromContext: added

# summary
v0.239.0 is not a valid semantic version for this release.
version v0.239.0 already exists

v0.238.0

What's Changed

• Profiling: Replace contention env variable with block and mutex rate by @marefr in #1025

Breaking changes

Removes support for the environment variable GF_PLUGIN_PROFILING_CONTENTION and the variable backend.PluginProfilingContentionEnv introduced in v0.235.0. This is an internal change and was recently introduced and therefore shouldn't affect anyone.

Full Changelog: v0.237.0...v0.238.0

Compatibility

gorelease -base v0.237.0 -version v0.238.0
# github.com/grafana/grafana-plugin-sdk-go/backend
## incompatible changes
PluginProfilingContentionEnv: removed
## compatible changes
PluginProfilingBlockRateEnv: added
PluginProfilingMutexRateEnv: added

# summary
v0.238.0 is a valid semantic version for this release.

v0.237.0

What's Changed

• Backend handlers: Catch panics by @andresmgot in #1010
• DataQueryClient: Handle kube-style error responses by @alexweav in #1012
• httpadapter: Deprecate PluginConfigFromContext and UserFromContext by @marefr in #1017
• Deprecate datasource.Serve and backend.Serve by @marefr in #1018
• Expose endpoint/handler names and update adapters to use the same "middleware" by @marefr in #1016
• build(deps): bump go.opentelemetry.io/contrib/instrumentation/net/http/httptrace/otelhttptrace from 0.51.0 to 0.53.0 by @dependabot in #1020
• build(deps): bump go.opentelemetry.io/otel/exporters/otlp/otlptrace from 1.26.0 to 1.28.0 by @dependabot in #1021
• build(deps): bump go.opentelemetry.io/otel/exporters/otlp/otlptrace/otlptracegrpc from 1.26.0 to 1.28.0 by @dependabot in #1022
• build(deps): bump go.opentelemetry.io/contrib/propagators/jaeger from 1.26.0 to 1.28.0 by @dependabot in #1023
• Chore: Regenerate protos by @marefr in #1024

Deprecation changes

• The functions httpadapter.PluginConfigFromContext and httpadapter.UserFromContext has been marked as deprecated and might be removed in the future. Please use backend.PluginConfigFromContext and backend.UserFromContext instead.
• The functions datasource.Serve and backend.Serve has been marked as deprecated and might be removed in the future. Please use datasource.Manage instead, see https://github.com/grafana/grafana-plugin-examples/blob/main/examples/datasource-basic/pkg/main.go#L20 for an example.

New Contributors

• @alexweav made their first contribution in #1012

Full Changelog: v0.236.0...v0.237.0

Compatibility

gorelease -base v0.236.0 -version v0.237.0
# github.com/grafana/grafana-plugin-sdk-go/backend
## compatible changes
CallResourceResponseSenderFunc: added
Endpoint: added
EndpointCallResource: added
EndpointCheckHealth: added
EndpointCollectMetrics: added
EndpointConvertObject: added
EndpointFromContext: added
EndpointMutateAdmission: added
EndpointPublishStream: added
EndpointQueryData: added
EndpointRunStream: added
EndpointSubscribeStream: added
EndpointValidateAdmission: added
PluginConfigFromContext: added
UserFromContext: added
WithEndpoint: added
WithPluginContext: added
WithUser: added

# github.com/grafana/grafana-plugin-sdk-go/experimental/apis/data/v0alpha1
## compatible changes
ErrTransport: added
Status: added

# summary
v0.237.0 is a valid semantic version for this release.

v0.236.0

What's Changed

• build(deps): bump github.com/prometheus/client_golang from 1.19.0 to 1.19.1 by @dependabot in #985
• build(deps): bump github.com/prometheus/common from 0.53.0 to 0.54.0 by @dependabot in #1008
• Nested plugin binaries are output to their respective directories by @wbrowne in #1007

Full Changelog: v0.235.0...v0.236.0

Compatibility

gorelease -base=v0.235.0 -version=v0.236.0
# summary
v0.236.0 is a valid semantic version for this release.

v0.235.0

What's Changed

• slo - capture plugin duration for http based plugins by @scottlepp in #998
• Remove restriction for executable relative file path for nested datasource plugins by @wbrowne in #1005
• Enhance profiling and allow traces to profiles by @marefr in #1006

Full Changelog: v0.234.0...v0.235.0

Compatibility

gorelease -base=v0.234.0 -version=v0.235.0      
# github.com/grafana/grafana-plugin-sdk-go/backend
## compatible changes
PluginProfilingContentionEnv: added

# github.com/grafana/grafana-plugin-sdk-go/experimental/slo
## compatible changes
AddMiddleware: added
Collector: added
Duration: added
DurationKey: added
Endpoint: added
EndpointHealth: added
EndpointQuery: added
EndpointResource: added
FromStatus: added
Metrics: added
MetricsWrapper: added
NewClient: added
NewDuration: added
NewMetrics: added
NewMetricsWrapper: added
Source: added
SourceDownstream: added
SourcePlugin: added
Status: added
StatusError: added
StatusOK: added

# github.com/grafana/grafana-plugin-sdk-go/experimental/slo/test
## compatible changes
package added

# summary
v0.235.0 is a valid semantic version for this release.

v0.234.0

What's Changed

• Arrow: Expose frame to arrow.Table utility function by @ryantxu in #1002
• Chore: Move last pieces from Grafana's legacydata package into the SDK by @marefr in #1003

Full Changelog: v0.233.0...v0.234.0

Compatibility

gorelease -base v0.233.0 -version v0.234.0
# github.com/grafana/grafana-plugin-sdk-go/backend/gtime
## compatible changes
NewTimeRange: added
TimeRange: added
TimeRangeOption: added
WithFiscalStartMonth: added
WithLocation: added
WithNow: added
WithRoundUp: added
WithWeekstart: added

# github.com/grafana/grafana-plugin-sdk-go/data
## compatible changes
FrameToArrowTable: added

# github.com/grafana/grafana-plugin-sdk-go/experimental/apis/data/v0alpha1
## compatible changes
ToDataSourceQueries: added

# summary
v0.234.0 is a valid semantic version for this release.