Revamp Configuration page

src/site/antora/modules/ROOT/examples/configuration/arbiters-select.json

@@ -0,0 +1,29 @@
+{
+  "Configuration": {
+    "Appenders": {
+      "File": {
+        "name": "MAIN",
+        "Select": {
+          "SystemPropertyArbiter": { // <1>
+            "propertyName": "env",
+            "propertyValue": "dev",
+            "PatternLayout": {
+              "pattern": "%d [%t] %p %c - %m%n"
+            }
+          },
+          "DefaultArbiter": { // <2>
+            "JsonTemplateLayout": {}
+          }
+        }
+      }
+    },
+    "Loggers": {
+      "Root": {
+        "level": "INFO",
+        "AppenderRef": {
+          "ref": "MAIN"
+        }
+      }
+    }
+  }
+}

src/site/antora/modules/ROOT/examples/configuration/arbiters-select.properties

@@ -0,0 +1,31 @@
+#
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements.  See the NOTICE file distributed with
+# this work for additional information regarding copyright ownership.
+# The ASF licenses this file to you under the Apache License, Version 2.0
+# (the "License"); you may not use this file except in compliance with
+# the License.  You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+appender.0.type = File
+appender.0.name = MAIN
+appender.0.select.type = Select
+
+appender.0.select.0.type = SystemPropertyArbiter # <1>
+appender.0.select.0.propertyName = env
+appender.0.select.0.propertyValue = dev
+appender.0.select.0.layout.type = PatternLayout
+appender.0.select.0.layout.pattern = %d [%t] %p %c - %m%n
+
+appender.0.select.1.type = DefaultArbiter # <2>
+appender.0.select.1.layout.type = JsonTemplateLayout
+
+rootLogger.level = INFO
+rootLogger.appenderRef.0.ref = MAIN

src/site/antora/modules/ROOT/examples/configuration/arbiters-select.xml

@@ -0,0 +1,38 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+  ~ Licensed to the Apache Software Foundation (ASF) under one or more
+  ~ contributor license agreements.  See the NOTICE file distributed with
+  ~ this work for additional information regarding copyright ownership.
+  ~ The ASF licenses this file to you under the Apache License, Version 2.0
+  ~ (the "License"); you may not use this file except in compliance with
+  ~ the License.  You may obtain a copy of the License at
+  ~
+  ~      http://www.apache.org/licenses/LICENSE-2.0
+  ~
+  ~ Unless required by applicable law or agreed to in writing, software
+  ~ distributed under the License is distributed on an "AS IS" BASIS,
+  ~ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  ~ See the License for the specific language governing permissions and
+  ~ limitations under the License.
+  -->
+<Configuration xmlns="https://logging.apache.org/xml/ns"
+               xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+               xsi:schemaLocation="https://logging.apache.org/xml/ns https://logging.apache.org/xml/ns/log4j-config-2.xsd">
+  <Appenders>
+    <File name="MAIN" fileName="logs/app.log">
+      <Select>
+        <SystemPropertyArbiter propertyName="env" propertyValue="dev"> <!--1-->
+          <PatternLayout pattern="%d [%t] %p %c - %m%n"/>
+        </SystemPropertyArbiter>
+        <DefaultArbiter> <!--2-->
+          <JsonTemplateLayout/>
+        </DefaultArbiter>
+      </Select>
+    </File>
+  </Appenders>
+  <Loggers>
+    <Root level="INFO">
+      <AppenderRef ref="MAIN"/>
+    </Root>
+  </Loggers>
+</Configuration>

src/site/antora/modules/ROOT/examples/configuration/arbiters-select.yaml

@@ -0,0 +1,34 @@
+#
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements.  See the NOTICE file distributed with
+# this work for additional information regarding copyright ownership.
+# The ASF licenses this file to you under the Apache License, Version 2.0
+# (the "License"); you may not use this file except in compliance with
+# the License.  You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+Configuration:
+  Appenders:
+    File:
+      name: "MAIN"
+      fileName: "logs/app.log"
+      Select:
+        SystemPropertyArbiter: # <1>
+          propertyName: "env"
+          propertyValue: "dev"
+          PatternLayout:
+            pattern: "%d [%t] %p %c - %m%n"
+        DefaultArbiter: # <2>
+          JsonTemplateLayout: { }
+  Loggers:
+    Root:
+      level: "INFO"
+      AppenderRef:
+        ref: "MAIN"

src/site/antora/modules/ROOT/examples/configuration/arbiters.json

