integration

README

package integration

This package is responsible of defining the types representing an integration which can be used by several components of the agent to configure checks or logs collectors for example.

Documentation

Index

• type CommonGlobalConfig
• type CommonInstanceConfig
• type Config
  • func (c *Config) AddMetrics(metrics Data) error
  • func (c *Config) Digest() string
  • func (c *Config) Equal(cfg *Config) bool
  • func (c *Config) GetTemplateVariablesForInstance(i int) []tmplvar.TemplateVar
  • func (c *Config) HasFilter(filter containers.FilterType) bool
  • func (c *Config) IsCheckConfig() bool
  • func (c *Config) IsLogConfig() bool
  • func (c *Config) IsTemplate() bool
  • func (c *Config) String() string
• type CreationTime
• type Data
  • func (c *Data) GetNameForInstance() string
  • func (c *Data) MergeAdditionalTags(tags []string) error
  • func (c *Data) SetField(key string, value interface{}) error
• type JSONMap
• type RawMap

Types

type CommonGlobalConfig

type CommonGlobalConfig struct {
	Service string `yaml:"service"`
}

CommonGlobalConfig holds the reserved fields for the yaml init_config data

type CommonInstanceConfig

type CommonInstanceConfig struct {
	MinCollectionInterval int      `yaml:"min_collection_interval"`
	EmptyDefaultHostname  bool     `yaml:"empty_default_hostname"`
	Tags                  []string `yaml:"tags"`
	Service               string   `yaml:"service"`
	Name                  string   `yaml:"name"`
	Namespace             string   `yaml:"namespace"`
}

CommonInstanceConfig holds the reserved fields for the yaml instance data

type Config

type Config struct {
	Name                    string       `json:"check_name"`                // the name of the check
	Instances               []Data       `json:"instances"`                 // the list of instances in Yaml
	InitConfig              Data         `json:"init_config"`               // the init_config in Yaml
	MetricConfig            Data         `json:"metric_config"`             // the metric config in Yaml (jmx check only)
	LogsConfig              Data         `json:"logs"`                      // the logs config in Yaml (logs-agent only)
	ADIdentifiers           []string     `json:"ad_identifiers"`            // the list of AutoDiscovery identifiers (optional)
	Provider                string       `json:"provider"`                  // the provider that issued the config
	Entity                  string       `json:"-"`                         // the entity ID (optional)
	TaggerEntity            string       `json:"-"`                         // the tagger entity ID (optional)
	ClusterCheck            bool         `json:"cluster_check"`             // cluster-check configuration flag
	NodeName                string       `json:"node_name"`                 // node name in case of an endpoint check backed by a pod
	CreationTime            CreationTime `json:"-"`                         // creation time of service
	Source                  string       `json:"source"`                    // the source of the configuration
	IgnoreAutodiscoveryTags bool         `json:"ignore_autodiscovery_tags"` // used to ignore tags coming from autodiscovery
	MetricsExcluded         bool         `json:"-"`                         // whether metrics collection is disabled (set by container listeners only)
	LogsExcluded            bool         `json:"-"`                         // whether logs collection is disabled (set by container listeners only)
}

Config is a generic container for configuration files

func (*Config) AddMetrics

func (c *Config) AddMetrics(metrics Data) error

AddMetrics adds metrics to a check configuration

func (*Config) Digest

func (c *Config) Digest() string

Digest returns an hash value representing the data stored in this configuration. The ClusterCheck field is intentionally left out to keep a stable digest between the cluster-agent and the node-agents

func (*Config) Equal

func (c *Config) Equal(cfg *Config) bool

Equal determines whether the passed config is the same

func (*Config) GetTemplateVariablesForInstance

func (c *Config) GetTemplateVariablesForInstance(i int) []tmplvar.TemplateVar

GetTemplateVariablesForInstance returns a slice of raw template variables it found in a config instance template.

func (*Config) HasFilter

func (c *Config) HasFilter(filter containers.FilterType) bool

HasFilter returns true if metrics or logs collection must be disabled for this config. no containers.GlobalFilter case here because we don't create services that are globally excluded in AD

func (*Config) IsCheckConfig

func (c *Config) IsCheckConfig() bool

IsCheckConfig returns true if the config is a node-agent check configuration,

func (*Config) IsLogConfig

func (c *Config) IsLogConfig() bool

IsLogConfig returns true if config contains a logs config.

func (*Config) IsTemplate

func (c *Config) IsTemplate() bool

IsTemplate returns if the config has AD identifiers

func (*Config) String

func (c *Config) String() string

String YAML representation of the config

type CreationTime

type CreationTime int

CreationTime represents the moment when the service was launched compare to the agent start.

const (
	// Before indicates the service was launched before the agent start
	Before CreationTime = iota
	// After indicates the service was launched after the agent start
	After
)

type Data

type Data []byte

Data contains YAML code

func (*Data) GetNameForInstance

func (c *Data) GetNameForInstance() string

GetNameForInstance returns the name from an instance if specified, fallback on namespace

func (*Data) MergeAdditionalTags

func (c *Data) MergeAdditionalTags(tags []string) error

MergeAdditionalTags merges additional tags to possible existing config tags

func (*Data) SetField

func (c *Data) SetField(key string, value interface{}) error

SetField allows to set an arbitrary field to a given value, overriding the existing value if present

type JSONMap

type JSONMap map[string]interface{}

JSONMap is the generic type to hold JSON configurations

type RawMap

type RawMap map[interface{}]interface{}

RawMap is the generic type to hold YAML configurations