001 /* 002 * Licensed to the Apache Software Foundation (ASF) under one or more 003 * contributor license agreements. See the NOTICE file distributed with 004 * this work for additional information regarding copyright ownership. 005 * The ASF licenses this file to You under the Apache license, Version 2.0 006 * (the "License"); you may not use this file except in compliance with 007 * the License. You may obtain a copy of the License at 008 * 009 * http://www.apache.org/licenses/LICENSE-2.0 010 * 011 * Unless required by applicable law or agreed to in writing, software 012 * distributed under the License is distributed on an "AS IS" BASIS, 013 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 014 * See the license for the specific language governing permissions and 015 * limitations under the license. 016 */ 017 package org.apache.logging.log4j.core.layout; 018 019 import java.util.HashMap; 020 import java.util.Map; 021 import org.apache.logging.log4j.core.LogEvent; 022 import org.apache.logging.log4j.core.config.plugins.Plugin; 023 import org.apache.logging.log4j.core.config.plugins.PluginAttr; 024 import org.apache.logging.log4j.core.config.plugins.PluginFactory; 025 import org.apache.logging.log4j.core.helpers.Charsets; 026 import org.apache.logging.log4j.core.net.Facility; 027 import org.apache.logging.log4j.core.net.Priority; 028 029 import java.net.InetAddress; 030 import java.net.UnknownHostException; 031 import java.nio.charset.Charset; 032 import java.text.SimpleDateFormat; 033 import java.util.Date; 034 import java.util.Locale; 035 import java.util.regex.Matcher; 036 import java.util.regex.Pattern; 037 038 039 /** 040 * Formats a log event as a BSD Log record. 041 */ 042 @Plugin(name = "SyslogLayout", type = "Core", elementType = "layout", printObject = true) 043 public class SyslogLayout extends AbstractStringLayout { 044 /** 045 * Match newlines in a platform-independent manner. 046 */ 047 public static final Pattern NEWLINE_PATTERN = Pattern.compile("\\r?\\n"); 048 049 private final Facility facility; 050 private final boolean includeNewLine; 051 private final String escapeNewLine; 052 053 /** 054 * Date format used if header = true. 055 */ 056 private final SimpleDateFormat dateFormat = new SimpleDateFormat("MMM dd HH:mm:ss ", Locale.ENGLISH); 057 /** 058 * Host name used to identify messages from this appender. 059 */ 060 private final String localHostname = getLocalHostname(); 061 062 063 064 protected SyslogLayout(final Facility facility, final boolean includeNL, final String escapeNL, final Charset c) { 065 super(c); 066 this.facility = facility; 067 this.includeNewLine = includeNL; 068 this.escapeNewLine = escapeNL == null ? null : Matcher.quoteReplacement(escapeNL); 069 } 070 071 /** 072 * Formats a {@link org.apache.logging.log4j.core.LogEvent} in conformance with the BSD Log record format. 073 * 074 * @param event The LogEvent 075 * @return the event formatted as a String. 076 */ 077 public String toSerializable(final LogEvent event) { 078 final StringBuilder buf = new StringBuilder(); 079 080 buf.append("<"); 081 buf.append(Priority.getPriority(facility, event.getLevel())); 082 buf.append(">"); 083 addDate(event.getMillis(), buf); 084 buf.append(" "); 085 buf.append(localHostname); 086 buf.append(" "); 087 088 String message = event.getMessage().getFormattedMessage(); 089 if (null != escapeNewLine) { 090 message = NEWLINE_PATTERN.matcher(message).replaceAll(escapeNewLine); 091 } 092 buf.append(message); 093 094 if (includeNewLine) { 095 buf.append("\n"); 096 } 097 return buf.toString(); 098 } 099 100 /** 101 * This method gets the network name of the machine we are running on. 102 * Returns "UNKNOWN_LOCALHOST" in the unlikely case where the host name 103 * cannot be found. 104 * 105 * @return String the name of the local host 106 */ 107 private String getLocalHostname() { 108 try { 109 final InetAddress addr = InetAddress.getLocalHost(); 110 return addr.getHostName(); 111 } catch (final UnknownHostException uhe) { 112 LOGGER.error("Could not determine local host name", uhe); 113 return "UNKNOWN_LOCALHOST"; 114 } 115 } 116 117 private synchronized void addDate(final long timestamp, final StringBuilder buf) { 118 final int index = buf.length() + 4; 119 buf.append(dateFormat.format(new Date(timestamp))); 120 // RFC 3164 says leading space, not leading zero on days 1-9 121 if (buf.charAt(index) == '0') { 122 buf.setCharAt(index, ' '); 123 } 124 } 125 126 /** 127 * SyslogLayout's content format is specified by:<p/> 128 * Key: "structured" Value: "false"<p/> 129 * Key: "dateFormat" Value: "MMM dd HH:mm:ss "<p/> 130 * Key: "format" Value: "<LEVEL>TIMESTAMP PROP(HOSTNAME) MESSAGE"<p/> 131 * Key: "formatType" Value: "logfilepatternreceiver" (format uses the keywords supported by LogFilePatternReceiver) 132 * @return Map of content format keys supporting SyslogLayout 133 */ 134 public Map<String, String> getContentFormat() 135 { 136 Map<String, String> result = new HashMap<String, String>(); 137 result.put("structured", "false"); 138 result.put("formatType", "logfilepatternreceiver"); 139 result.put("dateFormat", dateFormat.toPattern()); 140 result.put("format", "<LEVEL>TIMESTAMP PROP(HOSTNAME) MESSAGE"); 141 return result; 142 } 143 144 /** 145 * Create a SyslogLayout. 146 * @param facility The Facility is used to try to classify the message. 147 * @param includeNL If true a newline will be appended to the result. 148 * @param escapeNL Pattern to use for replacing newlines. 149 * @param charsetName The character set. 150 * @return A SyslogLayout. 151 */ 152 @PluginFactory 153 public static SyslogLayout createLayout(@PluginAttr("facility") final String facility, 154 @PluginAttr("newLine") final String includeNL, 155 @PluginAttr("newLineEscape") final String escapeNL, 156 @PluginAttr("charset") final String charsetName) { 157 final Charset charset = Charsets.getSupportedCharset(charsetName); 158 final boolean includeNewLine = includeNL == null ? false : Boolean.valueOf(includeNL); 159 final Facility f = Facility.toFacility(facility, Facility.LOCAL0); 160 return new SyslogLayout(f, includeNewLine, escapeNL, charset); 161 } 162 }