interrupts

README

Interrupts Input Plugin

The interrupts plugin gathers metrics about IRQs from /proc/interrupts and /proc/softirqs.

Configuration

# This plugin gathers interrupts data from /proc/interrupts and /proc/softirqs.
[[inputs.interrupts]]
  ## When set to true, cpu metrics are tagged with the cpu.  Otherwise cpu is
  ## stored as a field.
  ##
  ## The default is false for backwards compatibility, and will be changed to
  ## true in a future version.  It is recommended to set to true on new
  ## deployments.
  # cpu_as_tag = false

  ## To filter which IRQs to collect, make use of tagpass / tagdrop, i.e.
  # [inputs.interrupts.tagdrop]
  #   irq = [ "NET_RX", "TASKLET" ]

Metrics

There are two styles depending on the value of cpu_as_tag.

With cpu_as_tag = false:

• interrupts

  • tags:
    • irq (IRQ name)
    • type
    • device (name of the device that is located at the IRQ)
    • cpu
  • fields:
    • cpu (int, number of interrupts per cpu)
    • total (int, total number of interrupts)

• soft_interrupts

  • tags:
    • irq (IRQ name)
    • type
    • device (name of the device that is located at the IRQ)
    • cpu
  • fields:
    • cpu (int, number of interrupts per cpu)
    • total (int, total number of interrupts)

With cpu_as_tag = true:

• interrupts

  • tags:
    • irq (IRQ name)
    • type
    • device (name of the device that is located at the IRQ)
    • cpu
  • fields:
    • count (int, number of interrupts)

• soft_interrupts

  • tags:
    • irq (IRQ name)
    • type
    • device (name of the device that is located at the IRQ)
    • cpu
  • fields:
    • count (int, number of interrupts)

Example Output

With cpu_as_tag = false:

interrupts,irq=0,type=IO-APIC,device=2-edge\ timer,cpu=cpu0 count=23i 1489346531000000000
interrupts,irq=1,type=IO-APIC,device=1-edge\ i8042,cpu=cpu0 count=9i 1489346531000000000
interrupts,irq=30,type=PCI-MSI,device=65537-edge\ virtio1-input.0,cpu=cpu1 count=1i 1489346531000000000
soft_interrupts,irq=NET_RX,cpu=cpu0 count=280879i 1489346531000000000

With cpu_as_tag = true:

interrupts,cpu=cpu6,irq=PIW,type=Posted-interrupt\ wakeup\ event count=0i 1543539773000000000
interrupts,cpu=cpu7,irq=PIW,type=Posted-interrupt\ wakeup\ event count=0i 1543539773000000000
soft_interrupts,cpu=cpu0,irq=HI count=246441i 1543539773000000000
soft_interrupts,cpu=cpu1,irq=HI count=159154i 1543539773000000000

Documentation

Index

• type IRQ
  • func NewIRQ(id string) *IRQ
• type Interrupts
  • func (s *Interrupts) Gather(acc telegraf.Accumulator) error
  • func (*Interrupts) SampleConfig() string

Types

type IRQ

type IRQ struct {
	ID     string
	Type   string
	Device string
	Total  int64
	Cpus   []int64
}

func NewIRQ

func NewIRQ(id string) *IRQ

type Interrupts

type Interrupts struct {
	CPUAsTag bool `toml:"cpu_as_tag"`
}

func (*Interrupts) Gather

func (s *Interrupts) Gather(acc telegraf.Accumulator) error

func (*Interrupts) SampleConfig

func (*Interrupts) SampleConfig() string