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    }