accessLogs
AccessLogsParams
Example usage: kind: access-logs params: logName: “accessLog” log: logFormat: COMMON templateExpressions: originIp: origin.ip sourceUser: origin.user timestamp: request.time method: request.method | “” url: request.path protocol: request.scheme responseCode: response.code responseSize: response.size labels: originIp: origin.ip sourceUser: origin.user timestamp: request.time method: request.method | “” url: request.path protocol: request.scheme responseCode: response.code responseSize: response.size
Field | Type | Description |
---|
logName | string | Identifies a collection of related log entries. |
log | AccessLog | The log that will be constructed and handed to the aspect at runtime. |
AccessLog
Describes how attributes must be evaluated to produce values for a log message.
Field | Type | Description |
---|
descriptorName | string | Only used if logFormat is CUSTOM. Links this AccessLog to a LogEntryDescriptor that describes the log's template. |
templateExpressions | repeated map<string, string> | Map of template variable name to expression for the descriptor's logTemplate. At run time each expression will be evaluated, and together they will provide values for the log's template string. Labels and template expressions do not mix: if the result of some expression is needed for both constructing the payload and for dimensioning the log entry, it must be included both in these expressions and in the labels expressions. |
labels | repeated map<string, string> | Map of LogEntryDescriptor label name to attribute expression. At run time each expression will be evaluated to determine the value that will be used to fill in the log template. The result of evaluating the expression must match the ValueType of the label in the LogEntryDescriptor. |