milvus/cmd/roles/roles.go

// Licensed to the LF AI & Data foundation under one
// or more contributor license agreements. See the NOTICE file
// distributed with this work for additional information
// regarding copyright ownership. The ASF licenses this file
// to you under the Apache License, Version 2.0 (the
// "License"); you may not use this file except in compliance
// with the License. You may obtain a copy of the License at
//
//     http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.

package roles

import (
	"context"
	"fmt"
	"os"
	"os/signal"
	"reflect"
	"runtime/debug"
	"strings"
	"sync"
	"syscall"
	"time"

	"github.com/cockroachdb/errors"
	"github.com/prometheus/client_golang/prometheus"
	"github.com/prometheus/client_golang/prometheus/promhttp"
	"github.com/samber/lo"
	"golang.org/x/time/rate"

	"github.com/milvus-io/milvus-proto/go-api/v3/commonpb"
	"github.com/milvus-io/milvus/cmd/components"
	mix "github.com/milvus-io/milvus/internal/distributed/mixcoord/client"
	"github.com/milvus-io/milvus/internal/distributed/streaming"
	"github.com/milvus-io/milvus/internal/http"
	"github.com/milvus-io/milvus/internal/http/healthz"
	"github.com/milvus-io/milvus/internal/storagev2"
	"github.com/milvus-io/milvus/internal/util/adminauth"
	"github.com/milvus-io/milvus/internal/util/dependency"
	kvfactory "github.com/milvus-io/milvus/internal/util/dependency/kv"
	"github.com/milvus-io/milvus/internal/util/fileresource"
	"github.com/milvus-io/milvus/internal/util/initcore"
	internalmetrics "github.com/milvus-io/milvus/internal/util/metrics"
	"github.com/milvus-io/milvus/internal/util/pathutil"
	"github.com/milvus-io/milvus/internal/util/streamingutil/util"
	"github.com/milvus-io/milvus/pkg/v3/config"
	"github.com/milvus-io/milvus/pkg/v3/metrics"
	"github.com/milvus-io/milvus/pkg/v3/mlog"
	rocksmqimpl "github.com/milvus-io/milvus/pkg/v3/mq/mqimpl/rocksmq/server"
	"github.com/milvus-io/milvus/pkg/v3/streaming/util/message"
	"github.com/milvus-io/milvus/pkg/v3/tracer"
	"github.com/milvus-io/milvus/pkg/v3/util/conc"
	"github.com/milvus-io/milvus/pkg/v3/util/etcd"
	"github.com/milvus-io/milvus/pkg/v3/util/gc"
	"github.com/milvus-io/milvus/pkg/v3/util/logutil"
	"github.com/milvus-io/milvus/pkg/v3/util/metricsinfo"
	"github.com/milvus-io/milvus/pkg/v3/util/paramtable"
	_ "github.com/milvus-io/milvus/pkg/v3/util/symbolizer" // support symbolizer and crash dump
	"github.com/milvus-io/milvus/pkg/v3/util/typeutil"
)

// all milvus related metrics is in a separate registry
var Registry *internalmetrics.MilvusRegistry

func init() {
	Registry = internalmetrics.NewMilvusRegistry()
	metrics.Register(Registry.GoRegistry)
	metrics.RegisterMetaMetrics(Registry.GoRegistry)
	metrics.RegisterMsgStreamMetrics(Registry.GoRegistry)
	metrics.SetFilesystemMetricsCollectFn(func() []metrics.FilesystemMetrics {
		entries, err := storagev2.ListFilesystemMetrics()
		if err != nil {
			mlog.RatedWarn(context.TODO(), rate.Every(time.Minute), "failed to list filesystem metrics", mlog.Err(err))
			return nil
		}
		metricsList := make([]metrics.FilesystemMetrics, 0, len(entries))
		for _, entry := range entries {
			metricsList = append(metricsList, metrics.FilesystemMetrics{
				DisplayKey:              entry.DisplayKey,
				ReadCount:               entry.ReadCount,
				WriteCount:              entry.WriteCount,
				ReadBytes:               entry.ReadBytes,
				WriteBytes:              entry.WriteBytes,
				GetFileInfoCount:        entry.GetFileInfoCount,
				FailedCount:             entry.FailedCount,
				MultiPartUploadCreated:  entry.MultiPartUploadCreated,
				MultiPartUploadFinished: entry.MultiPartUploadFinished,
			})
		}
		return metricsList
	})
	metrics.RegisterStorageMetrics(Registry.GoRegistry)
}

