Documentation
¶
Index ¶
- Constants
- Variables
- type Client
- func (c *Client) AddDashboardCell(ctx context.Context, id platform.ID, cell *platform.Cell, ...) error
- func (c *Client) Close() error
- func (c *Client) CreateAuthorization(ctx context.Context, a *platform.Authorization) error
- func (c *Client) CreateBucket(ctx context.Context, b *platform.Bucket) error
- func (c *Client) CreateDashboard(ctx context.Context, d *platform.Dashboard) error
- func (c *Client) CreateOrganization(ctx context.Context, o *platform.Organization) error
- func (c *Client) CreateSource(ctx context.Context, s *platform.Source) error
- func (c *Client) CreateUser(ctx context.Context, u *platform.User) error
- func (c *Client) CreateView(ctx context.Context, d *platform.View) error
- func (c *Client) DB() *bolt.DB
- func (c *Client) DefaultSource(ctx context.Context) (*platform.Source, error)
- func (c *Client) DeleteAuthorization(ctx context.Context, id platform.ID) error
- func (c *Client) DeleteBucket(ctx context.Context, id platform.ID) error
- func (c *Client) DeleteDashboard(ctx context.Context, id platform.ID) error
- func (c *Client) DeleteOrganization(ctx context.Context, id platform.ID) error
- func (c *Client) DeleteSource(ctx context.Context, id platform.ID) error
- func (c *Client) DeleteUser(ctx context.Context, id platform.ID) error
- func (c *Client) DeleteView(ctx context.Context, id platform.ID) error
- func (c *Client) FindAuthorizationByID(ctx context.Context, id platform.ID) (*platform.Authorization, error)
- func (c *Client) FindAuthorizationByToken(ctx context.Context, n string) (*platform.Authorization, error)
- func (c *Client) FindAuthorizations(ctx context.Context, filter platform.AuthorizationFilter, ...) ([]*platform.Authorization, int, error)
- func (c *Client) FindBucket(ctx context.Context, filter platform.BucketFilter) (*platform.Bucket, error)
- func (c *Client) FindBucketByID(ctx context.Context, id platform.ID) (*platform.Bucket, error)
- func (c *Client) FindBucketByName(ctx context.Context, orgID platform.ID, n string) (*platform.Bucket, error)
- func (c *Client) FindBuckets(ctx context.Context, filter platform.BucketFilter, opt ...platform.FindOptions) ([]*platform.Bucket, int, error)
- func (c *Client) FindDashboard(ctx context.Context, filter platform.DashboardFilter) (*platform.Dashboard, error)
- func (c *Client) FindDashboardByID(ctx context.Context, id platform.ID) (*platform.Dashboard, error)
- func (c *Client) FindDashboards(ctx context.Context, filter platform.DashboardFilter) ([]*platform.Dashboard, int, error)
- func (c *Client) FindOrganization(ctx context.Context, filter platform.OrganizationFilter) (*platform.Organization, error)
- func (c *Client) FindOrganizationByID(ctx context.Context, id platform.ID) (*platform.Organization, error)
- func (c *Client) FindOrganizationByName(ctx context.Context, n string) (*platform.Organization, error)
- func (c *Client) FindOrganizations(ctx context.Context, filter platform.OrganizationFilter, ...) ([]*platform.Organization, int, error)
- func (c *Client) FindSourceByID(ctx context.Context, id platform.ID) (*platform.Source, error)
- func (c *Client) FindSources(ctx context.Context, opt platform.FindOptions) ([]*platform.Source, int, error)
- func (c *Client) FindUser(ctx context.Context, filter platform.UserFilter) (*platform.User, error)
- func (c *Client) FindUserByID(ctx context.Context, id platform.ID) (*platform.User, error)
- func (c *Client) FindUserByName(ctx context.Context, n string) (*platform.User, error)
- func (c *Client) FindUsers(ctx context.Context, filter platform.UserFilter, opt ...platform.FindOptions) ([]*platform.User, int, error)
- func (c *Client) FindView(ctx context.Context, filter platform.ViewFilter) (*platform.View, error)
- func (c *Client) FindViewByID(ctx context.Context, id platform.ID) (*platform.View, error)
- func (c *Client) FindViews(ctx context.Context, filter platform.ViewFilter) ([]*platform.View, int, error)
- func (c *Client) Open(ctx context.Context) error
- func (c *Client) PutAuthorization(ctx context.Context, a *platform.Authorization) error
- func (c *Client) PutBucket(ctx context.Context, b *platform.Bucket) error
- func (c *Client) PutDashboard(ctx context.Context, d *platform.Dashboard) error
- func (c *Client) PutOrganization(ctx context.Context, o *platform.Organization) error
- func (c *Client) PutSource(ctx context.Context, s *platform.Source) error
- func (c *Client) PutUser(ctx context.Context, u *platform.User) error
- func (c *Client) PutView(ctx context.Context, d *platform.View) error
- func (c *Client) RemoveDashboardCell(ctx context.Context, dashboardID, cellID platform.ID) error
- func (c *Client) ReplaceDashboardCells(ctx context.Context, id platform.ID, cs []*platform.Cell) error
- func (c *Client) SetAuthorizationStatus(ctx context.Context, id platform.ID, status platform.Status) error
- func (c *Client) UpdateBucket(ctx context.Context, id platform.ID, upd platform.BucketUpdate) (*platform.Bucket, error)
- func (c *Client) UpdateDashboard(ctx context.Context, id platform.ID, upd platform.DashboardUpdate) (*platform.Dashboard, error)
- func (c *Client) UpdateDashboardCell(ctx context.Context, dashboardID, cellID platform.ID, upd platform.CellUpdate) (*platform.Cell, error)
- func (c *Client) UpdateOrganization(ctx context.Context, id platform.ID, upd platform.OrganizationUpdate) (*platform.Organization, error)
- func (c *Client) UpdateSource(ctx context.Context, id platform.ID, upd platform.SourceUpdate) (*platform.Source, error)
- func (c *Client) UpdateUser(ctx context.Context, id platform.ID, upd platform.UserUpdate) (*platform.User, error)
- func (c *Client) UpdateView(ctx context.Context, id platform.ID, upd platform.ViewUpdate) (*platform.View, error)
- func (c *Client) WithLogger(l *zap.Logger)
Constants ¶
const ( // ErrUnableToOpen means we had an issue establishing a connection (or creating the database) ErrUnableToOpen = "Unable to open boltdb; is there a chronograf already running? %v" // ErrUnableToBackup means we couldn't copy the db file into ./backup ErrUnableToBackup = "Unable to backup your database prior to migrations: %v" // ErrUnableToInitialize means we couldn't create missing Buckets (maybe a timeout) ErrUnableToInitialize = "Unable to boot boltdb: %v" // ErrUnableToMigrate means we had an issue changing the db schema ErrUnableToMigrate = "Unable to migrate boltdb: %v" )
Variables ¶
var DefaultSource = platform.Source{ Default: true, Name: "autogen", Type: platform.SelfSourceType, }
DefaultSource is the default source.
Functions ¶
This section is empty.
Types ¶
type Client ¶
type Client struct {
Path string
Logger *zap.Logger
IDGenerator platform.IDGenerator
TokenGenerator platform.TokenGenerator
// contains filtered or unexported fields
}
Client is a client for the boltDB data store.
func (*Client) AddDashboardCell ¶
func (c *Client) AddDashboardCell(ctx context.Context, id platform.ID, cell *platform.Cell, opts platform.AddDashboardCellOptions) error
AddDashboardCell adds a cell to a dashboard and sets the cells ID.
func (*Client) CreateAuthorization ¶
CreateAuthorization creates a platform authorization and sets b.ID, and b.UserID if not provided.
func (*Client) CreateBucket ¶
CreateBucket creates a platform bucket and sets b.ID.
func (*Client) CreateDashboard ¶
CreateDashboard creates a platform dashboard and sets d.ID.
func (*Client) CreateOrganization ¶
CreateOrganization creates a platform organization and sets b.ID.
func (*Client) CreateSource ¶
CreateSource creates a platform source and sets s.ID.
func (*Client) CreateUser ¶
CreateUser creates a platform user and sets b.ID.
func (*Client) CreateView ¶
CreateView creates a platform view and sets d.ID.
func (*Client) DefaultSource ¶
DefaultSource retrieves the default source.
func (*Client) DeleteAuthorization ¶
DeleteAuthorization deletes a authorization and prunes it from the index.
func (*Client) DeleteBucket ¶
DeleteBucket deletes a bucket and prunes it from the index.
func (*Client) DeleteDashboard ¶
DeleteDashboard deletes a dashboard and prunes it from the index.
func (*Client) DeleteOrganization ¶
DeleteOrganization deletes a organization and prunes it from the index.
func (*Client) DeleteSource ¶
DeleteSource deletes a source and prunes it from the index.
func (*Client) DeleteUser ¶
DeleteUser deletes a user and prunes it from the index.
func (*Client) DeleteView ¶
DeleteView deletes a view and prunes it from the index.
func (*Client) FindAuthorizationByID ¶
func (c *Client) FindAuthorizationByID(ctx context.Context, id platform.ID) (*platform.Authorization, error)
FindAuthorizationByID retrieves a authorization by id.
func (*Client) FindAuthorizationByToken ¶
func (c *Client) FindAuthorizationByToken(ctx context.Context, n string) (*platform.Authorization, error)
FindAuthorizationByToken returns a authorization by token for a particular authorization.
func (*Client) FindAuthorizations ¶
func (c *Client) FindAuthorizations(ctx context.Context, filter platform.AuthorizationFilter, opt ...platform.FindOptions) ([]*platform.Authorization, int, error)
FindAuthorizations retrives all authorizations that match an arbitrary authorization filter. Filters using ID, or Token should be efficient. Other filters will do a linear scan across all authorizations searching for a match.
func (*Client) FindBucket ¶
func (c *Client) FindBucket(ctx context.Context, filter platform.BucketFilter) (*platform.Bucket, error)
FindBucket retrives a bucket using an arbitrary bucket filter. Filters using ID, or OrganizationID and bucket Name should be efficient. Other filters will do a linear scan across buckets until it finds a match.
func (*Client) FindBucketByID ¶
FindBucketByID retrieves a bucket by id.
func (*Client) FindBucketByName ¶
func (c *Client) FindBucketByName(ctx context.Context, orgID platform.ID, n string) (*platform.Bucket, error)
FindBucketByName returns a bucket by name for a particular organization. TODO: have method for finding bucket using organization name and bucket name.
func (*Client) FindBuckets ¶
func (c *Client) FindBuckets(ctx context.Context, filter platform.BucketFilter, opt ...platform.FindOptions) ([]*platform.Bucket, int, error)
FindBuckets retrives all buckets that match an arbitrary bucket filter. Filters using ID, or OrganizationID and bucket Name should be efficient. Other filters will do a linear scan across all buckets searching for a match.
func (*Client) FindDashboard ¶
func (c *Client) FindDashboard(ctx context.Context, filter platform.DashboardFilter) (*platform.Dashboard, error)
FindDashboard retrieves a dashboard using an arbitrary dashboard filter.
func (*Client) FindDashboardByID ¶
func (c *Client) FindDashboardByID(ctx context.Context, id platform.ID) (*platform.Dashboard, error)
FindDashboardByID retrieves a dashboard by id.
func (*Client) FindDashboards ¶
func (c *Client) FindDashboards(ctx context.Context, filter platform.DashboardFilter) ([]*platform.Dashboard, int, error)
FindDashboards retrives all dashboards that match an arbitrary dashboard filter.
func (*Client) FindOrganization ¶
func (c *Client) FindOrganization(ctx context.Context, filter platform.OrganizationFilter) (*platform.Organization, error)
FindOrganization retrives a organization using an arbitrary organization filter. Filters using ID, or Name should be efficient. Other filters will do a linear scan across organizations until it finds a match.
func (*Client) FindOrganizationByID ¶
func (c *Client) FindOrganizationByID(ctx context.Context, id platform.ID) (*platform.Organization, error)
FindOrganizationByID retrieves a organization by id.
func (*Client) FindOrganizationByName ¶
func (c *Client) FindOrganizationByName(ctx context.Context, n string) (*platform.Organization, error)
FindOrganizationByName returns a organization by name for a particular organization.
func (*Client) FindOrganizations ¶
func (c *Client) FindOrganizations(ctx context.Context, filter platform.OrganizationFilter, opt ...platform.FindOptions) ([]*platform.Organization, int, error)
FindOrganizations retrives all organizations that match an arbitrary organization filter. Filters using ID, or Name should be efficient. Other filters will do a linear scan across all organizations searching for a match.
func (*Client) FindSourceByID ¶
FindSourceByID retrieves a source by id.
func (*Client) FindSources ¶
func (c *Client) FindSources(ctx context.Context, opt platform.FindOptions) ([]*platform.Source, int, error)
FindSources retrives all sources that match an arbitrary source filter. Filters using ID, or OrganizationID and source Name should be efficient. Other filters will do a linear scan across all sources searching for a match.
func (*Client) FindUser ¶
FindUser retrives a user using an arbitrary user filter. Filters using ID, or Name should be efficient. Other filters will do a linear scan across users until it finds a match.
func (*Client) FindUserByID ¶
FindUserByID retrieves a user by id.
func (*Client) FindUserByName ¶
FindUserByName returns a user by name for a particular user.
func (*Client) FindUsers ¶
func (c *Client) FindUsers(ctx context.Context, filter platform.UserFilter, opt ...platform.FindOptions) ([]*platform.User, int, error)
FindUsers retrives all users that match an arbitrary user filter. Filters using ID, or Name should be efficient. Other filters will do a linear scan across all users searching for a match.
func (*Client) FindViewByID ¶
FindViewByID retrieves a view by id.
func (*Client) FindViews ¶
func (c *Client) FindViews(ctx context.Context, filter platform.ViewFilter) ([]*platform.View, int, error)
FindViews retrives all views that match an arbitrary view filter.
func (*Client) PutAuthorization ¶
PutAuthorization will put a authorization without setting an ID.
func (*Client) PutDashboard ¶
PutDashboard will put a dashboard without setting an ID.
func (*Client) PutOrganization ¶
PutOrganization will put a organization without setting an ID.
func (*Client) RemoveDashboardCell ¶
RemoveDashboardCell removes a cell from a dashboard.
func (*Client) ReplaceDashboardCells ¶
func (c *Client) ReplaceDashboardCells(ctx context.Context, id platform.ID, cs []*platform.Cell) error
ReplaceDashboardCells creates a platform dashboard and sets d.ID.
func (*Client) SetAuthorizationStatus ¶
func (c *Client) SetAuthorizationStatus(ctx context.Context, id platform.ID, status platform.Status) error
SetAuthorizationStatus updates the status of the authorization. Useful for setting an authorization to inactive or active.
func (*Client) UpdateBucket ¶
func (c *Client) UpdateBucket(ctx context.Context, id platform.ID, upd platform.BucketUpdate) (*platform.Bucket, error)
UpdateBucket updates a bucket according the parameters set on upd.
func (*Client) UpdateDashboard ¶
func (c *Client) UpdateDashboard(ctx context.Context, id platform.ID, upd platform.DashboardUpdate) (*platform.Dashboard, error)
UpdateDashboard updates a dashboard according the parameters set on upd.
func (*Client) UpdateDashboardCell ¶
func (c *Client) UpdateDashboardCell(ctx context.Context, dashboardID, cellID platform.ID, upd platform.CellUpdate) (*platform.Cell, error)
UpdateDashboardCell udpates a cell on a dashboard.
func (*Client) UpdateOrganization ¶
func (c *Client) UpdateOrganization(ctx context.Context, id platform.ID, upd platform.OrganizationUpdate) (*platform.Organization, error)
UpdateOrganization updates a organization according the parameters set on upd.
func (*Client) UpdateSource ¶
func (c *Client) UpdateSource(ctx context.Context, id platform.ID, upd platform.SourceUpdate) (*platform.Source, error)
UpdateSource updates a source according the parameters set on upd.
func (*Client) UpdateUser ¶
func (c *Client) UpdateUser(ctx context.Context, id platform.ID, upd platform.UserUpdate) (*platform.User, error)
UpdateUser updates a user according the parameters set on upd.
func (*Client) UpdateView ¶
func (c *Client) UpdateView(ctx context.Context, id platform.ID, upd platform.ViewUpdate) (*platform.View, error)
UpdateView updates a view according the parameters set on upd.
func (*Client) WithLogger ¶
WithLogger sets the logger an a client. It should not be called after the client has been open.