Documentation ¶
Overview ¶
Package tabletmanager exports the ActionAgent object. It keeps the local tablet state, starts / stops all associated services (query service, update stream, binlog players, ...), and handles tabletmanager RPCs to update the state.
The agent is responsible for maintaining the tablet record in the topology server. Only 'vtctl DeleteTablet' should be run by other processes, everything else should ask the tablet server to make the change.
Most RPC calls lock the actionMutex, except the easy read-only ones. RPC calls that change the tablet record will also call updateState.
See rpc_server.go for all cases, and which actions take the actionMutex, and which run changeCallback.
Index ¶
- Constants
- Variables
- func ConfigHTML() template.HTML
- func RegisterBinlogPlayerMap(blm *BinlogPlayerMap)
- func SetReparentFlags(timeout time.Duration)
- type ActionAgent
- func NewActionAgent(batchCtx context.Context, ts topo.Server, mysqld mysqlctl.MysqlDaemon, ...) (agent *ActionAgent, err error)
- func NewComboActionAgent(batchCtx context.Context, ts topo.Server, tabletAlias *topodatapb.TabletAlias, ...) *ActionAgent
- func NewTestActionAgent(batchCtx context.Context, ts topo.Server, tabletAlias *topodatapb.TabletAlias, ...) *ActionAgent
- func (agent *ActionAgent) ApplySchema(ctx context.Context, change *tmutils.SchemaChange) (*tabletmanagerdatapb.SchemaChangeResult, error)
- func (agent *ActionAgent) Backup(ctx context.Context, concurrency int, logger logutil.Logger) error
- func (agent *ActionAgent) BlacklistedTables() []string
- func (agent *ActionAgent) ChangeType(ctx context.Context, tabletType topodatapb.TabletType) error
- func (agent *ActionAgent) DemoteMaster(ctx context.Context) (string, error)
- func (agent *ActionAgent) DisallowQueryService() string
- func (agent *ActionAgent) EnableUpdateStream() bool
- func (agent *ActionAgent) ExecuteFetchAsAllPrivs(ctx context.Context, query []byte, dbName string, maxrows int, ...) (*querypb.QueryResult, error)
- func (agent *ActionAgent) ExecuteFetchAsApp(ctx context.Context, query []byte, maxrows int) (*querypb.QueryResult, error)
- func (agent *ActionAgent) ExecuteFetchAsDba(ctx context.Context, query []byte, dbName string, maxrows int, ...) (*querypb.QueryResult, error)
- func (agent *ActionAgent) ExecuteHook(ctx context.Context, hk *hook.Hook) *hook.HookResult
- func (agent *ActionAgent) GetPermissions(ctx context.Context) (*tabletmanagerdatapb.Permissions, error)
- func (agent *ActionAgent) GetSchema(ctx context.Context, tables, excludeTables []string, includeViews bool) (*tabletmanagerdatapb.SchemaDefinition, error)
- func (agent *ActionAgent) GetSlaves(ctx context.Context) ([]string, error)
- func (agent *ActionAgent) HandleRPCPanic(ctx context.Context, name string, args, reply interface{}, verbose bool, ...)
- func (agent *ActionAgent) Healthy() (time.Duration, error)
- func (agent *ActionAgent) IgnoreHealthError(ctx context.Context, pattern string) error
- func (agent *ActionAgent) InitMaster(ctx context.Context) (string, error)
- func (agent *ActionAgent) InitSlave(ctx context.Context, parent *topodatapb.TabletAlias, position string, ...) error
- func (agent *ActionAgent) InitTablet(port, gRPCPort int32) error
- func (agent *ActionAgent) MasterPosition(ctx context.Context) (string, error)
- func (agent *ActionAgent) Ping(ctx context.Context, args string) string
- func (agent *ActionAgent) PopulateReparentJournal(ctx context.Context, timeCreatedNS int64, actionName string, ...) error
- func (agent *ActionAgent) PreflightSchema(ctx context.Context, changes []string) ([]*tabletmanagerdatapb.SchemaChangeResult, error)
- func (agent *ActionAgent) PromoteSlave(ctx context.Context) (string, error)
- func (agent *ActionAgent) PromoteSlaveWhenCaughtUp(ctx context.Context, position string) (string, error)
- func (agent *ActionAgent) RefreshState(ctx context.Context) error
- func (agent *ActionAgent) ReloadSchema(ctx context.Context, waitPosition string) error
- func (agent *ActionAgent) ResetReplication(ctx context.Context) error
- func (agent *ActionAgent) RestoreData(ctx context.Context, logger logutil.Logger, deleteBeforeRestore bool) error
- func (agent *ActionAgent) RestoreFromBackup(ctx context.Context, logger logutil.Logger) error
- func (agent *ActionAgent) RunBlpUntil(ctx context.Context, bpl []*tabletmanagerdatapb.BlpPosition, ...) (string, error)
- func (agent *ActionAgent) RunHealthCheck(ctx context.Context)
- func (agent *ActionAgent) SetMaster(ctx context.Context, parentAlias *topodatapb.TabletAlias, timeCreatedNS int64, ...) error
- func (agent *ActionAgent) SetReadOnly(ctx context.Context, rdonly bool) error
- func (agent *ActionAgent) SlaveStatus(ctx context.Context) (*replicationdatapb.Status, error)
- func (agent *ActionAgent) SlaveWasPromoted(ctx context.Context) error
- func (agent *ActionAgent) SlaveWasRestarted(ctx context.Context, parent *topodatapb.TabletAlias) error
- func (agent *ActionAgent) Sleep(ctx context.Context, duration time.Duration)
- func (agent *ActionAgent) Start(ctx context.Context, mysqlPort, vtPort, gRPCPort int32, initUpdateStream bool) error
- func (agent *ActionAgent) StartBlp(ctx context.Context) error
- func (agent *ActionAgent) StartSlave(ctx context.Context) error
- func (agent *ActionAgent) Stop()
- func (agent *ActionAgent) StopBlp(ctx context.Context) ([]*tabletmanagerdatapb.BlpPosition, error)
- func (agent *ActionAgent) StopReplicationAndGetStatus(ctx context.Context) (*replicationdatapb.Status, error)
- func (agent *ActionAgent) StopSlave(ctx context.Context) error
- func (agent *ActionAgent) StopSlaveMinimum(ctx context.Context, position string, waitTime time.Duration) (string, error)
- func (agent *ActionAgent) Tablet() *topodatapb.Tablet
- func (agent *ActionAgent) TabletExternallyReparented(ctx context.Context, externalID string) error
- func (agent *ActionAgent) WaitBlpPosition(ctx context.Context, blpPosition *tabletmanagerdatapb.BlpPosition, ...) error
- type BinlogPlayerController
- func (bpc *BinlogPlayerController) BlpPosition(vtClient binlogplayer.VtClient) (*tabletmanagerdatapb.BlpPosition, string, error)
- func (bpc *BinlogPlayerController) Close() error
- func (bpc *BinlogPlayerController) Iteration() (err error)
- func (bpc *BinlogPlayerController) Loop()
- func (bpc *BinlogPlayerController) Start(ctx context.Context)
- func (bpc *BinlogPlayerController) StartUntil(ctx context.Context, stopPos string) error
- func (bpc *BinlogPlayerController) Stop()
- func (bpc *BinlogPlayerController) String() string
- func (bpc *BinlogPlayerController) WaitForStop(waitTimeout time.Duration) error
- type BinlogPlayerControllerStatus
- type BinlogPlayerControllerStatusList
- type BinlogPlayerMap
- func (blm *BinlogPlayerMap) BlpPositionList() ([]*tabletmanagerdatapb.BlpPosition, error)
- func (blm *BinlogPlayerMap) RefreshMap(ctx context.Context, tablet *topodatapb.Tablet, shardInfo *topo.ShardInfo)
- func (blm *BinlogPlayerMap) RunUntil(ctx context.Context, blpPositionList []*tabletmanagerdatapb.BlpPosition, ...) error
- func (blm *BinlogPlayerMap) Start(ctx context.Context)
- func (blm *BinlogPlayerMap) Status() *BinlogPlayerMapStatus
- func (blm *BinlogPlayerMap) StatusSummary() (maxSecondsBehindMaster int64, binlogPlayersCount int32)
- func (blm *BinlogPlayerMap) Stop()
- func (blm *BinlogPlayerMap) StopAllPlayersAndReset()
- type BinlogPlayerMapStatus
- type HealthRecord
- type RPCAgent
- type RegisterQueryService
Constants ¶
const ( // BpmStateRunning indicates BinlogPlayerMap is running. BpmStateRunning int64 = iota // BpmStateStopped indicates BinlogPlayerMap has stopped. BpmStateStopped )
Variables ¶
var RegisterQueryServices []RegisterQueryService
RegisterQueryServices is a list of functions to call when the delayed registration is triggered.
Functions ¶
func ConfigHTML ¶
ConfigHTML returns a formatted summary of health checking config values.
func RegisterBinlogPlayerMap ¶
func RegisterBinlogPlayerMap(blm *BinlogPlayerMap)
RegisterBinlogPlayerMap registers the varz for the players.
func SetReparentFlags ¶
SetReparentFlags changes flag values. It should only be used in tests.
Types ¶
type ActionAgent ¶
type ActionAgent struct { // The following fields are set during creation QueryServiceControl tabletserver.Controller UpdateStream binlog.UpdateStreamControl HealthReporter health.Reporter TopoServer topo.Server TabletAlias *topodatapb.TabletAlias MysqlDaemon mysqlctl.MysqlDaemon DBConfigs dbconfigs.DBConfigs BinlogPlayerMap *BinlogPlayerMap // History of the health checks, public so status // pages can display it History *history.History // contains filtered or unexported fields }
ActionAgent is the main class for the agent.
func NewActionAgent ¶
func NewActionAgent( batchCtx context.Context, ts topo.Server, mysqld mysqlctl.MysqlDaemon, queryServiceControl tabletserver.Controller, tabletAlias *topodatapb.TabletAlias, dbcfgs dbconfigs.DBConfigs, mycnf *mysqlctl.Mycnf, port, gRPCPort int32, ) (agent *ActionAgent, err error)
NewActionAgent creates a new ActionAgent and registers all the associated services.
batchCtx is the context that the agent will use for any background tasks it spawns.
func NewComboActionAgent ¶
func NewComboActionAgent(batchCtx context.Context, ts topo.Server, tabletAlias *topodatapb.TabletAlias, vtPort, grpcPort int32, queryServiceControl tabletserver.Controller, dbcfgs dbconfigs.DBConfigs, mysqlDaemon mysqlctl.MysqlDaemon, keyspace, shard, dbname, tabletType string) *ActionAgent
NewComboActionAgent creates an agent tailored specifically to run within the vtcombo binary. It cannot be called concurrently, as it changes the flags.
func NewTestActionAgent ¶
func NewTestActionAgent(batchCtx context.Context, ts topo.Server, tabletAlias *topodatapb.TabletAlias, vtPort, grpcPort int32, mysqlDaemon mysqlctl.MysqlDaemon, preStart func(*ActionAgent)) *ActionAgent
NewTestActionAgent creates an agent for test purposes. Only a subset of features are supported now, but we'll add more over time.
func (*ActionAgent) ApplySchema ¶
func (agent *ActionAgent) ApplySchema(ctx context.Context, change *tmutils.SchemaChange) (*tabletmanagerdatapb.SchemaChangeResult, error)
ApplySchema will apply a schema change
func (*ActionAgent) BlacklistedTables ¶
func (agent *ActionAgent) BlacklistedTables() []string
BlacklistedTables returns the list of currently blacklisted tables.
func (*ActionAgent) ChangeType ¶
func (agent *ActionAgent) ChangeType(ctx context.Context, tabletType topodatapb.TabletType) error
ChangeType changes the tablet type
func (*ActionAgent) DemoteMaster ¶
func (agent *ActionAgent) DemoteMaster(ctx context.Context) (string, error)
DemoteMaster marks the server read-only, wait until it is done with its current transactions, and returns its master position.
func (*ActionAgent) DisallowQueryService ¶
func (agent *ActionAgent) DisallowQueryService() string
DisallowQueryService returns the reason the query service should be disabled, if any.
func (*ActionAgent) EnableUpdateStream ¶
func (agent *ActionAgent) EnableUpdateStream() bool
EnableUpdateStream returns if we should enable update stream or not
func (*ActionAgent) ExecuteFetchAsAllPrivs ¶
func (agent *ActionAgent) ExecuteFetchAsAllPrivs(ctx context.Context, query []byte, dbName string, maxrows int, reloadSchema bool) (*querypb.QueryResult, error)
ExecuteFetchAsAllPrivs will execute the given query, possibly reloading schema.
func (*ActionAgent) ExecuteFetchAsApp ¶
func (agent *ActionAgent) ExecuteFetchAsApp(ctx context.Context, query []byte, maxrows int) (*querypb.QueryResult, error)
ExecuteFetchAsApp will execute the given query.
func (*ActionAgent) ExecuteFetchAsDba ¶
func (agent *ActionAgent) ExecuteFetchAsDba(ctx context.Context, query []byte, dbName string, maxrows int, disableBinlogs bool, reloadSchema bool) (*querypb.QueryResult, error)
ExecuteFetchAsDba will execute the given query, possibly disabling binlogs and reload schema.
func (*ActionAgent) ExecuteHook ¶
func (agent *ActionAgent) ExecuteHook(ctx context.Context, hk *hook.Hook) *hook.HookResult
ExecuteHook executes the provided hook locally, and returns the result.
func (*ActionAgent) GetPermissions ¶
func (agent *ActionAgent) GetPermissions(ctx context.Context) (*tabletmanagerdatapb.Permissions, error)
GetPermissions returns the db permissions.
func (*ActionAgent) GetSchema ¶
func (agent *ActionAgent) GetSchema(ctx context.Context, tables, excludeTables []string, includeViews bool) (*tabletmanagerdatapb.SchemaDefinition, error)
GetSchema returns the schema.
func (*ActionAgent) GetSlaves ¶
func (agent *ActionAgent) GetSlaves(ctx context.Context) ([]string, error)
GetSlaves returns the address of all the slaves
func (*ActionAgent) HandleRPCPanic ¶
func (agent *ActionAgent) HandleRPCPanic(ctx context.Context, name string, args, reply interface{}, verbose bool, err *error)
HandleRPCPanic is part of the RPCAgent interface.
func (*ActionAgent) Healthy ¶
func (agent *ActionAgent) Healthy() (time.Duration, error)
Healthy reads the result of the latest healthcheck, protected by mutex. If that status is too old, it means healthcheck hasn't run for a while, and is probably stuck, this is not good, we're not healthy.
func (*ActionAgent) IgnoreHealthError ¶
func (agent *ActionAgent) IgnoreHealthError(ctx context.Context, pattern string) error
IgnoreHealthError sets the regexp for health check errors to ignore.
func (*ActionAgent) InitMaster ¶
func (agent *ActionAgent) InitMaster(ctx context.Context) (string, error)
InitMaster enables writes and returns the replication position.
func (*ActionAgent) InitSlave ¶
func (agent *ActionAgent) InitSlave(ctx context.Context, parent *topodatapb.TabletAlias, position string, timeCreatedNS int64) error
InitSlave sets replication master and position, and waits for the reparent_journal table entry up to context timeout
func (*ActionAgent) InitTablet ¶
func (agent *ActionAgent) InitTablet(port, gRPCPort int32) error
InitTablet initializes the tablet record if necessary.
func (*ActionAgent) MasterPosition ¶
func (agent *ActionAgent) MasterPosition(ctx context.Context) (string, error)
MasterPosition returns the master position
func (*ActionAgent) Ping ¶
func (agent *ActionAgent) Ping(ctx context.Context, args string) string
Ping makes sure RPCs work, and refreshes the tablet record.
func (*ActionAgent) PopulateReparentJournal ¶
func (agent *ActionAgent) PopulateReparentJournal(ctx context.Context, timeCreatedNS int64, actionName string, masterAlias *topodatapb.TabletAlias, position string) error
PopulateReparentJournal adds an entry into the reparent_journal table.
func (*ActionAgent) PreflightSchema ¶
func (agent *ActionAgent) PreflightSchema(ctx context.Context, changes []string) ([]*tabletmanagerdatapb.SchemaChangeResult, error)
PreflightSchema will try out the schema changes in "changes".
func (*ActionAgent) PromoteSlave ¶
func (agent *ActionAgent) PromoteSlave(ctx context.Context) (string, error)
PromoteSlave makes the current tablet the master
func (*ActionAgent) PromoteSlaveWhenCaughtUp ¶
func (agent *ActionAgent) PromoteSlaveWhenCaughtUp(ctx context.Context, position string) (string, error)
PromoteSlaveWhenCaughtUp waits for this slave to be caught up on replication up to the provided point, and then makes the slave the shard master.
func (*ActionAgent) RefreshState ¶
func (agent *ActionAgent) RefreshState(ctx context.Context) error
RefreshState reload the tablet record from the topo server.
func (*ActionAgent) ReloadSchema ¶
func (agent *ActionAgent) ReloadSchema(ctx context.Context, waitPosition string) error
ReloadSchema will reload the schema This doesn't need the action mutex because periodic schema reloads happen in the background anyway.
func (*ActionAgent) ResetReplication ¶
func (agent *ActionAgent) ResetReplication(ctx context.Context) error
ResetReplication completely resets the replication on the host. All binary and relay logs are flushed. All replication positions are reset.
func (*ActionAgent) RestoreData ¶
func (agent *ActionAgent) RestoreData(ctx context.Context, logger logutil.Logger, deleteBeforeRestore bool) error
RestoreData is the main entry point for backup restore. It will either work, fail gracefully, or return an error in case of a non-recoverable error. It takes the action lock so no RPC interferes.
func (*ActionAgent) RestoreFromBackup ¶
RestoreFromBackup deletes all local data and restores anew from the latest backup.
func (*ActionAgent) RunBlpUntil ¶
func (agent *ActionAgent) RunBlpUntil(ctx context.Context, bpl []*tabletmanagerdatapb.BlpPosition, waitTime time.Duration) (string, error)
RunBlpUntil runs the binlog player server until the position is reached, and returns the current mysql master replication position.
func (*ActionAgent) RunHealthCheck ¶
func (agent *ActionAgent) RunHealthCheck(ctx context.Context)
RunHealthCheck will manually run the health check on the tablet.
func (*ActionAgent) SetMaster ¶
func (agent *ActionAgent) SetMaster(ctx context.Context, parentAlias *topodatapb.TabletAlias, timeCreatedNS int64, forceStartSlave bool) error
SetMaster sets replication master, and waits for the reparent_journal table entry up to context timeout
func (*ActionAgent) SetReadOnly ¶
func (agent *ActionAgent) SetReadOnly(ctx context.Context, rdonly bool) error
SetReadOnly makes the mysql instance read-only or read-write.
func (*ActionAgent) SlaveStatus ¶
func (agent *ActionAgent) SlaveStatus(ctx context.Context) (*replicationdatapb.Status, error)
SlaveStatus returns the replication status
func (*ActionAgent) SlaveWasPromoted ¶
func (agent *ActionAgent) SlaveWasPromoted(ctx context.Context) error
SlaveWasPromoted promotes a slave to master, no questions asked.
func (*ActionAgent) SlaveWasRestarted ¶
func (agent *ActionAgent) SlaveWasRestarted(ctx context.Context, parent *topodatapb.TabletAlias) error
SlaveWasRestarted updates the parent record for a tablet.
func (*ActionAgent) Sleep ¶
func (agent *ActionAgent) Sleep(ctx context.Context, duration time.Duration)
Sleep sleeps for the duration
func (*ActionAgent) Start ¶
func (agent *ActionAgent) Start(ctx context.Context, mysqlPort, vtPort, gRPCPort int32, initUpdateStream bool) error
Start validates and updates the topology records for the tablet, and performs the initial state change callback to start tablet services. If initUpdateStream is set, update stream service will also be registered.
func (*ActionAgent) StartBlp ¶
func (agent *ActionAgent) StartBlp(ctx context.Context) error
StartBlp starts the binlog players
func (*ActionAgent) StartSlave ¶
func (agent *ActionAgent) StartSlave(ctx context.Context) error
StartSlave will start the replication. Works both when Vitess manages replication or not (using hook if not).
func (*ActionAgent) Stop ¶
func (agent *ActionAgent) Stop()
Stop shuts down the agent. Normally this is not necessary, since we use servenv OnTerm and OnClose hooks to coordinate shutdown automatically, while taking lameduck into account. However, this may be useful for tests, when you want to clean up an agent immediately.
func (*ActionAgent) StopBlp ¶
func (agent *ActionAgent) StopBlp(ctx context.Context) ([]*tabletmanagerdatapb.BlpPosition, error)
StopBlp stops the binlog players, and return their positions.
func (*ActionAgent) StopReplicationAndGetStatus ¶
func (agent *ActionAgent) StopReplicationAndGetStatus(ctx context.Context) (*replicationdatapb.Status, error)
StopReplicationAndGetStatus stops MySQL replication, and returns the current status.
func (*ActionAgent) StopSlave ¶
func (agent *ActionAgent) StopSlave(ctx context.Context) error
StopSlave will stop the replication. Works both when Vitess manages replication or not (using hook if not).
func (*ActionAgent) StopSlaveMinimum ¶
func (agent *ActionAgent) StopSlaveMinimum(ctx context.Context, position string, waitTime time.Duration) (string, error)
StopSlaveMinimum will stop the slave after it reaches at least the provided position. Works both when Vitess manages replication or not (using hook if not).
func (*ActionAgent) Tablet ¶
func (agent *ActionAgent) Tablet() *topodatapb.Tablet
Tablet reads the stored Tablet from the agent, protected by mutex.
func (*ActionAgent) TabletExternallyReparented ¶
func (agent *ActionAgent) TabletExternallyReparented(ctx context.Context, externalID string) error
TabletExternallyReparented updates all topo records so the current tablet is the new master for this shard.
func (*ActionAgent) WaitBlpPosition ¶
func (agent *ActionAgent) WaitBlpPosition(ctx context.Context, blpPosition *tabletmanagerdatapb.BlpPosition, waitTime time.Duration) error
WaitBlpPosition waits until a specific filtered replication position is reached.
type BinlogPlayerController ¶
type BinlogPlayerController struct {
// contains filtered or unexported fields
}
BinlogPlayerController controls one player.
func (*BinlogPlayerController) BlpPosition ¶
func (bpc *BinlogPlayerController) BlpPosition(vtClient binlogplayer.VtClient) (*tabletmanagerdatapb.BlpPosition, string, error)
BlpPosition returns the current position for a controller, as read from the database.
func (*BinlogPlayerController) Close ¶
func (bpc *BinlogPlayerController) Close() error
Close will stop and free any long running resources e.g. the healthcheck. Returns an error if BinlogPlayerController is not stopped (i.e. Start() was called but not Stop().)
func (*BinlogPlayerController) Iteration ¶
func (bpc *BinlogPlayerController) Iteration() (err error)
Iteration is a single iteration for the player: get the current status, try to play, and plays until interrupted, or until an error occurs.
func (*BinlogPlayerController) Loop ¶
func (bpc *BinlogPlayerController) Loop()
Loop runs the main player loop: try to play, and in case of error, sleep for 5 seconds and try again.
func (*BinlogPlayerController) Start ¶
func (bpc *BinlogPlayerController) Start(ctx context.Context)
Start will start the player in the background and run forever.
func (*BinlogPlayerController) StartUntil ¶
func (bpc *BinlogPlayerController) StartUntil(ctx context.Context, stopPos string) error
StartUntil will start the Player until we reach the given position.
func (*BinlogPlayerController) Stop ¶
func (bpc *BinlogPlayerController) Stop()
Stop will ask the controller to stop playing, and wait until it is stopped.
func (*BinlogPlayerController) String ¶
func (bpc *BinlogPlayerController) String() string
func (*BinlogPlayerController) WaitForStop ¶
func (bpc *BinlogPlayerController) WaitForStop(waitTimeout time.Duration) error
WaitForStop will wait until the player is stopped. Use this after StartUntil.
type BinlogPlayerControllerStatus ¶
type BinlogPlayerControllerStatus struct { // configuration values Index uint32 SourceShard *topodatapb.Shard_SourceShard StopPosition string // stats and current values LastPosition replication.Position SecondsBehindMaster int64 Counts map[string]int64 Rates map[string][]float64 State string SourceTablet *topodatapb.TabletAlias LastError string }
BinlogPlayerControllerStatus is the status of an individual controller.
func (*BinlogPlayerControllerStatus) SourceShardAsHTML ¶
func (bpcs *BinlogPlayerControllerStatus) SourceShardAsHTML() template.HTML
SourceShardAsHTML returns the SourceShard as HTML
func (*BinlogPlayerControllerStatus) SourceTabletAlias ¶
func (bpcs *BinlogPlayerControllerStatus) SourceTabletAlias() string
SourceTabletAlias returns the string version of the SourceTablet alias, if set
type BinlogPlayerControllerStatusList ¶
type BinlogPlayerControllerStatusList []*BinlogPlayerControllerStatus
BinlogPlayerControllerStatusList is the list of statuses.
func (BinlogPlayerControllerStatusList) Len ¶
func (bpcsl BinlogPlayerControllerStatusList) Len() int
Len is part of sort.Interface.
func (BinlogPlayerControllerStatusList) Less ¶
func (bpcsl BinlogPlayerControllerStatusList) Less(i, j int) bool
Less is part of sort.Interface.
func (BinlogPlayerControllerStatusList) Swap ¶
func (bpcsl BinlogPlayerControllerStatusList) Swap(i, j int)
Swap is part of sort.Interface.
type BinlogPlayerMap ¶
type BinlogPlayerMap struct {
// contains filtered or unexported fields
}
BinlogPlayerMap controls all the players. It can be stopped and restarted.
func NewBinlogPlayerMap ¶
func NewBinlogPlayerMap(ts topo.Server, mysqld mysqlctl.MysqlDaemon, vtClientFactory func() binlogplayer.VtClient) *BinlogPlayerMap
NewBinlogPlayerMap creates a new map of players.
func (*BinlogPlayerMap) BlpPositionList ¶
func (blm *BinlogPlayerMap) BlpPositionList() ([]*tabletmanagerdatapb.BlpPosition, error)
BlpPositionList returns the current position of all the players.
func (*BinlogPlayerMap) RefreshMap ¶
func (blm *BinlogPlayerMap) RefreshMap(ctx context.Context, tablet *topodatapb.Tablet, shardInfo *topo.ShardInfo)
RefreshMap reads the right data from topo.Server and makes sure we're playing the right logs.
func (*BinlogPlayerMap) RunUntil ¶
func (blm *BinlogPlayerMap) RunUntil(ctx context.Context, blpPositionList []*tabletmanagerdatapb.BlpPosition, waitTimeout time.Duration) error
RunUntil will run all the players until they reach the given position. Holds the map lock during that exercise, shouldn't take long at all.
func (*BinlogPlayerMap) Start ¶
func (blm *BinlogPlayerMap) Start(ctx context.Context)
Start restarts the current players.
func (*BinlogPlayerMap) Status ¶
func (blm *BinlogPlayerMap) Status() *BinlogPlayerMapStatus
Status returns the BinlogPlayerMapStatus for the BinlogPlayerMap. It is used to display the complete status in the webinterface.
func (*BinlogPlayerMap) StatusSummary ¶
func (blm *BinlogPlayerMap) StatusSummary() (maxSecondsBehindMaster int64, binlogPlayersCount int32)
StatusSummary returns aggregated health information e.g. the maximum replication delay across all binlog players. It is used by the QueryService.StreamHealth RPC.
func (*BinlogPlayerMap) Stop ¶
func (blm *BinlogPlayerMap) Stop()
Stop stops the current players, but does not remove them from the map. Call 'Start' to restart the playback.
func (*BinlogPlayerMap) StopAllPlayersAndReset ¶
func (blm *BinlogPlayerMap) StopAllPlayersAndReset()
StopAllPlayersAndReset stops all the binlog players, and reset the map of players.
type BinlogPlayerMapStatus ¶
type BinlogPlayerMapStatus struct { State string Controllers BinlogPlayerControllerStatusList }
BinlogPlayerMapStatus is the complete player status.
type HealthRecord ¶
type HealthRecord struct { Time time.Time Error error IgnoredError error IgnoreErrorExpr string ReplicationDelay time.Duration }
HealthRecord records one run of the health checker.
func (*HealthRecord) Class ¶
func (r *HealthRecord) Class() string
Class returns a human-readable one word version of the health state.
func (*HealthRecord) Degraded ¶
func (r *HealthRecord) Degraded() bool
Degraded returns true if the replication delay is beyond degradedThreshold.
func (*HealthRecord) ErrorString ¶
func (r *HealthRecord) ErrorString() string
ErrorString returns Error as a string.
func (*HealthRecord) HTML ¶
func (r *HealthRecord) HTML() template.HTML
HTML returns an HTML version to be displayed on UIs.
func (*HealthRecord) IgnoredErrorString ¶
func (r *HealthRecord) IgnoredErrorString() string
IgnoredErrorString returns IgnoredError as a string.
func (*HealthRecord) IsDuplicate ¶
func (r *HealthRecord) IsDuplicate(other interface{}) bool
IsDuplicate implements history.Deduplicable
type RPCAgent ¶
type RPCAgent interface { Ping(ctx context.Context, args string) string GetSchema(ctx context.Context, tables, excludeTables []string, includeViews bool) (*tabletmanagerdatapb.SchemaDefinition, error) GetPermissions(ctx context.Context) (*tabletmanagerdatapb.Permissions, error) SetReadOnly(ctx context.Context, rdonly bool) error ChangeType(ctx context.Context, tabletType topodatapb.TabletType) error Sleep(ctx context.Context, duration time.Duration) ExecuteHook(ctx context.Context, hk *hook.Hook) *hook.HookResult RefreshState(ctx context.Context) error RunHealthCheck(ctx context.Context) IgnoreHealthError(ctx context.Context, pattern string) error ReloadSchema(ctx context.Context, waitPosition string) error PreflightSchema(ctx context.Context, changes []string) ([]*tabletmanagerdatapb.SchemaChangeResult, error) ApplySchema(ctx context.Context, change *tmutils.SchemaChange) (*tabletmanagerdatapb.SchemaChangeResult, error) ExecuteFetchAsDba(ctx context.Context, query []byte, dbName string, maxrows int, disableBinlogs bool, reloadSchema bool) (*querypb.QueryResult, error) ExecuteFetchAsAllPrivs(ctx context.Context, query []byte, dbName string, maxrows int, reloadSchema bool) (*querypb.QueryResult, error) ExecuteFetchAsApp(ctx context.Context, query []byte, maxrows int) (*querypb.QueryResult, error) SlaveStatus(ctx context.Context) (*replicationdatapb.Status, error) MasterPosition(ctx context.Context) (string, error) StopSlave(ctx context.Context) error StopSlaveMinimum(ctx context.Context, position string, waitTime time.Duration) (string, error) StartSlave(ctx context.Context) error TabletExternallyReparented(ctx context.Context, externalID string) error GetSlaves(ctx context.Context) ([]string, error) WaitBlpPosition(ctx context.Context, blpPosition *tabletmanagerdatapb.BlpPosition, waitTime time.Duration) error StopBlp(ctx context.Context) ([]*tabletmanagerdatapb.BlpPosition, error) StartBlp(ctx context.Context) error RunBlpUntil(ctx context.Context, bpl []*tabletmanagerdatapb.BlpPosition, waitTime time.Duration) (string, error) ResetReplication(ctx context.Context) error InitMaster(ctx context.Context) (string, error) PopulateReparentJournal(ctx context.Context, timeCreatedNS int64, actionName string, masterAlias *topodatapb.TabletAlias, pos string) error InitSlave(ctx context.Context, parent *topodatapb.TabletAlias, replicationPosition string, timeCreatedNS int64) error DemoteMaster(ctx context.Context) (string, error) PromoteSlaveWhenCaughtUp(ctx context.Context, replicationPosition string) (string, error) SlaveWasPromoted(ctx context.Context) error SetMaster(ctx context.Context, parent *topodatapb.TabletAlias, timeCreatedNS int64, forceStartSlave bool) error SlaveWasRestarted(ctx context.Context, parent *topodatapb.TabletAlias) error StopReplicationAndGetStatus(ctx context.Context) (*replicationdatapb.Status, error) PromoteSlave(ctx context.Context) (string, error) Backup(ctx context.Context, concurrency int, logger logutil.Logger) error RestoreFromBackup(ctx context.Context, logger logutil.Logger) error // HandleRPCPanic is to be called in a defer statement in each // RPC input point. HandleRPCPanic(ctx context.Context, name string, args, reply interface{}, verbose bool, err *error) }
RPCAgent defines the interface implemented by the Agent for RPCs. It is useful for RPC implementations to test their full stack.
type RegisterQueryService ¶
type RegisterQueryService func(*ActionAgent)
RegisterQueryService is used to delay registration of RPC servers until we have all the objects.