// stopRocksmqIfUsed closes the RocksMQ if it is used.
func stopRocksmqIfUsed() {
	if name := util.MustSelectWALName(); name == message.WALNameRocksmq {
		rocksmqimpl.CloseRocksMQ()
	}
}

type component interface {
	healthz.Indicator
	Prepare() error
	Run() error
	Stop() error
}

func cleanLocalDir(path string) {
	_, statErr := os.Stat(path)
	// path exist, but stat error
	if statErr != nil && !os.IsNotExist(statErr) {
		mlog.Warn(context.TODO(), "Check if path exists failed when clean local data cache", mlog.Err(statErr))
		panic(statErr)
	}
	// path exist, remove all
	if statErr == nil {
		err := os.RemoveAll(path)
		if err != nil {
			mlog.Warn(context.TODO(), "Clean local data cache failed", mlog.Err(err))
			panic(err)
		}
		mlog.Info(context.TODO(), "Clean local data cache", mlog.String("path", path))
	}
}

func runComponent[T component](ctx context.Context,
	localMsg bool,
	creator func(context.Context, dependency.Factory) (T, error),
	metricRegister func(*prometheus.Registry),
) *conc.Future[component] {
	sign := make(chan struct{})
	future := conc.Go(func() (component, error) {
		// Wrap the creation and preparation phase to enable concurrent component startup
		prepareFunc := func() (component, error) {
			defer close(sign)
			factory := dependency.NewFactory(localMsg)
			var err error
			role, err := creator(ctx, factory)
			if err != nil {
				return nil, errors.Wrap(err, "create component failed")
			}
			if err := role.Prepare(); err != nil {
				return nil, errors.Wrap(err, "prepare component failed")
			}
			healthz.Register(role)
			metricRegister(Registry.GoRegistry)
			return role, nil
		}

		role, err := prepareFunc()
		if err != nil {
			return nil, err
		}

		// Run() executes after sign is closed, allowing components to start concurrently
		if err := role.Run(); err != nil {
			return nil, errors.Wrap(err, "run component failed")
		}
		return role, nil
	})

	<-sign
	return future
}

// MilvusRoles decides which components are brought up with Milvus.
type MilvusRoles struct {
	EnableProxy         bool `env:"ENABLE_PROXY"`
	EnableMixCoord      bool `env:"ENABLE_ROOT_COORD"`
	EnableQueryNode     bool `env:"ENABLE_QUERY_NODE"`
	EnableDataNode      bool `env:"ENABLE_DATA_NODE"`
	EnableStreamingNode bool `env:"ENABLE_STREAMING_NODE"`
	EnableRootCoord     bool `env:"ENABLE_ROOT_COORD"`
	EnableQueryCoord    bool `env:"ENABLE_QUERY_COORD"`
	EnableDataCoord     bool `env:"ENABLE_DATA_COORD"`
	EnableCDC           bool `env:"ENABLE_CDC"`
	Local               bool
	Alias               string
	Embedded            bool

	ServerType string

	closed chan struct{}
	once   sync.Once
}

// NewMilvusRoles creates a new MilvusRoles with private fields initialized.
func NewMilvusRoles() *MilvusRoles {
	mr := &MilvusRoles{
		closed: make(chan struct{}),
	}
	return mr
}

func (mr *MilvusRoles) printLDPreLoad() {
	const LDPreLoad = "LD_PRELOAD"
	val, ok := os.LookupEnv(LDPreLoad)
	if ok {
		mlog.Info(context.TODO(), "Enable Jemalloc", mlog.String("Jemalloc Path", val))
	}
}

func (mr *MilvusRoles) runProxy(ctx context.Context, localMsg bool) *conc.Future[component] {
	return runComponent(ctx, localMsg, components.NewProxy, metrics.RegisterProxy)
}

func (mr *MilvusRoles) runMixCoord(ctx context.Context, localMsg bool) *conc.Future[component] {
	return runComponent(ctx, localMsg, components.NewMixCoord, metrics.RegisterMixCoord)
}

