Matthias Andreas Benkard | b8fbc37 | 2021-05-11 06:50:45 +0200 | [diff] [blame] | 1 | package eu.mulk.quarkus.googlecloud.jsonlogging; |
Matthias Andreas Benkard | c8144a9 | 2021-05-03 08:04:53 +0200 | [diff] [blame] | 2 | |
| 3 | import java.io.PrintWriter; |
| 4 | import java.io.StringWriter; |
Matthias Andreas Benkard | b8fbc37 | 2021-05-11 06:50:45 +0200 | [diff] [blame] | 5 | import java.util.ArrayList; |
Matthias Andreas Benkard | 82d7e44 | 2021-08-29 08:34:11 +0200 | [diff] [blame] | 6 | import java.util.Collection; |
Matthias Andreas Benkard | c8144a9 | 2021-05-03 08:04:53 +0200 | [diff] [blame] | 7 | import java.util.HashMap; |
Matthias Andreas Benkard | b8fbc37 | 2021-05-11 06:50:45 +0200 | [diff] [blame] | 8 | import java.util.List; |
| 9 | import java.util.Map; |
Matthias Andreas Benkard | 93ecfd1 | 2022-01-15 14:03:41 +0100 | [diff] [blame] | 10 | import java.util.ServiceLoader; |
Matthias Andreas Benkard | 348f205 | 2022-01-15 16:13:01 +0100 | [diff] [blame^] | 11 | import java.util.ServiceLoader.Provider; |
Matthias Andreas Benkard | c8144a9 | 2021-05-03 08:04:53 +0200 | [diff] [blame] | 12 | import java.util.logging.Level; |
Matthias Andreas Benkard | 348f205 | 2022-01-15 16:13:01 +0100 | [diff] [blame^] | 13 | import java.util.stream.Collectors; |
Matthias Andreas Benkard | c8144a9 | 2021-05-03 08:04:53 +0200 | [diff] [blame] | 14 | import org.jboss.logmanager.ExtFormatter; |
| 15 | import org.jboss.logmanager.ExtLogRecord; |
| 16 | |
| 17 | /** |
| 18 | * Formats log records as JSON for consumption by Google Cloud Logging. |
| 19 | * |
| 20 | * <p>Meant to be used in containers running on Google Kubernetes Engine (GKE). |
| 21 | * |
Matthias Andreas Benkard | b8fbc37 | 2021-05-11 06:50:45 +0200 | [diff] [blame] | 22 | * @see LogEntry |
Matthias Andreas Benkard | c8144a9 | 2021-05-03 08:04:53 +0200 | [diff] [blame] | 23 | */ |
Matthias Andreas Benkard | c066d89 | 2021-05-11 21:27:23 +0200 | [diff] [blame] | 24 | public class Formatter extends ExtFormatter { |
Matthias Andreas Benkard | c8144a9 | 2021-05-03 08:04:53 +0200 | [diff] [blame] | 25 | |
| 26 | private static final String TRACE_LEVEL = "TRACE"; |
| 27 | private static final String DEBUG_LEVEL = "DEBUG"; |
| 28 | private static final String INFO_LEVEL = "INFO"; |
| 29 | private static final String WARNING_LEVEL = "WARNING"; |
| 30 | private static final String ERROR_LEVEL = "ERROR"; |
| 31 | |
| 32 | private static final String ERROR_EVENT_TYPE = |
| 33 | "type.googleapis.com/google.devtools.clouderrorreporting.v1beta1.ReportedErrorEvent"; |
| 34 | |
Matthias Andreas Benkard | 692f48d | 2021-08-31 21:06:50 +0200 | [diff] [blame] | 35 | private final List<StructuredParameterProvider> parameterProviders; |
| 36 | private final List<LabelProvider> labelProviders; |
Matthias Andreas Benkard | 82d7e44 | 2021-08-29 08:34:11 +0200 | [diff] [blame] | 37 | |
Matthias Andreas Benkard | 42da9f1 | 2021-09-02 18:47:28 +0200 | [diff] [blame] | 38 | /** |
Matthias Andreas Benkard | 348f205 | 2022-01-15 16:13:01 +0100 | [diff] [blame^] | 39 | * Constructs a {@link Formatter} with custom configuration. |
Matthias Andreas Benkard | 42da9f1 | 2021-09-02 18:47:28 +0200 | [diff] [blame] | 40 | * |
Matthias Andreas Benkard | 93ecfd1 | 2022-01-15 14:03:41 +0100 | [diff] [blame] | 41 | * <p><strong>Note:</strong> This constructor does not automatically discover providers using the |
| 42 | * {@link ServiceLoader} mechanism. See {@link #load} for this case use. |
| 43 | * |
Matthias Andreas Benkard | 42da9f1 | 2021-09-02 18:47:28 +0200 | [diff] [blame] | 44 | * @param parameterProviders the {@link StructuredParameterProvider}s to apply to each log entry. |
| 45 | * @param labelProviders the {@link LabelProvider}s to apply to each log entry. |
| 46 | */ |
Matthias Andreas Benkard | 692f48d | 2021-08-31 21:06:50 +0200 | [diff] [blame] | 47 | public Formatter( |
| 48 | Collection<StructuredParameterProvider> parameterProviders, |
| 49 | Collection<LabelProvider> labelProviders) { |
Matthias Andreas Benkard | 82d7e44 | 2021-08-29 08:34:11 +0200 | [diff] [blame] | 50 | this.parameterProviders = List.copyOf(parameterProviders); |
Matthias Andreas Benkard | 692f48d | 2021-08-31 21:06:50 +0200 | [diff] [blame] | 51 | this.labelProviders = List.copyOf(labelProviders); |
Matthias Andreas Benkard | 82d7e44 | 2021-08-29 08:34:11 +0200 | [diff] [blame] | 52 | } |
| 53 | |
Matthias Andreas Benkard | 93ecfd1 | 2022-01-15 14:03:41 +0100 | [diff] [blame] | 54 | /** |
| 55 | * Constructs a {@link Formatter} with parameter and label providers supplied by {@link |
| 56 | * ServiceLoader}. |
| 57 | * |
| 58 | * <p>In addition to the providers supplied as parameters, this factory method loads all {@link |
| 59 | * StructuredParameterProvider}s and {@link LabelProvider}s found through the {@link |
| 60 | * ServiceLoader} mechanism. |
| 61 | * |
| 62 | * @param parameterProviders the {@link StructuredParameterProvider}s to apply to each log entry. |
| 63 | * @param labelProviders the {@link LabelProvider}s to apply to each log entry. |
Matthias Andreas Benkard | 348f205 | 2022-01-15 16:13:01 +0100 | [diff] [blame^] | 64 | * @return a new formatter. |
Matthias Andreas Benkard | 93ecfd1 | 2022-01-15 14:03:41 +0100 | [diff] [blame] | 65 | */ |
| 66 | public static Formatter load( |
| 67 | Collection<StructuredParameterProvider> parameterProviders, |
| 68 | Collection<LabelProvider> labelProviders) { |
| 69 | parameterProviders = new ArrayList<>(parameterProviders); |
Matthias Andreas Benkard | 348f205 | 2022-01-15 16:13:01 +0100 | [diff] [blame^] | 70 | parameterProviders.addAll(loadStructuredParameterProviders()); |
Matthias Andreas Benkard | 93ecfd1 | 2022-01-15 14:03:41 +0100 | [diff] [blame] | 71 | |
| 72 | labelProviders = new ArrayList<>(labelProviders); |
Matthias Andreas Benkard | 348f205 | 2022-01-15 16:13:01 +0100 | [diff] [blame^] | 73 | labelProviders.addAll(loadLabelProviders()); |
Matthias Andreas Benkard | 93ecfd1 | 2022-01-15 14:03:41 +0100 | [diff] [blame] | 74 | |
| 75 | return new Formatter(parameterProviders, labelProviders); |
| 76 | } |
| 77 | |
Matthias Andreas Benkard | 348f205 | 2022-01-15 16:13:01 +0100 | [diff] [blame^] | 78 | private static List<StructuredParameterProvider> loadStructuredParameterProviders() { |
| 79 | return ServiceLoader.load(StructuredParameterProvider.class, Formatter.class.getClassLoader()) |
| 80 | .stream() |
| 81 | .map(Provider::get) |
| 82 | .collect(Collectors.toList()); |
| 83 | } |
| 84 | |
| 85 | private static List<LabelProvider> loadLabelProviders() { |
| 86 | return ServiceLoader.load(LabelProvider.class, Formatter.class.getClassLoader()).stream() |
| 87 | .map(Provider::get) |
| 88 | .collect(Collectors.toList()); |
| 89 | } |
| 90 | |
Matthias Andreas Benkard | c8144a9 | 2021-05-03 08:04:53 +0200 | [diff] [blame] | 91 | @Override |
| 92 | public String format(ExtLogRecord logRecord) { |
| 93 | var message = formatMessageWithStackTrace(logRecord); |
| 94 | |
Matthias Andreas Benkard | b8fbc37 | 2021-05-11 06:50:45 +0200 | [diff] [blame] | 95 | List<StructuredParameter> parameters = new ArrayList<>(); |
| 96 | Map<String, String> labels = new HashMap<>(); |
Matthias Andreas Benkard | 82d7e44 | 2021-08-29 08:34:11 +0200 | [diff] [blame] | 97 | |
| 98 | for (var parameterProvider : parameterProviders) { |
Matthias Andreas Benkard | 692f48d | 2021-08-31 21:06:50 +0200 | [diff] [blame] | 99 | var parameter = parameterProvider.getParameter(); |
Matthias Andreas Benkard | 82d7e44 | 2021-08-29 08:34:11 +0200 | [diff] [blame] | 100 | if (parameter != null) { |
| 101 | parameters.add(parameter); |
| 102 | } |
| 103 | } |
| 104 | |
Matthias Andreas Benkard | 692f48d | 2021-08-31 21:06:50 +0200 | [diff] [blame] | 105 | for (var labelProvider : labelProviders) { |
| 106 | var providedLabels = labelProvider.getLabels(); |
| 107 | if (providedLabels != null) { |
| 108 | for (var label : providedLabels) { |
| 109 | labels.put(label.key(), label.value()); |
| 110 | } |
| 111 | } |
| 112 | } |
| 113 | |
Matthias Andreas Benkard | c8144a9 | 2021-05-03 08:04:53 +0200 | [diff] [blame] | 114 | if (logRecord.getParameters() != null) { |
| 115 | for (var parameter : logRecord.getParameters()) { |
Matthias Andreas Benkard | 121a631 | 2021-05-12 05:41:25 +0200 | [diff] [blame] | 116 | if (parameter instanceof StructuredParameter) { |
| 117 | parameters.add((StructuredParameter) parameter); |
| 118 | } else if (parameter instanceof Label) { |
| 119 | var label = (Label) parameter; |
Matthias Andreas Benkard | c8144a9 | 2021-05-03 08:04:53 +0200 | [diff] [blame] | 120 | labels.put(label.key(), label.value()); |
| 121 | } |
| 122 | } |
| 123 | } |
| 124 | |
| 125 | var mdc = logRecord.getMdcCopy(); |
| 126 | var ndc = logRecord.getNdc(); |
| 127 | |
| 128 | var sourceLocation = |
Matthias Andreas Benkard | b8fbc37 | 2021-05-11 06:50:45 +0200 | [diff] [blame] | 129 | new LogEntry.SourceLocation( |
Matthias Andreas Benkard | 4bae5f1 | 2021-05-03 19:16:48 +0200 | [diff] [blame] | 130 | logRecord.getSourceFileName(), |
| 131 | String.valueOf(logRecord.getSourceLineNumber()), |
| 132 | String.format( |
| 133 | "%s.%s", logRecord.getSourceClassName(), logRecord.getSourceMethodName())); |
Matthias Andreas Benkard | c8144a9 | 2021-05-03 08:04:53 +0200 | [diff] [blame] | 134 | |
| 135 | var entry = |
Matthias Andreas Benkard | b8fbc37 | 2021-05-11 06:50:45 +0200 | [diff] [blame] | 136 | new LogEntry( |
Matthias Andreas Benkard | c8144a9 | 2021-05-03 08:04:53 +0200 | [diff] [blame] | 137 | message, |
| 138 | severityOf(logRecord.getLevel()), |
Matthias Andreas Benkard | b8fbc37 | 2021-05-11 06:50:45 +0200 | [diff] [blame] | 139 | new LogEntry.Timestamp(logRecord.getInstant()), |
Matthias Andreas Benkard | c8144a9 | 2021-05-03 08:04:53 +0200 | [diff] [blame] | 140 | null, |
| 141 | null, |
| 142 | sourceLocation, |
Matthias Andreas Benkard | b8fbc37 | 2021-05-11 06:50:45 +0200 | [diff] [blame] | 143 | labels, |
| 144 | parameters, |
| 145 | mdc, |
| 146 | ndc, |
Matthias Andreas Benkard | c8144a9 | 2021-05-03 08:04:53 +0200 | [diff] [blame] | 147 | logRecord.getLevel().intValue() >= 1000 ? ERROR_EVENT_TYPE : null); |
| 148 | |
Matthias Andreas Benkard | b8fbc37 | 2021-05-11 06:50:45 +0200 | [diff] [blame] | 149 | return entry.json().build().toString() + "\n"; |
Matthias Andreas Benkard | c8144a9 | 2021-05-03 08:04:53 +0200 | [diff] [blame] | 150 | } |
| 151 | |
| 152 | /** |
| 153 | * Formats the log message corresponding to {@code logRecord} including a stack trace of the |
| 154 | * {@link ExtLogRecord#getThrown()} exception if any. |
| 155 | */ |
| 156 | private String formatMessageWithStackTrace(ExtLogRecord logRecord) { |
| 157 | var messageStringWriter = new StringWriter(); |
| 158 | var messagePrintWriter = new PrintWriter(messageStringWriter); |
| 159 | messagePrintWriter.append(this.formatMessage(logRecord)); |
| 160 | |
| 161 | if (logRecord.getThrown() != null) { |
| 162 | messagePrintWriter.println(); |
| 163 | logRecord.getThrown().printStackTrace(messagePrintWriter); |
| 164 | } |
| 165 | |
| 166 | messagePrintWriter.close(); |
| 167 | return messageStringWriter.toString(); |
| 168 | } |
| 169 | |
Matthias Andreas Benkard | 4bae5f1 | 2021-05-03 19:16:48 +0200 | [diff] [blame] | 170 | /** Computes the Google Cloud Logging severity corresponding to a given {@link Level}. */ |
Matthias Andreas Benkard | c8144a9 | 2021-05-03 08:04:53 +0200 | [diff] [blame] | 171 | private static String severityOf(Level level) { |
| 172 | if (level.intValue() < 500) { |
| 173 | return TRACE_LEVEL; |
| 174 | } else if (level.intValue() < 700) { |
| 175 | return DEBUG_LEVEL; |
| 176 | } else if (level.intValue() < 900) { |
| 177 | return INFO_LEVEL; |
| 178 | } else if (level.intValue() < 1000) { |
| 179 | return WARNING_LEVEL; |
| 180 | } else { |
| 181 | return ERROR_LEVEL; |
| 182 | } |
| 183 | } |
| 184 | } |