@@ -0,0 +1,33 @@
+{
+  "Configuration": {
+    "Appenders": {
+      "File": {
+        "name": "MAIN",
+        "SystemPropertyArbiter": [
+          // <1>
+          {
+            "propertyName": "env",
+            "propertyValue": "dev",
+            "PatternLayout": {
+              "pattern": "%d [%t] %p %c - %m%n"
+            }
+          },
+          // <2>
+          {
+            "propertyName": "env",
+            "propertyValue": "prod",
+            "JsonTemplateLayout": {}
+          }
+        ]
+      }
+    },
+    "Loggers": {
+      "Root": {
+        "level": "INFO",
+        "AppenderRef": {
+          "ref": "MAIN"
+        }
+      }
+    }
+  }
+}

src/site/antora/modules/ROOT/examples/configuration/arbiters.properties

@@ -0,0 +1,32 @@
+#
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements.  See the NOTICE file distributed with
+# this work for additional information regarding copyright ownership.
+# The ASF licenses this file to you under the Apache License, Version 2.0
+# (the "License"); you may not use this file except in compliance with
+# the License.  You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+appender.0.type = File
+appender.0.name = MAIN
+
+appender.0.arbiter[0].type = SystemPropertyArbiter # <1>
+appender.0.arbiter[0].propertyName = env
+appender.0.arbiter[0].propertyValue = dev
+appender.0.arbiter[0].layout.type = PatternLayout
+appender.0.arbiter[0].layout.pattern = %d [%t] %p %c - %m%n
+
+appender.0.arbiter[1].type = SystemPropertyArbiter # <2>
+appender.0.arbiter[1].propertyName = env
+appender.0.arbiter[1].propertyValue = prod
+appender.0.arbiter[1].layout.type = JsonTemplateLayout
+
+rootLogger.level = INFO
+rootLogger.appenderRef.0.ref = MAIN

src/site/antora/modules/ROOT/examples/configuration/arbiters.xml

@@ -0,0 +1,36 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+  ~ Licensed to the Apache Software Foundation (ASF) under one or more
+  ~ contributor license agreements.  See the NOTICE file distributed with
+  ~ this work for additional information regarding copyright ownership.
+  ~ The ASF licenses this file to you under the Apache License, Version 2.0
+  ~ (the "License"); you may not use this file except in compliance with
+  ~ the License.  You may obtain a copy of the License at
+  ~
+  ~      http://www.apache.org/licenses/LICENSE-2.0
+  ~
+  ~ Unless required by applicable law or agreed to in writing, software
+  ~ distributed under the License is distributed on an "AS IS" BASIS,
+  ~ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  ~ See the License for the specific language governing permissions and
+  ~ limitations under the License.
+  -->
+<Configuration xmlns="https://logging.apache.org/xml/ns"
+               xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+               xsi:schemaLocation="https://logging.apache.org/xml/ns https://logging.apache.org/xml/ns/log4j-config-2.xsd">
+  <Appenders>
+    <File name="MAIN" fileName="logs/app.log">
+      <SystemPropertyArbiter propertyName="env" propertyValue="dev"> <!--1-->
+        <PatternLayout pattern="%d [%t] %p %c - %m%n"/>
+      </SystemPropertyArbiter>
+      <SystemPropertyArbiter propertyName="env" propertyValue="prod"> <!--2-->
+        <JsonTemplateLayout/>
+      </SystemPropertyArbiter>
+    </File>
+  </Appenders>
+  <Loggers>
+    <Root level="INFO">
+      <AppenderRef ref="MAIN"/>
+    </Root>
+  </Loggers>
+</Configuration>

src/site/antora/modules/ROOT/examples/configuration/arbiters.yaml

@@ -0,0 +1,34 @@
+#
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements.  See the NOTICE file distributed with
+# this work for additional information regarding copyright ownership.
+# The ASF licenses this file to you under the Apache License, Version 2.0
+# (the "License"); you may not use this file except in compliance with
+# the License.  You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+Configuration:
+  Appenders:
+    File:
+      name: "MAIN"
+      fileName: "logs/app.log"
+      SystemPropertyArbiter:
+        - propertyName: "env" # <1>
+          propertyValue: "dev"
+          PatternLayout:
+            pattern: "%d [%t] %p %c - %m%n"
+        - propertyName: "env" # <2>
+          propertyValue: "prod"
+          JsonTemplateLayout: { }
+  Loggers:
+    Root:
+      level: "INFO"
+      AppenderRef:
+        ref: "MAIN"