func (mr *MilvusRoles) runQueryNode(ctx context.Context, localMsg bool) *conc.Future[component] {
	// clear local storage
	queryDataLocalPath := pathutil.GetPath(pathutil.RootCachePath, 0)
	if !paramtable.Get().CommonCfg.EnablePosixMode.GetAsBool() {
		// under non-posix mode, we need to clean local storage when starting query node
		// under posix mode, this clean task will be done by mixcoord
		cleanLocalDir(queryDataLocalPath)
	}
	return runComponent(ctx, localMsg, components.NewQueryNode, metrics.RegisterQueryNode)
}

func (mr *MilvusRoles) runStreamingNode(ctx context.Context, localMsg bool) *conc.Future[component] {
	return runComponent(ctx, localMsg, components.NewStreamingNode, metrics.RegisterStreamingNode)
}

func (mr *MilvusRoles) runDataNode(ctx context.Context, localMsg bool) *conc.Future[component] {
	return runComponent(ctx, localMsg, components.NewDataNode, metrics.RegisterDataNode)
}

func (mr *MilvusRoles) runCDC(ctx context.Context, localMsg bool) *conc.Future[component] {
	return runComponent(ctx, localMsg, components.NewCDC, metrics.RegisterCDC)
}

func (mr *MilvusRoles) resolveFileResourceMode() fileresource.Mode {
	params := paramtable.Get()
	modes := make([]fileresource.Mode, 0, 3)
	if mr.EnableQueryNode || mr.EnableStreamingNode {
		modes = append(modes, fileresource.ParseMode(params.CommonCfg.QNFileResourceMode.GetValue()))
	}
	if mr.EnableDataNode {
		modes = append(modes, fileresource.ParseMode(params.CommonCfg.DNFileResourceMode.GetValue()))
	}
	if mr.EnableProxy {
		modes = append(modes, fileresource.ParseMode(params.CommonCfg.ProxyFileResourceMode.GetValue()))
	}
	return fileresource.ResolveMode(modes...)
}

// waitForAllComponentsReady waits for all components to be ready.
// It will return an error if any component is not ready before closing with a fast fail strategy.
// It will return a map of components that are ready.
func (mr *MilvusRoles) waitForAllComponentsReady(cancel context.CancelFunc, componentFutureMap map[string]*conc.Future[component]) (map[string]component, error) {
	roles := make([]string, 0, len(componentFutureMap))
	futures := make([]*conc.Future[component], 0, len(componentFutureMap))
	for role, future := range componentFutureMap {
		roles = append(roles, role)
		futures = append(futures, future)
	}
	selectCases := make([]reflect.SelectCase, 1+len(componentFutureMap))
	selectCases[0] = reflect.SelectCase{
		Dir:  reflect.SelectRecv,
		Chan: reflect.ValueOf(mr.closed),
	}
	for i, future := range futures {
		selectCases[i+1] = reflect.SelectCase{
			Dir:  reflect.SelectRecv,
			Chan: reflect.ValueOf(future.Inner()),
		}
	}
	componentMap := make(map[string]component, len(componentFutureMap))
	readyCount := 0
	for {
		index, _, _ := reflect.Select(selectCases)
		if index == 0 {
			cancel()
			mlog.Warn(context.TODO(), "components are not ready before closing, wait for the start of components to be canceled...")
			return nil, context.Canceled
		} else {
			role := roles[index-1]
			component, err := futures[index-1].Await()
			readyCount++
			if err != nil {
				cancel()
				mlog.Warn(context.TODO(), "component is not ready before closing", mlog.String("role", role), mlog.Err(err))
				return nil, err
			} else {
				componentMap[role] = component
				mlog.Info(context.TODO(), "component is ready", mlog.String("role", role))
			}
		}
		selectCases[index] = reflect.SelectCase{
			Dir:  reflect.SelectRecv,
			Chan: reflect.ValueOf(nil),
		}
		if readyCount == len(componentFutureMap) {
			break
		}
	}
	return componentMap, nil
}

