Document and add support to input plugins for logging alias (#6357)

plugins/inputs/kafka_consumer_legacy/README.md

@@ -13,12 +13,16 @@ from the same topic in parallel.
 [[inputs.kafka_consumer]]
   ## topic(s) to consume
   topics = ["telegraf"]
+
   ## an array of Zookeeper connection strings
   zookeeper_peers = ["localhost:2181"]
+
   ## Zookeeper Chroot
   zookeeper_chroot = ""
+
   ## the name of the consumer group
   consumer_group = "telegraf_metrics_consumers"
+
   ## Offset (must be either "oldest" or "newest")
   offset = "oldest"
 

plugins/inputs/kafka_consumer_legacy/kafka_consumer_legacy.go

@@ -2,7 +2,6 @@ package kafka_consumer_legacy
 
 import (
 	"fmt"
-	"log"
 	"strings"
 	"sync"
 
@@ -30,6 +29,8 @@ type Kafka struct {
 	Offset string
 	parser parsers.Parser
 
+	Log telegraf.Logger
+
 	sync.Mutex
 
 	// channel for all incoming kafka messages
@@ -49,12 +50,16 @@ type Kafka struct {
 var sampleConfig = `
   ## topic(s) to consume
   topics = ["telegraf"]
+
   ## an array of Zookeeper connection strings
   zookeeper_peers = ["localhost:2181"]
+
   ## Zookeeper Chroot
   zookeeper_chroot = ""
+
   ## the name of the consumer group
   consumer_group = "telegraf_metrics_consumers"
+
   ## Offset (must be either "oldest" or "newest")
   offset = "oldest"
 
@@ -96,7 +101,7 @@ func (k *Kafka) Start(acc telegraf.Accumulator) error {
 	case "newest":
 		config.Offsets.Initial = sarama.OffsetNewest
 	default:
-		log.Printf("I! WARNING: Kafka consumer invalid offset '%s', using 'oldest'\n",
+		k.Log.Infof("WARNING: Kafka consumer invalid offset '%s', using 'oldest'\n",
 			k.Offset)
 		config.Offsets.Initial = sarama.OffsetOldest
 	}
@@ -121,7 +126,7 @@ func (k *Kafka) Start(acc telegraf.Accumulator) error {
 
 	// Start the kafka message reader
 	go k.receiver()
-	log.Printf("I! Started the kafka consumer service, peers: %v, topics: %v\n",
+	k.Log.Infof("Started the kafka consumer service, peers: %v, topics: %v\n",
 		k.ZookeeperPeers, k.Topics)
 	return nil
 }

plugins/inputs/kafka_consumer_legacy/kafka_consumer_legacy_integration_test.go

@@ -37,6 +37,7 @@ func TestReadsMetricsFromKafka(t *testing.T) {
 
 	// Start the Kafka Consumer
 	k := &Kafka{
+		Log:            testutil.Logger{},
 		ConsumerGroup:  "telegraf_test_consumers",
 		Topics:         []string{testTopic},
 		ZookeeperPeers: zkPeers,

plugins/inputs/kafka_consumer_legacy/kafka_consumer_legacy_test.go

@@ -21,6 +21,7 @@ const (
 func newTestKafka() (*Kafka, chan *sarama.ConsumerMessage) {
 	in := make(chan *sarama.ConsumerMessage, 1000)
 	k := Kafka{
+		Log:             testutil.Logger{},
 		ConsumerGroup:   "test",
 		Topics:          []string{"telegraf"},
 		ZookeeperPeers:  []string{"localhost:2181"},