newrelic

README

New Relic Output Plugin

This plugins writes to New Relic Insights using the Metrics API.

To use this plugin you must first obtain an Insights API Key.

Telegraf minimum version: Telegraf 1.15.0

Global configuration options

In addition to the plugin-specific configuration settings, plugins support additional global and plugin configuration settings. These settings are used to modify metrics, tags, and field or create aliases and configure ordering, etc. See the CONFIGURATION.md for more details.

Configuration

# Send metrics to New Relic metrics endpoint
[[outputs.newrelic]]
  ## The 'insights_key' parameter requires a NR license key.
  ## New Relic recommends you create one
  ## with a convenient name such as TELEGRAF_INSERT_KEY.
  ## reference: https://docs.newrelic.com/docs/apis/intro-apis/new-relic-api-keys/#ingest-license-key
  # insights_key = "New Relic License Key Here"

  ## Prefix to add to add to metric name for easy identification.
  ## This is very useful if your metric names are ambiguous.
  # metric_prefix = ""

  ## Timeout for writes to the New Relic API.
  # timeout = "15s"

  ## HTTP Proxy override. If unset use values from the standard
  ## proxy environment variables to determine proxy, if any.
  # http_proxy = "http://corporate.proxy:3128"

  ## Metric URL override to enable geographic location endpoints.
  # If not set use values from the standard
  # metric_url = "https://metric-api.newrelic.com/metric/v1"

Documentation

Index

• type NewRelic
  • func (nr *NewRelic) Close() error
  • func (nr *NewRelic) Connect() error
  • func (*NewRelic) SampleConfig() string
  • func (nr *NewRelic) Write(metrics []telegraf.Metric) error

Types

type NewRelic

type NewRelic struct {
	InsightsKey  string          `toml:"insights_key"`
	MetricPrefix string          `toml:"metric_prefix"`
	Timeout      config.Duration `toml:"timeout"`
	HTTPProxy    string          `toml:"http_proxy"`
	MetricURL    string          `toml:"metric_url"`
	// contains filtered or unexported fields
}

NewRelic nr structure

func (*NewRelic) Close

func (nr *NewRelic) Close() error

Close any connections to the Output

func (*NewRelic) Connect

func (nr *NewRelic) Connect() error

Connect to the Output

func (*NewRelic) SampleConfig

func (*NewRelic) SampleConfig() string

func (*NewRelic) Write

func (nr *NewRelic) Write(metrics []telegraf.Metric) error

Write takes in group of points to be written to the Output