Stdio

The stdio adapter enables Istio to output logs and metrics to the local machine. Logs and metrics can be directed to Mixer’s standard output stream, standard error stream, or to any locally reachable file. When outputting to files, you can enable file rotation such that the adapter will automatically manage a set of file backups as data is generated.

This adapter supports the logentry template. and the metric template.

Params

Configuration format for the stdio adapter

FieldTypeDescriptionRequired
logStreamStream

Selects which standard stream to write to for log entries. STDERR is the default Stream.

No
severityLevelsmap<string, Level>

Maps from severity strings as specified in LogEntry instances to the set of levels supported by this adapter. This defaults to a map of

"INFORMATIONAL" : INFO,
"informational" : INFO,
"INFO" : INFO,
"info" : INFO,
"WARNING" : WARNING,
"warning" : WARNING,
"WARN": WARNING,
"warning": WARNING,
"ERROR": ERROR,
"error": ERROR,
"ERR": ERROR,
"err": ERROR,
"FATAL": ERROR,
"fatal": ERROR,
No
metricLevelLevel

The level to assign to metrics being output. Defaults to INFO.

No
outputAsJsonbool

Whether to output a console-friendly or json-friendly format. Defaults to true.

No
outputLevelLevel

The minimum level to output, anything less than this level is ignored. Defaults to INFO (everything).

No
outputPathstring

The file system path when outputting to a file or rotating file.

When using rotated log files, this path is used as a foundational path. This is where log output is normally saved. When a rotation needs to take place because the file got too big or too old, then the file is renamed by appending a timestamp to the name. Such renamed files are called backups. Once a backup has been created, output resumes to this path.

No
maxMegabytesBeforeRotationint32

The maximum size in megabytes of a log file before it gets rotated. It defaults to 100 megabytes.

No
maxDaysBeforeRotationint32

The maximum number of days to retain old rotated log files based on the timestamp encoded in their filename. Note that a day is defined as 24 hours and may not exactly correspond to calendar days due to daylight savings, leap seconds, etc. The default is to remove log files older than 30 days. 0 indicates no limit.

No
maxRotatedFilesint32

The maximum number of old rotated log files to retain. The default is to retain at most 1000 logs. 0 indicates no limit.

No

Params.Stream

Stream is used to select between different log output sinks.

NameDescription
STDOUT

Output to the Mixer process’ standard output stream. This is the default value.

STDERR

Output to the Mixer process’ standard error stream.

FILE

Output to a specific file.

ROTATED_FILE

Output to a specific rotating file, controlled by the various file rotation options.

Params.Level

Importance level for individual items output by this adapter.

NameDescription
INFO

informational, warning, and error log messages are included

WARNING

warning and error log messages are included

ERROR

only error log messages are included

Was this information useful?
Do you have any suggestions for improvement?

Thanks for your feedback!