Document new option

cmd/telegraf/agent.conf

@@ -53,13 +53,13 @@
   ## Log only error level messages.
   # quiet = false
 
-  ## 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.
+  ## Log target controls the destination for logs and can be one of "text",
+  ## "structured" or, on Windows, "eventlog". The output file (if any) is
+  ## determined by the "logfile" setting.
   # logtarget = "file"
 
-  ## 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.
+  ## Name of the file to be logged to or stderr if unset or empty. This
+  ## setting is ignored for the "eventlog" target.
   # logfile = ""
 
   ## The logfile will be rotated after the time interval specified.  When set
@@ -80,9 +80,9 @@
   # log_with_timezone = ""
 
   ## Override default hostname, if empty use os.Hostname()
-  hostname = ""
+  # hostname = ""
   ## If set to true, do no set the "host" tag in the telegraf agent.
-  omit_hostname = false
+  # omit_hostname = false
 
   ## Method of translating SNMP objects. Can be "netsnmp" (deprecated) which
   ## translates by calling external programs snmptranslate and snmptable,

config/config.go

@@ -123,7 +123,7 @@ func NewConfig() *Config {
 			Interval:                   Duration(10 * time.Second),
 			RoundInterval:              true,
 			FlushInterval:              Duration(10 * time.Second),
-			LogTarget:                  "file",
+			LogTarget:                  "text",
 			LogfileRotationMaxArchives: 5,
 		},
 

docs/CONFIGURATION.md

@@ -297,13 +297,13 @@ The agent table configures Telegraf and the defaults used across all plugins.
   Log only error level messages.
 
 - **logtarget**:
-  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
+  Log target controls the destination for logs and can be one of "text",
+  "structured" or, on Windows, "eventlog". The output file (if any) is
   determined by the "logfile" setting.
 
 - **logfile**:
-  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.
+  Name of the file to be logged to or stderr if unset or empty. This
+  setting is ignored for the "eventlog" target.
 
 - **logfile_rotation_interval**:
   The logfile will be rotated after the time interval specified.  When set to