src/site/antora/modules/ROOT/examples/configuration/filters.json

@@ -0,0 +1,37 @@
+{
+  "Configuration": {
+    "Appenders": {
+      "Console": {
+        "name": "CONSOLE",
+        "ThresholdFilter": {
+          "level": "WARN" // <6>
+        }
+      }
+    },
+    "Loggers": {
+      "Root": {
+        "level": "INFO",
+        "ThresholdFilter": { // <3>
+          "level": "DEBUG"
+        },
+        "AppenderRef": {
+          "ref": "CONSOLE",
+          "level": "WARN", // <5>
+          "MarkerFilter": { // <4>
+            "marker": "ALERT",
+            "onMatch": "NEUTRAL",
+            "onMismatch": "DENY"
+          }
+        }
+      },
+      "Logger": {
+        "name": "org.example",
+        "level": "TRACE" // <2>
+      }
+    }
+  },
+  "MarkerFilter": { // <1>
+    "marker": "PRIVATE",
+    "onMismatch": "NEUTRAL"
+  }
+}

src/site/antora/modules/ROOT/examples/configuration/filters.properties

@@ -0,0 +1,39 @@
+#
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements.  See the NOTICE file distributed with
+# this work for additional information regarding copyright ownership.
+# The ASF licenses this file to you under the Apache License, Version 2.0
+# (the "License"); you may not use this file except in compliance with
+# the License.  You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+appender.0.type = Console
+appender.0.name = CONSOLE
+appender.0.filter.type = ThresholdFilter # <6>
+appender.0.filter.level = WARN
+
+rootLogger.level = INFO
+rootLogger.filter.type = ThresholdFilter # <3>
+rootLogger.filter.level = DEBUG
+rootLogger.appenderRef.0.ref = CONSOLE
+rootLogger.appenderRef.0.level = WARN # <5>
+rootLogger.appenderRef.0.filter.type = MarkerFilter # <4>
+rootLogger.appenderRef.0.filter.marker = ALERT
+rootLogger.appenderRef.0.filter.onMatch = NEUTRAL
+rootLogger.appenderRef.0.filter.onMismatch = DENY
+
+logger.0.name = org.example
+logger.0.level = DEBUG # <2>
+logger.0.filter.type = ThresholdFilter # <3>
+logger.0.filter.level = TRACE
+
+filter.type = MarkerFilter # <1>
+filter.marker = PRIVATE
+filter.onMismatch = NEUTRAL

src/site/antora/modules/ROOT/examples/configuration/filters.xml

@@ -0,0 +1,40 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+  ~ Licensed to the Apache Software Foundation (ASF) under one or more
+  ~ contributor license agreements.  See the NOTICE file distributed with
+  ~ this work for additional information regarding copyright ownership.
+  ~ The ASF licenses this file to you under the Apache License, Version 2.0
+  ~ (the "License"); you may not use this file except in compliance with
+  ~ the License.  You may obtain a copy of the License at
+  ~
+  ~      http://www.apache.org/licenses/LICENSE-2.0
+  ~
+  ~ Unless required by applicable law or agreed to in writing, software
+  ~ distributed under the License is distributed on an "AS IS" BASIS,
+  ~ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  ~ See the License for the specific language governing permissions and
+  ~ limitations under the License.
+  -->
+<Configuration xmlns="https://logging.apache.org/xml/ns"
+               xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+               xsi:schemaLocation="https://logging.apache.org/xml/ns https://logging.apache.org/xml/ns/log4j-config-2.xsd">
+  <Appenders>
+    <Console name="CONSOLE">
+      <ThresholdFilter level="WARN"/> <!--6-->
+    </Console>
+  </Appenders>
+  <Loggers>
+    <Root level="INFO">
+      <ThresholdFilter level="DEBUG"/> <!--3-->
+      <AppenderRef ref="CONSOLE" level="WARN"> <!--5-->
+        <MarkerFilter marker="ALERT"
+                      onMatch="NEUTRAL"
+                      onMismatch="DENY"/> <!--4-->
+      </AppenderRef>
+    </Root>
+    <Logger name="org.example" level="TRACE"> <!--2-->
+      <ThresholdFilter level="TRACE"/> <!--3-->
+    </Logger>
+  </Loggers>
+  <MarkerFilter marker="PRIVATE" onMismatch="NEUTRAL"/> <!--1-->
+</Configuration>