package influxdb import ( "fmt" "log" "math/rand" "strings" "time" "github.com/influxdata/telegraf" "github.com/influxdata/telegraf/internal" "github.com/influxdata/telegraf/metric" "github.com/influxdata/telegraf/plugins/outputs" "github.com/influxdata/telegraf/plugins/outputs/influxdb/client" ) var ( // Quote Ident replacer. qiReplacer = strings.NewReplacer("\n", `\n`, `\`, `\\`, `"`, `\"`) ) // InfluxDB struct is the primary data structure for the plugin type InfluxDB struct { // URL is only for backwards compatibility URL string URLs []string `toml:"urls"` Username string Password string Database string UserAgent string RetentionPolicy string WriteConsistency string Timeout internal.Duration UDPPayload int `toml:"udp_payload"` HTTPProxy string `toml:"http_proxy"` HTTPHeaders map[string]string `toml:"http_headers"` ContentEncoding string `toml:"content_encoding"` // Path to CA file SSLCA string `toml:"ssl_ca"` // Path to host cert file SSLCert string `toml:"ssl_cert"` // Path to cert key file SSLKey string `toml:"ssl_key"` // Use SSL but skip chain & host verification InsecureSkipVerify bool // Precision is only here for legacy support. It will be ignored. Precision string clients []client.Client } var sampleConfig = ` ## The full HTTP or UDP URL for your InfluxDB instance. ## ## Multiple urls can be specified as part of the same cluster, ## this means that only ONE of the urls will be written to each interval. # urls = ["udp://127.0.0.1:8089"] # UDP endpoint example urls = ["http://127.0.0.1:8086"] # required ## The target database for metrics (telegraf will create it if not exists). database = "telegraf" # required ## Name of existing retention policy to write to. Empty string writes to ## the default retention policy. retention_policy = "" ## Write consistency (clusters only), can be: "any", "one", "quorum", "all" write_consistency = "any" ## Write timeout (for the InfluxDB client), formatted as a string. ## If not provided, will default to 5s. 0s means no timeout (not recommended). timeout = "5s" # username = "telegraf" # password = "metricsmetricsmetricsmetrics" ## Set the user agent for HTTP POSTs (can be useful for log differentiation) # user_agent = "telegraf" ## Set UDP payload size, defaults to InfluxDB UDP Client default (512 bytes) # udp_payload = 512 ## Optional SSL Config # ssl_ca = "/etc/telegraf/ca.pem" # ssl_cert = "/etc/telegraf/cert.pem" # ssl_key = "/etc/telegraf/key.pem" ## Use SSL but skip chain & host verification # insecure_skip_verify = false ## HTTP Proxy Config # http_proxy = "http://corporate.proxy:3128" ## Optional HTTP headers # http_headers = {"X-Special-Header" = "Special-Value"} ## Compress each HTTP request payload using GZIP. # content_encoding = "gzip" ` // Connect initiates the primary connection to the range of provided URLs func (i *InfluxDB) Connect() error { var urls []string urls = append(urls, i.URLs...) // Backward-compatibility with single Influx URL config files // This could eventually be removed in favor of specifying the urls as a list if i.URL != "" { urls = append(urls, i.URL) } tlsConfig, err := internal.GetTLSConfig( i.SSLCert, i.SSLKey, i.SSLCA, i.InsecureSkipVerify) if err != nil { return err } for _, u := range urls { switch { case strings.HasPrefix(u, "udp"): config := client.UDPConfig{ URL: u, PayloadSize: i.UDPPayload, } c, err := client.NewUDP(config) if err != nil { return fmt.Errorf("Error creating UDP Client [%s]: %s", u, err) } i.clients = append(i.clients, c) default: // If URL doesn't start with "udp", assume HTTP client config := client.HTTPConfig{ URL: u, Timeout: i.Timeout.Duration, TLSConfig: tlsConfig, UserAgent: i.UserAgent, Username: i.Username, Password: i.Password, HTTPProxy: i.HTTPProxy, HTTPHeaders: client.HTTPHeaders{}, ContentEncoding: i.ContentEncoding, } for header, value := range i.HTTPHeaders { config.HTTPHeaders[header] = value } wp := client.WriteParams{ Database: i.Database, RetentionPolicy: i.RetentionPolicy, Consistency: i.WriteConsistency, } c, err := client.NewHTTP(config, wp) if err != nil { return fmt.Errorf("Error creating HTTP Client [%s]: %s", u, err) } i.clients = append(i.clients, c) err = c.Query(fmt.Sprintf(`CREATE DATABASE "%s"`, qiReplacer.Replace(i.Database))) if err != nil { if !strings.Contains(err.Error(), "Status Code [403]") { log.Println("I! Database creation failed: " + err.Error()) } continue } } } rand.Seed(time.Now().UnixNano()) return nil } // Close will terminate the session to the backend, returning error if an issue arises func (i *InfluxDB) Close() error { return nil } // SampleConfig returns the formatted sample configuration for the plugin func (i *InfluxDB) SampleConfig() string { return sampleConfig } // Description returns the human-readable function definition of the plugin func (i *InfluxDB) Description() string { return "Configuration for influxdb server to send metrics to" } // Write will choose a random server in the cluster to write to until a successful write // occurs, logging each unsuccessful. If all servers fail, return error. func (i *InfluxDB) Write(metrics []telegraf.Metric) error { r := metric.NewReader(metrics) // This will get set to nil if a successful write occurs err := fmt.Errorf("Could not write to any InfluxDB server in cluster") p := rand.Perm(len(i.clients)) for _, n := range p { if e := i.clients[n].WriteStream(r); e != nil { // If the database was not found, try to recreate it: if strings.Contains(e.Error(), "database not found") { errc := i.clients[n].Query(fmt.Sprintf(`CREATE DATABASE "%s"`, qiReplacer.Replace(i.Database))) if errc != nil { log.Printf("E! Error: Database %s not found and failed to recreate\n", i.Database) } } if strings.Contains(e.Error(), "field type conflict") { log.Printf("E! Field type conflict, dropping conflicted points: %s", e) // setting err to nil, otherwise we will keep retrying and points // w/ conflicting types will get stuck in the buffer forever. err = nil break } if strings.Contains(e.Error(), "points beyond retention policy") { log.Printf("W! Points beyond retention policy: %s", e) // This error is indicates the point is older than the // retention policy permits, and is probably not a cause for // concern. Retrying will not help unless the retention // policy is modified. err = nil break } if strings.Contains(e.Error(), "unable to parse") { log.Printf("E! Parse error; dropping points: %s", e) // This error indicates a bug in Telegraf or InfluxDB parsing // of line protocol. Retries will not be successful. err = nil break } if strings.Contains(e.Error(), "hinted handoff queue not empty") { // This is an informational message err = nil break } // Log write failure log.Printf("E! InfluxDB Output Error: %s", e) } else { err = nil break } } return err } func newInflux() *InfluxDB { return &InfluxDB{ Timeout: internal.Duration{Duration: time.Second * 5}, } } func init() { outputs.Add("influxdb", func() telegraf.Output { return newInflux() }) }