mirror of
https://github.com/octoleo/syncthing.git
synced 2024-11-10 15:20:56 +00:00
916ec63af6
This is a new revision of the discovery server. Relevant changes and non-changes: - Protocol towards clients is unchanged. - Recommended large scale design is still to be deployed nehind nginx (I tested, and it's still a lot faster at terminating TLS). - Database backend is leveldb again, only. It scales enough, is easy to setup, and we don't need any backend to take care of. - Server supports replication. This is a simple TCP channel - protect it with a firewall when deploying over the internet. (We deploy this within the same datacenter, and with firewall.) Any incoming client announces are sent over the replication channel(s) to other peer discosrvs. Incoming replication changes are applied to the database as if they came from clients, but without the TLS/certificate overhead. - Metrics are exposed using the prometheus library, when enabled. - The database values and replication protocol is protobuf, because JSON was quite CPU intensive when I tried that and benchmarked it. - The "Retry-After" value for failed lookups gets slowly increased from a default of 120 seconds, by 5 seconds for each failed lookup, independently by each discosrv. This lowers the query load over time for clients that are never seen. The Retry-After maxes out at 3600 after a couple of weeks of this increase. The number of failed lookups is stored in the database, now and then (avoiding making each lookup a database put). All in all this means clients can be pointed towards a cluster using just multiple A / AAAA records to gain both load sharing and redundancy (if one is down, clients will talk to the remaining ones). GitHub-Pull-Request: https://github.com/syncthing/syncthing/pull/4648
107 lines
2.8 KiB
Go
107 lines
2.8 KiB
Go
// Copyright 2015 The Prometheus Authors
|
|
// Licensed 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 model
|
|
|
|
import (
|
|
"encoding/json"
|
|
"fmt"
|
|
"regexp"
|
|
"time"
|
|
)
|
|
|
|
// Matcher describes a matches the value of a given label.
|
|
type Matcher struct {
|
|
Name LabelName `json:"name"`
|
|
Value string `json:"value"`
|
|
IsRegex bool `json:"isRegex"`
|
|
}
|
|
|
|
func (m *Matcher) UnmarshalJSON(b []byte) error {
|
|
type plain Matcher
|
|
if err := json.Unmarshal(b, (*plain)(m)); err != nil {
|
|
return err
|
|
}
|
|
|
|
if len(m.Name) == 0 {
|
|
return fmt.Errorf("label name in matcher must not be empty")
|
|
}
|
|
if m.IsRegex {
|
|
if _, err := regexp.Compile(m.Value); err != nil {
|
|
return err
|
|
}
|
|
}
|
|
return nil
|
|
}
|
|
|
|
// Validate returns true iff all fields of the matcher have valid values.
|
|
func (m *Matcher) Validate() error {
|
|
if !m.Name.IsValid() {
|
|
return fmt.Errorf("invalid name %q", m.Name)
|
|
}
|
|
if m.IsRegex {
|
|
if _, err := regexp.Compile(m.Value); err != nil {
|
|
return fmt.Errorf("invalid regular expression %q", m.Value)
|
|
}
|
|
} else if !LabelValue(m.Value).IsValid() || len(m.Value) == 0 {
|
|
return fmt.Errorf("invalid value %q", m.Value)
|
|
}
|
|
return nil
|
|
}
|
|
|
|
// Silence defines the representation of a silence definiton
|
|
// in the Prometheus eco-system.
|
|
type Silence struct {
|
|
ID uint64 `json:"id,omitempty"`
|
|
|
|
Matchers []*Matcher `json:"matchers"`
|
|
|
|
StartsAt time.Time `json:"startsAt"`
|
|
EndsAt time.Time `json:"endsAt"`
|
|
|
|
CreatedAt time.Time `json:"createdAt,omitempty"`
|
|
CreatedBy string `json:"createdBy"`
|
|
Comment string `json:"comment,omitempty"`
|
|
}
|
|
|
|
// Validate returns true iff all fields of the silence have valid values.
|
|
func (s *Silence) Validate() error {
|
|
if len(s.Matchers) == 0 {
|
|
return fmt.Errorf("at least one matcher required")
|
|
}
|
|
for _, m := range s.Matchers {
|
|
if err := m.Validate(); err != nil {
|
|
return fmt.Errorf("invalid matcher: %s", err)
|
|
}
|
|
}
|
|
if s.StartsAt.IsZero() {
|
|
return fmt.Errorf("start time missing")
|
|
}
|
|
if s.EndsAt.IsZero() {
|
|
return fmt.Errorf("end time missing")
|
|
}
|
|
if s.EndsAt.Before(s.StartsAt) {
|
|
return fmt.Errorf("start time must be before end time")
|
|
}
|
|
if s.CreatedBy == "" {
|
|
return fmt.Errorf("creator information missing")
|
|
}
|
|
if s.Comment == "" {
|
|
return fmt.Errorf("comment missing")
|
|
}
|
|
if s.CreatedAt.IsZero() {
|
|
return fmt.Errorf("creation timestamp missing")
|
|
}
|
|
return nil
|
|
}
|