v1.30.3 Latest Latest

This package is not in the latest version of its module.

Go to latest
Published: May 20, 2024 License: MIT Imports: 45 Imported by: 47




This section is empty.


This section is empty.


func ApplyMigrations added in v1.27.0

func ApplyMigrations(data []byte) ([]byte, uint64, error)

func DisableSecretProtection added in v1.29.0

func DisableSecretProtection()

func EnableSecretProtection added in v1.29.0

func EnableSecretProtection()

func GetDefaultConfigPath added in v1.27.0

func GetDefaultConfigPath() ([]string, error)

Try to find a default config file at these locations (in order):

  2. $HOME/.telegraf/telegraf.conf
  3. /etc/telegraf/telegraf.conf and /etc/telegraf/telegraf.d/*.conf

func LoadConfigFile added in v1.24.0

func LoadConfigFile(config string) ([]byte, bool, error)

LoadConfigFile loads the content of a configuration file and returns it together with a flag denoting if the file is from a remote location such as a web server.

func PluginNameCounts added in v1.16.0

func PluginNameCounts(plugins []string) []string

PluginNameCounts returns a list of sorted plugin names and their count

func WalkDirectory added in v1.25.0

func WalkDirectory(path string) ([]string, error)

WalkDirectory collects all toml files that need to be loaded


type AgentConfig

type AgentConfig struct {
	// Interval at which to gather information
	Interval Duration

	// RoundInterval rounds collection interval to 'interval'.
	//     ie, if Interval=10s then always collect on :00, :10, :20, etc.
	RoundInterval bool

	// Collected metrics are rounded to the precision specified. Precision is
	// specified as an interval with an integer + unit (e.g. 0s, 10ms, 2us, 4s).
	// Valid time units are "ns", "us" (or "µs"), "ms", "s".
	// By default, or when set to "0s", precision will be set to the same
	// timestamp order as the collection interval, with the maximum being 1s:
	//   ie, when interval = "10s", precision will be "1s"
	//       when interval = "250ms", precision will be "1ms"
	// Precision will NOT be used for service inputs. It is up to each individual
	// service input to set the timestamp at the appropriate precision.
	Precision Duration

	// CollectionJitter is used to jitter the collection by a random amount.
	// Each plugin will sleep for a random time within jitter before collecting.
	// This can be used to avoid many plugins querying things like sysfs at the
	// same time, which can have a measurable effect on the system.
	CollectionJitter Duration

	// CollectionOffset is used to shift the collection by the given amount.
	// This can be used to avoid many plugins querying constraint devices
	// at the same time by manually scheduling them in time.
	CollectionOffset Duration

	// FlushInterval is the Interval at which to flush data
	FlushInterval Duration

	// FlushJitter Jitters the flush interval by a random amount.
	// This is primarily to avoid large write spikes for users running a large
	// number of telegraf instances.
	// ie, a jitter of 5s and interval 10s means flushes will happen every 10-15s
	FlushJitter Duration

	// MetricBatchSize is the maximum number of metrics that is written to an
	// output plugin in one call.
	MetricBatchSize int

	// MetricBufferLimit is the max number of metrics that each output plugin
	// will cache. The buffer is cleared when a successful write occurs. When
	// full, the oldest metrics will be overwritten. This number should be a
	// multiple of MetricBatchSize. Due to current implementation, this could
	// not be less than 2 times MetricBatchSize.
	MetricBufferLimit int

	// FlushBufferWhenFull tells Telegraf to flush the metric buffer whenever
	// it fills up, regardless of FlushInterval. Setting this option to true
	// does _not_ deactivate FlushInterval.
	FlushBufferWhenFull bool `toml:"flush_buffer_when_full" deprecated:"0.13.0;1.30.0;option is ignored"`

	// TODO(cam): Remove UTC and parameter, they are no longer
	// valid for the agent config. Leaving them here for now for backwards-
	// compatibility
	UTC bool `toml:"utc" deprecated:"1.0.0;option is ignored"`

	// Debug is the option for running in debug mode
	Debug bool `toml:"debug"`

	// Quiet is the option for running in quiet mode
	Quiet bool `toml:"quiet"`

	// Log target controls the destination for logs and can be one of "file",
	// "stderr" or, on Windows, "eventlog".  When set to "file", the output file
	// is determined by the "logfile" setting.
	LogTarget string `toml:"logtarget"`

	// Name of the file to be logged to when using the "file" logtarget.  If set to
	// the empty string then logs are written to stderr.
	Logfile string `toml:"logfile"`

	// The file will be rotated after the time interval specified.  When set
	// to 0 no time based rotation is performed.
	LogfileRotationInterval Duration `toml:"logfile_rotation_interval"`

	// The logfile will be rotated when it becomes larger than the specified
	// size.  When set to 0 no size based rotation is performed.
	LogfileRotationMaxSize Size `toml:"logfile_rotation_max_size"`

	// Maximum number of rotated archives to keep, any older logs are deleted.
	// If set to -1, no archives are removed.
	LogfileRotationMaxArchives int `toml:"logfile_rotation_max_archives"`

	// Pick a timezone to use when logging or type 'local' for local time.
	LogWithTimezone string `toml:"log_with_timezone"`

	Hostname     string
	OmitHostname bool

	// Method for translating SNMP objects. 'netsnmp' to call external programs,
	// 'gosmi' to use the built-in library.
	SnmpTranslator string `toml:"snmp_translator"`

	// Name of the file to load the state of plugins from and store the state to.
	// If uncommented and not empty, this file will be used to save the state of
	// stateful plugins on termination of Telegraf. If the file exists on start,
	// the state in the file will be restored for the plugins.
	Statefile string `toml:"statefile"`

	// Flag to always keep tags explicitly defined in the plugin itself and
	// ensure those tags always pass filtering.
	AlwaysIncludeLocalTags bool `toml:"always_include_local_tags"`

	// Flag to always keep tags explicitly defined in the global tags section
	// and ensure those tags always pass filtering.
	AlwaysIncludeGlobalTags bool `toml:"always_include_global_tags"`

	// Flag to skip running processors after aggregators
	// By default, processors are run a second time after aggregators. Changing
	// this setting to true will skip the second run of processors.
	SkipProcessorsAfterAggregators bool `toml:"skip_processors_after_aggregators"`

AgentConfig defines configuration that will be used by the Telegraf agent

type Config

type Config struct {
	UnusedFields map[string]bool

	Tags               map[string]string
	InputFilters       []string
	OutputFilters      []string
	SecretStoreFilters []string

	SecretStores map[string]telegraf.SecretStore

	Agent       *AgentConfig
	Inputs      []*models.RunningInput
	Outputs     []*models.RunningOutput
	Aggregators []*models.RunningAggregator
	// Processors have a slice wrapper type because they need to be sorted
	Processors    models.RunningProcessors
	AggProcessors models.RunningProcessors

	Deprecations map[string][]int64

	Persister *persister.Persister

	NumberSecrets uint64
	// contains filtered or unexported fields

Config specifies the URL/user/password for the database that telegraf will be logging to, as well as all the plugins that the user has specified

func NewConfig

func NewConfig() *Config

NewConfig creates a new struct to hold the Telegraf config. For historical reasons, It holds the actual instances of the running plugins once the configuration is parsed.

func (*Config) AggregatorNames

func (c *Config) AggregatorNames() []string

AggregatorNames returns a list of strings of the configured aggregators.

func (*Config) CollectDeprecationInfos added in v1.21.0

func (c *Config) CollectDeprecationInfos(inFilter, outFilter, aggFilter, procFilter []string) map[string][]PluginDeprecationInfo

func (*Config) InputNames

func (c *Config) InputNames() []string

InputNames returns a list of strings of the configured inputs.

func (*Config) LinkSecrets added in v1.25.0

func (c *Config) LinkSecrets() error

func (*Config) ListTags

func (c *Config) ListTags() string

ListTags returns a string of tags specified in the config, line-protocol style

func (*Config) LoadAll added in v1.25.0

func (c *Config) LoadAll(configFiles ...string) error

func (*Config) LoadConfig

func (c *Config) LoadConfig(path string) error

LoadConfig loads the given config files and applies it to c

func (*Config) LoadConfigData

func (c *Config) LoadConfigData(data []byte) error

LoadConfigData loads TOML-formatted config data

func (*Config) OutputNames

func (c *Config) OutputNames() []string

OutputNames returns a list of strings of the configured outputs.

func (*Config) PrintDeprecationList added in v1.21.0

func (c *Config) PrintDeprecationList(plugins []PluginDeprecationInfo)

func (*Config) ProcessorNames

func (c *Config) ProcessorNames() []string

ProcessorNames returns a list of strings of the configured processors.

func (*Config) SecretstoreNames added in v1.25.0

func (c *Config) SecretstoreNames() []string

SecretstoreNames returns a list of strings of the configured secret-stores.

type DeprecationInfo added in v1.24.0

type DeprecationInfo struct {
	// Name of the plugin or plugin option
	Name string
	// LogLevel is the level of deprecation which currently corresponds to a log-level
	LogLevel telegraf.Escalation
	// contains filtered or unexported fields

DeprecationInfo contains all important information to describe a deprecated entity

type Duration

type Duration time.Duration

Duration is a time.Duration

func (*Duration) UnmarshalText added in v1.15.3

func (d *Duration) UnmarshalText(b []byte) error

UnmarshalTOML parses the duration from the TOML config file

type OrderedPlugin added in v1.25.0

type OrderedPlugin struct {
	Line int
	// contains filtered or unexported fields

Ordered plugins used to keep the order in which they appear in a file

type OrderedPlugins added in v1.25.0

type OrderedPlugins []*OrderedPlugin

func (OrderedPlugins) Len added in v1.25.0

func (op OrderedPlugins) Len() int

func (OrderedPlugins) Less added in v1.25.0

func (op OrderedPlugins) Less(i, j int) bool

func (OrderedPlugins) Swap added in v1.25.0

func (op OrderedPlugins) Swap(i, j int)

type PluginDeprecationInfo added in v1.24.0

type PluginDeprecationInfo struct {

	// Options deprecated for this plugin
	Options []DeprecationInfo

PluginDeprecationInfo holds all information about a deprecated plugin or it's options

type Secret added in v1.25.0

type Secret struct {
	// contains filtered or unexported fields

Secret safely stores sensitive data such as a password or token

var (

	// OldEnvVarReplacement is a switch to allow going back to pre v1.27.0
	// environment variable replacement behavior
	OldEnvVarReplacement = false

	// Password specified via command-line
	Password Secret

func NewSecret added in v1.25.0

func NewSecret(b []byte) Secret

NewSecret creates a new secret from the given bytes

func (*Secret) Destroy added in v1.25.0

func (s *Secret) Destroy()

Destroy the secret content

func (*Secret) Empty added in v1.25.1

func (s *Secret) Empty() bool

Empty return if the secret is completely empty

func (*Secret) EqualTo added in v1.26.0

func (s *Secret) EqualTo(ref []byte) (bool, error)

EqualTo performs a constant-time comparison of the secret to the given reference

func (*Secret) Get added in v1.25.0

func (s *Secret) Get() (SecretBuffer, error)

Get return the string representation of the secret

func (*Secret) GetUnlinked added in v1.25.0

func (s *Secret) GetUnlinked() []string

GetUnlinked return the parts of the secret that is not yet linked to a resolver

func (s *Secret) Link(resolvers map[string]telegraf.ResolveFunc) error

Link used the given resolver map to link the secret parts to their secret-store resolvers.

func (*Secret) Set added in v1.26.1

func (s *Secret) Set(value []byte) error

Set overwrites the secret's value with a new one. Please note, the secret is not linked again, so only references to secret-stores can be used, e.g. by adding more clear-text or reordering secrets.

func (*Secret) UnmarshalText added in v1.25.1

func (s *Secret) UnmarshalText(b []byte) error

UnmarshalText creates a secret from a toml value following the "string" rule.

type SecretBuffer added in v1.28.2

type SecretBuffer interface {
	// Size returns the length of the buffer content
	Size() int
	// Grow will grow the capacity of the underlying buffer to the given size
	Grow(capacity int)
	// Bytes returns the content of the buffer as bytes.
	// NOTE: The returned bytes shall NOT be accessed after destroying the
	// buffer using 'Destroy()' as the underlying the memory area might be
	// wiped and invalid.
	Bytes() []byte
	// TemporaryString returns the content of the buffer as a string.
	// NOTE: The returned String shall NOT be accessed after destroying the
	// buffer using 'Destroy()' as the underlying the memory area might be
	// wiped and invalid.
	TemporaryString() string
	// String returns a copy of the underlying buffer's content as string.
	// It is safe to use the returned value after destroying the buffer.
	String() string
	// Destroy will wipe the buffer's content and destroy the underlying
	// buffer. Do not access the buffer after destroying it.

SecretBuffer allows to access the content of the secret

type Size

type Size int64

Size is an int64

func (*Size) UnmarshalText added in v1.15.3

func (s *Size) UnmarshalText(b []byte) error

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL