package consul import ( "context" "encoding/json" "errors" "flag" "fmt" "net/url" "strings" "sync" "time" "github.com/VictoriaMetrics/VictoriaMetrics/lib/logger" "github.com/VictoriaMetrics/VictoriaMetrics/lib/promscrape/discoveryutils" "github.com/VictoriaMetrics/metrics" ) // SDCheckInterval is check interval for Consul service discovery. var SDCheckInterval = flag.Duration("promscrape.consulSDCheckInterval", 30*time.Second, "Interval for checking for changes in Consul. "+ "This works only if consul_sd_configs is configured in '-promscrape.config' file. "+ "See https://docs.victoriametrics.com/sd_configs.html#consul_sd_configs for details") // consulWatcher is a watcher for consul api, updates services map in background with long-polling. type consulWatcher struct { client *discoveryutils.Client serviceNamesQueryArgs string serviceNodesQueryArgs string watchServices []string watchTags []string // servicesLock protects services servicesLock sync.Mutex services map[string]*serviceWatcher stoppedCh chan struct{} } type serviceWatcher struct { serviceName string serviceNodes []ServiceNode stoppedCh chan struct{} requestCtx context.Context requestCancel context.CancelFunc } // newConsulWatcher creates new watcher and starts background service discovery for Consul. func newConsulWatcher(client *discoveryutils.Client, sdc *SDConfig, datacenter, namespace string) *consulWatcher { baseQueryArgs := "?dc=" + url.QueryEscape(datacenter) if sdc.AllowStale == nil || *sdc.AllowStale { baseQueryArgs += "&stale" } if namespace != "" { baseQueryArgs += "&ns=" + url.QueryEscape(namespace) } if sdc.Partition != "" { baseQueryArgs += "&partition=" + url.QueryEscape(sdc.Partition) } for k, v := range sdc.NodeMeta { baseQueryArgs += "&node-meta=" + url.QueryEscape(k+":"+v) } serviceNodesQueryArgs := baseQueryArgs for _, tag := range sdc.Tags { serviceNodesQueryArgs += "&tag=" + url.QueryEscape(tag) } // filter could be added only for baseQuery requests for /v1/catalog/services // serviceNodesQueryArgs doesn't support it if len(sdc.Filter) > 0 { baseQueryArgs += "&filter=" + url.QueryEscape(sdc.Filter) } cw := &consulWatcher{ client: client, serviceNamesQueryArgs: baseQueryArgs, serviceNodesQueryArgs: serviceNodesQueryArgs, watchServices: sdc.Services, watchTags: sdc.Tags, services: make(map[string]*serviceWatcher), stoppedCh: make(chan struct{}), } initCh := make(chan struct{}) go func() { cw.watchForServicesUpdates(initCh) close(cw.stoppedCh) }() // wait for initialization to complete <-initCh return cw } func (cw *consulWatcher) mustStop() { cw.client.Stop() <-cw.stoppedCh } func (cw *consulWatcher) updateServices(serviceNames []string) { var initWG sync.WaitGroup // Start watchers for new services. cw.servicesLock.Lock() for _, serviceName := range serviceNames { if _, ok := cw.services[serviceName]; ok { // The watcher for serviceName already exists. continue } ctx, cancel := context.WithCancel(cw.client.Context()) sw := &serviceWatcher{ serviceName: serviceName, stoppedCh: make(chan struct{}), requestCtx: ctx, requestCancel: cancel, } cw.services[serviceName] = sw serviceWatchersCreated.Inc() initWG.Add(1) go func() { serviceWatchersCount.Inc() sw.watchForServiceNodesUpdates(cw, &initWG) serviceWatchersCount.Dec() close(sw.stoppedCh) }() } // Stop watchers for removed services. newServiceNamesMap := make(map[string]struct{}, len(serviceNames)) for _, serviceName := range serviceNames { newServiceNamesMap[serviceName] = struct{}{} } var swsStopped []*serviceWatcher for serviceName, sw := range cw.services { if _, ok := newServiceNamesMap[serviceName]; ok { continue } sw.requestCancel() delete(cw.services, serviceName) swsStopped = append(swsStopped, sw) } cw.servicesLock.Unlock() // Wait until deleted service watchers are stopped. for _, sw := range swsStopped { <-sw.stoppedCh serviceWatchersStopped.Inc() } // Wait until added service watchers are initialized. initWG.Wait() } // watchForServicesUpdates watches for new services and updates it in cw. // // watchForServicesUpdates closes the initCh once the initialization is complete and first discovery iteration is done. func (cw *consulWatcher) watchForServicesUpdates(initCh chan struct{}) { index := int64(0) apiServer := cw.client.APIServer() f := func() { serviceNames, newIndex, err := cw.getBlockingServiceNames(index) if err != nil { if !errors.Is(err, context.Canceled) { logger.Errorf("cannot obtain Consul serviceNames from %q: %s", apiServer, err) } return } if index == newIndex { // Nothing changed. return } cw.updateServices(serviceNames) index = newIndex } logger.Infof("started Consul service watcher for %q", apiServer) f() // send signal that initialization is complete close(initCh) checkInterval := getCheckInterval() ticker := time.NewTicker(checkInterval / 2) defer ticker.Stop() stopCh := cw.client.Context().Done() for { select { case <-ticker.C: f() case <-stopCh: logger.Infof("stopping Consul service watchers for %q", apiServer) startTime := time.Now() var swsStopped []*serviceWatcher cw.servicesLock.Lock() for _, sw := range cw.services { sw.requestCancel() swsStopped = append(swsStopped, sw) } cw.servicesLock.Unlock() for _, sw := range swsStopped { <-sw.stoppedCh serviceWatchersStopped.Inc() } logger.Infof("stopped Consul service watcher for %q in %.3f seconds", apiServer, time.Since(startTime).Seconds()) return } } } var ( serviceWatchersCreated = metrics.NewCounter("vm_promscrape_discovery_consul_service_watchers_created_total") serviceWatchersStopped = metrics.NewCounter("vm_promscrape_discovery_consul_service_watchers_stopped_total") serviceWatchersCount = metrics.NewCounter("vm_promscrape_discovery_consul_service_watchers") ) // getBlockingServiceNames obtains serviceNames via blocking request to Consul. // // It returns an empty serviceNames list if response contains the same index. func (cw *consulWatcher) getBlockingServiceNames(index int64) ([]string, int64, error) { path := "/v1/catalog/services" + cw.serviceNamesQueryArgs data, newIndex, err := getBlockingAPIResponse(cw.client.Context(), cw.client, path, index) if err != nil { return nil, index, err } if index == newIndex { // Nothing changed - return an empty serviceNames list. return nil, index, nil } var m map[string][]string if err := json.Unmarshal(data, &m); err != nil { return nil, index, fmt.Errorf("cannot parse response from %q: %w; data=%q", path, err, data) } serviceNames := make([]string, 0, len(m)) for serviceName, tags := range m { if !shouldCollectServiceByName(cw.watchServices, serviceName) { continue } if !shouldCollectServiceByTags(cw.watchTags, tags) { continue } serviceNames = append(serviceNames, serviceName) } return serviceNames, newIndex, nil } // watchForServiceNodesUpdates watches for Consul serviceNode changes for the given serviceName. // // watchForServiceNodesUpdates calls initWG.Done() once the initialization is complete and the first discovery iteration is done. func (sw *serviceWatcher) watchForServiceNodesUpdates(cw *consulWatcher, initWG *sync.WaitGroup) { apiServer := cw.client.APIServer() index := int64(0) path := "/v1/health/service/" + sw.serviceName + cw.serviceNodesQueryArgs f := func() { data, newIndex, err := getBlockingAPIResponse(sw.requestCtx, cw.client, path, index) if err != nil { if !errors.Is(err, context.Canceled) { logger.Errorf("cannot obtain Consul serviceNodes for serviceName=%q from %q: %s", sw.serviceName, apiServer, err) } return } if index == newIndex { // Nothing changed. return } sns, err := parseServiceNodes(data) if err != nil { logger.Errorf("cannot parse Consul serviceNodes response for serviceName=%q from %q: %s", sw.serviceName, apiServer, err) return } cw.servicesLock.Lock() sw.serviceNodes = sns cw.servicesLock.Unlock() index = newIndex } f() // Notify caller that initialization is complete initWG.Done() checkInterval := getCheckInterval() ticker := time.NewTicker(checkInterval / 2) defer ticker.Stop() stopCh := sw.requestCtx.Done() for { select { case <-ticker.C: f() case <-stopCh: return } } } // getServiceNodesSnapshot returns a snapshot of discovered ServiceNodes. func (cw *consulWatcher) getServiceNodesSnapshot() map[string][]ServiceNode { cw.servicesLock.Lock() sns := make(map[string][]ServiceNode, len(cw.services)) for svc, sw := range cw.services { sns[svc] = sw.serviceNodes } cw.servicesLock.Unlock() return sns } func shouldCollectServiceByName(filterServices []string, serviceName string) bool { if len(filterServices) == 0 { return true } for _, filterService := range filterServices { // Use case-insensitive comparison for service names according to https://github.com/VictoriaMetrics/VictoriaMetrics/issues/1422 if strings.EqualFold(filterService, serviceName) { return true } } return false } func shouldCollectServiceByTags(filterTags, tags []string) bool { if len(filterTags) == 0 { return true } for _, filterTag := range filterTags { hasTag := false for _, tag := range tags { if tag == filterTag { hasTag = true break } } if !hasTag { return false } } return true } func getCheckInterval() time.Duration { d := *SDCheckInterval if d <= time.Second { return time.Second } return d }