func (mr *MilvusRoles) setupLogger() {
	params := paramtable.Get()
	logConfig := mlog.Config{
		Level:     params.LogCfg.Level.GetValue(),
		GrpcLevel: params.LogCfg.GrpcLogLevel.GetValue(),
		Format:    params.LogCfg.Format.GetValue(),
		Stdout:    params.LogCfg.Stdout.GetAsBool(),
		File: mlog.FileLogConfig{
			RootPath:   params.LogCfg.RootPath.GetValue(),
			MaxSize:    params.LogCfg.MaxSize.GetAsInt(),
			MaxDays:    params.LogCfg.MaxAge.GetAsInt(),
			MaxBackups: params.LogCfg.MaxBackups.GetAsInt(),
		},
		AsyncWriteEnable:         params.LogCfg.AsyncWriteEnable.GetAsBool(),
		AsyncWriteFlushInterval:  params.LogCfg.AsyncWriteFlushInterval.GetAsDurationByParse(),
		AsyncWriteDroppedTimeout: params.LogCfg.AsyncWriteDroppedTimeout.GetAsDurationByParse(),
		AsyncWriteStopTimeout:    params.LogCfg.AsyncWriteStopTimeout.GetAsDurationByParse(),
		AsyncWritePendingLength:  params.LogCfg.AsyncWritePendingLength.GetAsInt(),
		AsyncWriteBufferSize:     int(params.LogCfg.AsyncWriteBufferSize.GetAsSize()),
		AsyncWriteMaxBytesPerLog: int(params.LogCfg.AsyncWriteMaxBytesPerLog.GetAsSize()),
	}
	id := paramtable.GetNodeID()
	roleName := paramtable.GetRole()
	rootPath := logConfig.File.RootPath
	if rootPath != "" {
		logConfig.File.Filename = fmt.Sprintf("%s-%d.log", roleName, id)
	} else {
		logConfig.File.Filename = ""
	}

	logutil.SetupLogger(&logConfig)

	params.Watch(params.LogCfg.Level.Key, config.NewHandler("log.level", func(event *config.Event) {
		if !event.HasUpdated || event.EventType == config.DeleteType {
			return
		}
		v := event.Value
		// trace is not a valid log level for non-segcore part, so we convert it to debug
		if strings.EqualFold(v, "trace") {
			v = "debug"
		}
		logLevel, err := mlog.ParseLevel(v)
		if err != nil {
			mlog.Warn(context.TODO(), "failed to parse log level", mlog.Err(err))
			return
		}
		mlog.SetLevel(logLevel)
		mlog.Info(context.TODO(), "log level changed", mlog.String("level", event.Value))
	}))
}

// Register serves prometheus http service
func setupPrometheusHTTPServer(r *internalmetrics.MilvusRegistry) {
	mlog.Info(context.TODO(), "setupPrometheusHTTPServer")
	http.Register(&http.Handler{
		Path:    http.MetricsPath,
		Handler: promhttp.HandlerFor(r, promhttp.HandlerOpts{}),
	})
	http.Register(&http.Handler{
		Path:    http.MetricsDefaultPath,
		Handler: promhttp.Handler(),
	})
}

func (mr *MilvusRoles) handleSignals() func() {
	sign := make(chan struct{})
	done := make(chan struct{})

	sc := make(chan os.Signal, 1)
	signal.Notify(sc,
		syscall.SIGHUP,
		syscall.SIGINT,
		syscall.SIGTERM,
		syscall.SIGQUIT)

	go func() {
		defer close(done)
		for {
			select {
			case <-sign:
				mlog.Info(context.TODO(), "All cleanup done, handleSignals goroutine quit")
				return
			case sig := <-sc:
				mlog.Warn(context.TODO(), "Get signal to exit", mlog.String("signal", sig.String()))
				mr.once.Do(func() {
					close(mr.closed)
					// reset other signals, only handle SIGINT from now
					signal.Reset(syscall.SIGQUIT, syscall.SIGHUP, syscall.SIGTERM)
				})
			}
		}
	}()
	return func() {
		close(sign)
		<-done
	}
}

