org.elasticsearch.common.logging.ESJsonLayout Maven / Gradle / Ivy
/*
* Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
* or more contributor license agreements. Licensed under the Elastic License
* 2.0 and the Server Side Public License, v 1; you may not use this file except
* in compliance with, at your election, the Elastic License 2.0 or the Server
* Side Public License, v 1.
*/
package org.elasticsearch.common.logging;
import org.apache.logging.log4j.core.Layout;
import org.apache.logging.log4j.core.LogEvent;
import org.apache.logging.log4j.core.config.Node;
import org.apache.logging.log4j.core.config.plugins.Plugin;
import org.apache.logging.log4j.core.config.plugins.PluginAttribute;
import org.apache.logging.log4j.core.config.plugins.PluginBuilderFactory;
import org.apache.logging.log4j.core.config.plugins.PluginFactory;
import org.apache.logging.log4j.core.layout.AbstractStringLayout;
import org.apache.logging.log4j.core.layout.ByteBufferDestination;
import org.apache.logging.log4j.core.layout.PatternLayout;
import org.elasticsearch.common.Strings;
import java.nio.charset.Charset;
import java.nio.charset.StandardCharsets;
import java.util.LinkedHashMap;
import java.util.Map;
import java.util.Set;
/**
* Formats log events as strings in a json format.
*
* The class is wrapping the {@link PatternLayout} with a pattern to format into json. This gives more flexibility and control over how the
* log messages are formatted in {@link org.apache.logging.log4j.core.layout.JsonLayout}
* There are fields which are always present in the log line:
*
* - type - the type of logs. These represent appenders and help docker distinguish log streams.
* - timestamp - ISO8601 with additional timezone ID
* - level - INFO, WARN etc
* - component - logger name, most of the times class name
* - cluster.name - taken from sys:es.logs.cluster_name system property because it is always set
* - node.name - taken from NodeNamePatternConverter, as it can be set in runtime as hostname when not set in elasticsearch.yml
* - node_and_cluster_id - in json as node.id and cluster.uuid - taken from NodeIdConverter and present
* once clusterStateUpdate is first received
* - message - a json escaped message. Multiline messages will be converted to single line with new line explicitly
* replaced to \n
* - exceptionAsJson - in json as a stacktrace field. Only present when throwable is passed as a parameter when using a logger.
* Taken from JsonThrowablePatternConverter
*
*
* It is possible to add more field by using {@link ESLogMessage#with} method which allow adding key value pairs
* or override field with overrideFields
* appender.logger.layout.overrideFields=message
.
* In the example above the pattern will be ... "message": %OverrideField{message} ...
* the message passed to a logger will be overridden with a value from %OverrideField{message}
* Once an appender is defined to be overriding a field, all the log events should contain this field.
*
* The value taken from ESLogMessage has to be a simple escaped JSON value.
* @deprecated ECSJsonlayout should be used as JSON logs layout
*/
@Deprecated(since = "v8")
@Plugin(name = "ESJsonLayout", category = Node.CATEGORY, elementType = Layout.ELEMENT_TYPE, printObject = true)
public class ESJsonLayout extends AbstractStringLayout {
private final PatternLayout patternLayout;
private String esmessagefields;
protected ESJsonLayout(String typeName, Charset charset, String[] overrideFields) {
super(charset);
this.esmessagefields = String.join(",", overrideFields);
this.patternLayout = PatternLayout.newBuilder()
.withPattern(pattern(typeName, overrideFields))
.withAlwaysWriteExceptions(false)
.build();
}
private static String pattern(String type, String[] esmessagefields) {
if (Strings.isEmpty(type)) {
throw new IllegalArgumentException("layout parameter 'type_name' cannot be empty");
}
Map map = new LinkedHashMap<>();
map.put("type", inQuotes(type));
map.put("timestamp", inQuotes("%d{yyyy-MM-dd'T'HH:mm:ss,SSSZZ}"));
map.put("level", inQuotes("%p"));
map.put("component", inQuotes("%c{1.}"));
map.put("cluster.name", inQuotes("${sys:es.logs.cluster_name}"));
map.put("node.name", inQuotes("%node_name"));
map.put("message", inQuotes("%notEmpty{%enc{%marker}{JSON} }%enc{%.-10000m}{JSON}"));
// esmessagefields are treated as potentially overriding
for (String key : esmessagefields) {
map.remove(key);
}
return createPattern(map, Set.of(esmessagefields));
}
private static String createPattern(Map map, Set esmessagefields) {
StringBuilder sb = new StringBuilder();
sb.append("{");
String separator = "";
for (Map.Entry entry : map.entrySet()) {
// fields present in esmessagefields are meant to be provided in CustomMapFields
if (esmessagefields.contains(entry.getKey()) == false) {
sb.append(separator);
appendField(sb, entry);
}
separator = ", ";
}
sb.append(notEmpty(", %node_and_cluster_id "));
sb.append(notEmpty(", %CustomMapFields "));
sb.append("%exceptionAsJson ");
sb.append("}");
sb.append(System.lineSeparator());
return sb.toString();
}
private static void appendField(StringBuilder sb, Map.Entry entry) {
sb.append(jsonKey(entry.getKey()));
sb.append(entry.getValue().toString());
}
private static String notEmpty(String value) {
return "%notEmpty{" + value + "}";
}
private static CharSequence jsonKey(String s) {
return inQuotes(s) + ": ";
}
private static String inQuotes(String s) {
return "\"" + s + "\"";
}
@PluginFactory
public static ESJsonLayout createLayout(String type, Charset charset, String[] overrideFields) {
return new ESJsonLayout(type, charset, overrideFields);
}
PatternLayout getPatternLayout() {
return patternLayout;
}
public static class Builder> extends AbstractStringLayout.Builder
implements
org.apache.logging.log4j.core.util.Builder {
@PluginAttribute("type_name")
String type;
@PluginAttribute(value = "charset", defaultString = "UTF-8")
Charset charset;
@PluginAttribute("esmessagefields")
private String overrideFields;
public Builder() {
setCharset(StandardCharsets.UTF_8);
}
@Override
public ESJsonLayout build() {
String[] split = Strings.isNullOrEmpty(overrideFields) ? new String[] {} : overrideFields.split(",");
return ESJsonLayout.createLayout(type, charset, split);
}
public Charset getCharset() {
return charset;
}
public B setCharset(final Charset charset) {
this.charset = charset;
return asBuilder();
}
public String getType() {
return type;
}
public B setType(final String type) {
this.type = type;
return asBuilder();
}
public String getOverrideFields() {
return overrideFields;
}
public B setOverrideFields(String overrideFields) {
this.overrideFields = overrideFields;
return asBuilder();
}
}
@PluginBuilderFactory
public static > B newBuilder() {
return new ESJsonLayout.Builder().asBuilder();
}
@Override
public String toSerializable(final LogEvent event) {
return patternLayout.toSerializable(event);
}
@Override
public Map getContentFormat() {
return patternLayout.getContentFormat();
}
@Override
public void encode(final LogEvent event, final ByteBufferDestination destination) {
patternLayout.encode(event, destination);
}
@Override
public String toString() {
final StringBuilder sb = new StringBuilder("ESJsonLayout{");
sb.append("patternLayout=").append(patternLayout);
sb.append('}');
return sb.toString();
}
}