README
¶
Grafarg Plugin SDK for Go
This SDK enables building Grafarg backend plugins using Go.
Current state
This SDK is still in development. The protocol between the Grafarg server and the plugin SDK is considered stable, but we might introduce breaking changes in the SDK. This means that plugins using the older SDK should work with Grafarg, but might lose out on new features and capabilities that we introduce in the SDK.
Navigating the SDK
The SDK documentation can be navigated in the form of Go docs. In particular, you can find the following packages:
backend: Packagebackendprovides SDK handler interfaces and contracts for implementing and serving backend plugins. It includes multiple sub-packages.build: Packagebuildincludes standard mage targets useful when building plugins.data: Packagedataprovides data structures that Grafarg recognizes. It includes multiple subpackages likeconverters,framestructandsqlutil.experimental: Packageexperimentalprovides multiple experimental features. It includes multiple sub-packages.live: Packageliveprovides types for the Grafarg Live server.
See the list of all packages here.
Contributing
If you're interested in contributing to this project:
- Start by reading the Contributing guide.
- Learn how to set up your local environment, in our Developer guide.
License
Documentation
¶
Overview ¶
Package sdk is the root of the packages used to access Grafarg Plugin SDK for Go. See https://pkg.go.dev/github.com/famarker/grafarg-plugin-sdk-go for a full list of sub-packages.
Source Files
Directories
¶
| Path | Synopsis |
|---|---|
|
Package backend provides SDK handler interfaces and contracts for implementing and serving backend plugins.
|
Package backend provides SDK handler interfaces and contracts for implementing and serving backend plugins. |
|
app
Package app provides utilities for creating and serving a app plugin over gRPC.
|
Package app provides utilities for creating and serving a app plugin over gRPC. |
|
datasource
Package datasource provides utilities for creating and serving a data source plugin over gRPC.
|
Package datasource provides utilities for creating and serving a data source plugin over gRPC. |
|
grpcplugin
Package grpcplugin provides support for serving plugin over gRPC.
|
Package grpcplugin provides support for serving plugin over gRPC. |
|
httpclient
Package httpclient provides HTTP client and outgoing HTTP request middleware.
|
Package httpclient provides HTTP client and outgoing HTTP request middleware. |
|
instancemgmt
Package instancemgmt provides utilities for managing plugin instances.
|
Package instancemgmt provides utilities for managing plugin instances. |
|
log
Package log provides a logging interface to send logs from plugins to Grafarg server.
|
Package log provides a logging interface to send logs from plugins to Grafarg server. |
|
proxy
Package proxy provides utilities for updating a data source plugin connection to go through a proxy.
|
Package proxy provides utilities for updating a data source plugin connection to go through a proxy. |
|
resource
Package resource provides utils for handling resource calls.
|
Package resource provides utils for handling resource calls. |
|
resource/httpadapter
Package httpadapter provides support for handling resource calls using an http.Handler.
|
Package httpadapter provides support for handling resource calls using an http.Handler. |
|
Package build includes standard mage targets useful when building plugins.
|
Package build includes standard mage targets useful when building plugins. |
|
Package data provides data structures that Grafarg recognizes.
|
Package data provides data structures that Grafarg recognizes. |
|
converters
Package converters provides data.FieldConverters commonly used by plugins.
|
Package converters provides data.FieldConverters commonly used by plugins. |
|
framestruct
Package framestruct provides functions to convert from any type to *data.Frame or data.Frames
|
Package framestruct provides functions to convert from any type to *data.Frame or data.Frames |
|
sqlutil
Package sqlutil provides multiple utilities for working with SQL data sources.
|
Package sqlutil provides multiple utilities for working with SQL data sources. |
|
utils/jsoniter
Package jsoniter wraps json-iterator/go's Iterator methods with error returns so linting can catch unchecked errors.
|
Package jsoniter wraps json-iterator/go's Iterator methods with error returns so linting can catch unchecked errors. |
|
genproto
|
|
|
pluginv2
Package pluginv2 includes code generated by protoc-gen-go.
|
Package pluginv2 includes code generated by protoc-gen-go. |
|
Package live provides types for the Grafarg Live server.
|
Package live provides types for the Grafarg Live server. |
Click to show internal directories.
Click to hide internal directories.