// Run Milvus components.
func (mr *MilvusRoles) Run() {
	// start signal handler, defer close func
	closeFn := mr.handleSignals()
	defer closeFn()

	mlog.Info(context.TODO(), "starting running Milvus components")
	ctx, cancel := context.WithCancel(context.Background())
	defer cancel()

	mr.printLDPreLoad()

	// start milvus thread watcher to update actual thread number metrics
	thw := internalmetrics.NewThreadWatcher()
	thw.Start()
	defer thw.Stop()

	// only standalone enable localMsg
	if mr.Local {
		if err := os.Setenv(metricsinfo.DeployModeEnvKey, metricsinfo.StandaloneDeployMode); err != nil {
			mlog.Error(context.TODO(), "Failed to set deploy mode: ", mlog.Err(err))
		}

		if mr.Embedded {
			// setup config for embedded milvus
			paramtable.InitWithBaseTable(paramtable.NewBaseTable(paramtable.Files([]string{"embedded-milvus.yaml"})))
		} else {
			paramtable.Init()
		}

		params := paramtable.Get()
		// Recover visible legacy local files before etcd and components start.
		if !mr.migrateLocalStorageLayoutOrDie(ctx, params) {
			return
		}
		if params.EtcdCfg.UseEmbedEtcd.GetAsBool() {
			// Start etcd server.
			if err := etcd.InitEtcdServer(
				params.EtcdCfg.UseEmbedEtcd.GetAsBool(),
				params.EtcdCfg.ConfigPath.GetValue(),
				params.EtcdCfg.DataDir.GetValue(),
				params.EtcdCfg.EtcdLogPath.GetValue(),
				params.EtcdCfg.EtcdLogLevel.GetValue()); err != nil {
				// Panic (non-zero exit) so restart policies such as systemd
				// Restart=on-failure or docker --restart on-failure treat the
				// startup failure as a crash rather than a clean exit.
				mlog.Error(context.TODO(), "failed to start embedded Etcd server", mlog.Err(err))
				panic(err)
			}
			defer etcd.StopEtcdServer()
		}
		paramtable.SetRole(typeutil.StandaloneRole)
		defer stopRocksmqIfUsed()
	} else {
		if err := os.Setenv(metricsinfo.DeployModeEnvKey, metricsinfo.ClusterDeployMode); err != nil {
			mlog.Error(context.TODO(), "Failed to set deploy mode: ", mlog.Err(err))
		}
		paramtable.Init()
		paramtable.SetRole(mr.ServerType)
	}

	// Persist immutable configurations at startup, such as mqType paramItem
	if (mr.EnableRootCoord && mr.EnableDataCoord && mr.EnableQueryCoord) || mr.EnableMixCoord {
		// Resolve the actual walName instead of default
		walName := util.InitAndSelectWALName()
		// persist immutable configs if necessary; mq.type's literal "default" is
		// rendered to the resolved walName so the value pinned in etcd is always
		// a concrete WAL name (issue #51497)
		if err := paramtable.GetBaseTable().Manager().ProcessImmutableConfigs(map[string]func(string) string{
			paramtable.Get().MQCfg.Type.Key: func(string) string { return walName.String() },
		}); err != nil {
			mlog.Error(context.TODO(), "failed to process immutable configs", mlog.Err(err))
			return
		}
	}

	internalmetrics.InitHolmes()
	defer internalmetrics.CloseHolmes()

	// init tracer before run any component
	tracer.Init()

	enableComponents := []bool{
		mr.EnableProxy,
		mr.EnableQueryNode,
		mr.EnableDataNode,
		mr.EnableStreamingNode,
		mr.EnableMixCoord,
		mr.EnableRootCoord,
		mr.EnableQueryCoord,
		mr.EnableDataCoord,
		mr.EnableCDC,
	}
	enableComponents = lo.Filter(enableComponents, func(v bool, _ int) bool {
		return v
	})
	healthz.SetComponentNum(len(enableComponents))

	mr.setupLogger()
	defer mlog.Cleanup()

	// Worker nodes (querynode, datanode, streamingnode) host no credential
	// metadata, so without this their management plane and pprof would answer
	// 503 to root as well as to attackers once adminAuthEnabled is on. It takes
	// the lowest-priority slot: proxy and mix coord register in-process
	// verifiers that win, so single-process standalone never makes this RPC.
	rootCredentialVerifier := adminauth.NewRootCredentialVerifier(ctx, mix.NewClient)
	http.RegisterManagementVerifier(http.VerifierSlotWorker, rootCredentialVerifier.Verify)
	defer func() {
		http.RegisterManagementVerifier(http.VerifierSlotWorker, nil)
		if err := rootCredentialVerifier.Close(); err != nil {
			mlog.Warn(ctx, "close root credential verifier failed", mlog.Err(err))
		}
	}()

	http.ServeHTTP()
	setupPrometheusHTTPServer(Registry)

	if paramtable.Get().CommonCfg.GCEnabled.GetAsBool() {
		if paramtable.Get().CommonCfg.GCHelperEnabled.GetAsBool() {
			action := func(GOGC uint32) {
				debug.SetGCPercent(int(GOGC))
			}
			gc.NewTuner(paramtable.Get().CommonCfg.OverloadedMemoryThresholdPercentage.GetAsFloat(), uint32(paramtable.Get().CommonCfg.MinimumGOGCConfig.GetAsInt()), uint32(paramtable.Get().CommonCfg.MaximumGOGCConfig.GetAsInt()), action)
		} else {
			action := func(uint32) {}
			gc.NewTuner(paramtable.Get().CommonCfg.OverloadedMemoryThresholdPercentage.GetAsFloat(), uint32(paramtable.Get().CommonCfg.MinimumGOGCConfig.GetAsInt()), uint32(paramtable.Get().CommonCfg.MaximumGOGCConfig.GetAsInt()), action)
		}
	}

	// Initialize streaming service if enabled.
	if mr.ServerType == typeutil.StandaloneRole || !mr.EnableDataNode {
		// only datanode does not init streaming service
		streaming.Init()
		defer func() {
			if err := streaming.Release(); err != nil {
				mlog.Warn(context.TODO(), "release streaming service failed", mlog.Err(err))
			}
		}()
	}

	effectiveFileResourceMode := mr.resolveFileResourceMode()
	fileresource.SetLocalMode(effectiveFileResourceMode)
	mlog.Info(ctx, "resolved process file resource mode", mlog.String("mode", effectiveFileResourceMode.String()))

	local := mr.Local
	componentFutureMap := make(map[string]*conc.Future[component])

	if (mr.EnableRootCoord && mr.EnableDataCoord && mr.EnableQueryCoord) || mr.EnableMixCoord {
		paramtable.SetLocalComponentEnabled(typeutil.MixCoordRole)
		// The version-gate switcher is a cluster-wide, one-shot capability:
		// only the MixCoord role starts it, so a single coordinator drives the
		// flip of every version-gated config item. Other roles observe the
		// flipped value through the regular config refresh.
		paramtable.StartVersionGateSwitcher()
		mixCoord := mr.runMixCoord(ctx, local)
		componentFutureMap[typeutil.MixCoordRole] = mixCoord
	}

	if mr.EnableQueryNode {
		paramtable.SetLocalComponentEnabled(typeutil.QueryNodeRole)
		queryNode := mr.runQueryNode(ctx, local)
		componentFutureMap[typeutil.QueryNodeRole] = queryNode
	}

	if mr.EnableDataNode {
		paramtable.SetLocalComponentEnabled(typeutil.DataNodeRole)
		dataNode := mr.runDataNode(ctx, local)
		componentFutureMap[typeutil.DataNodeRole] = dataNode
	}

	if mr.EnableProxy {
		paramtable.SetLocalComponentEnabled(typeutil.ProxyRole)
		proxy := mr.runProxy(ctx, local)
		componentFutureMap[typeutil.ProxyRole] = proxy
	}

	if mr.EnableStreamingNode {
		// Before initializing the local streaming node, make sure the local registry is ready.
		paramtable.SetLocalComponentEnabled(typeutil.StreamingNodeRole)
		streamingNode := mr.runStreamingNode(ctx, local)
		componentFutureMap[typeutil.StreamingNodeRole] = streamingNode
	}

	if mr.EnableCDC {
		paramtable.SetLocalComponentEnabled(typeutil.CDCRole)
		cdc := mr.runCDC(ctx, local)
		componentFutureMap[typeutil.CDCRole] = cdc
	}

	componentMap, err := mr.waitForAllComponentsReady(cancel, componentFutureMap)
	if err != nil {
		mlog.Warn(context.TODO(), "Failed to wait for all components ready", mlog.Err(err))
		return
	}
	mlog.Info(context.TODO(), "All components are ready", mlog.Strings("roles", lo.Keys(componentMap)))

	http.RegisterStopComponent(func(role string) error {
		if len(role) == 0 || componentMap[role] == nil {
			return fmt.Errorf("stop component [%s] in [%s] is not supported", role, mr.ServerType)
		}

		mlog.Info(context.TODO(), "unregister component before stop", mlog.String("role", role))
		healthz.UnRegister(role)
		return componentMap[role].Stop()
	})

	http.RegisterCheckComponentReady(func(role string) error {
		if len(role) == 0 || componentMap[role] == nil {
			return fmt.Errorf("check component state for [%s] in [%s] is not supported", role, mr.ServerType)
		}

		// for coord component, if it's in standby state, it will return StateCode_StandBy
		code := componentMap[role].Health(context.TODO())
		if code != commonpb.StateCode_Healthy {
			return fmt.Errorf("component [%s] in [%s] is not healthy", role, mr.ServerType)
		}

		return nil
	})

	paramtable.Get().WatchKeyPrefix("trace", config.NewHandler("tracing handler", func(e *config.Event) {
		params := paramtable.Get()

		exp, err := tracer.CreateTracerExporter(params)
		if err != nil {
			mlog.Warn(context.TODO(), "Init tracer failed", mlog.Err(err))
			return
		}

		// close old provider
		err = tracer.CloseTracerProvider(context.Background())
		if err != nil {
			mlog.Warn(context.TODO(), "Close old provider failed, stop reset", mlog.Err(err))
			return
		}

		tracer.SetTracerProvider(exp, params.TraceCfg.SampleFraction.GetAsFloat())
		mlog.Info(context.TODO(), "Reset tracer finished", mlog.String("Exporter", params.TraceCfg.Exporter.GetValue()), mlog.Float64("SampleFraction", params.TraceCfg.SampleFraction.GetAsFloat()))

		tracer.NotifyTracerProviderUpdated()

		if paramtable.GetRole() == typeutil.QueryNodeRole || paramtable.GetRole() == typeutil.StandaloneRole {
			initcore.ResetTraceConfig(params)
			mlog.Info(context.TODO(), "Reset segcore tracer finished", mlog.String("Exporter", params.TraceCfg.Exporter.GetValue()))
		}
	}))

	paramtable.SetCreateTime(time.Now())
	paramtable.SetUpdateTime(time.Now())

	<-mr.closed

	mixCoord := componentMap[typeutil.MixCoordRole]
	streamingNode := componentMap[typeutil.StreamingNodeRole]
	queryNode := componentMap[typeutil.QueryNodeRole]
	dataNode := componentMap[typeutil.DataNodeRole]
	cdc := componentMap[typeutil.CDCRole]
	proxy := componentMap[typeutil.ProxyRole]

	// stop coordinators first
	coordinators := []component{mixCoord}
	for idx, coord := range coordinators {
		mlog.Warn(context.TODO(), "stop processing")
		if coord != nil {
			mlog.Info(context.TODO(), "stop coord", mlog.Int("idx", idx), mlog.Any("coord", coord))
			coord.Stop()
		}
	}
	mlog.Info(context.TODO(), "All coordinators have stopped")

	// stop nodes
	nodes := []component{streamingNode, queryNode, dataNode, cdc}
	stopNodeWG := &sync.WaitGroup{}
	for _, node := range nodes {
		if node != nil {
			stopNodeWG.Add(1)
			go func() {
				defer func() {
					stopNodeWG.Done()
					mlog.Info(context.TODO(), "stop node done", mlog.Any("node", node))
				}()
				mlog.Info(context.TODO(), "stop node...", mlog.Any("node", node))
				node.Stop()
			}()
		}
	}
	stopNodeWG.Wait()
	mlog.Info(context.TODO(), "All nodes have stopped")

	if proxy != nil {
		proxy.Stop()
		mlog.Info(context.TODO(), "proxy stopped!")
	}

	// close reused etcd client
	kvfactory.CloseEtcdClient()

	mlog.Info(context.TODO(), "Milvus components graceful stop done")
}

func (mr *MilvusRoles) GetRoles() []string {
	roles := make([]string, 0)
	if mr.EnableMixCoord {
		roles = append(roles, typeutil.MixCoordRole)
	}
	if mr.EnableProxy {
		roles = append(roles, typeutil.ProxyRole)
	}
	if mr.EnableQueryNode {
		roles = append(roles, typeutil.QueryNodeRole)
	}
	if mr.EnableDataNode {
		roles = append(roles, typeutil.DataNodeRole)
	}
	if mr.EnableCDC {
		roles = append(roles, typeutil.CDCRole)
	}
	return roles
}