In Log4j2, come si associa uno schema XML con log4j2.xml?

Question

Ho dato il via al nuovo Log4j2. Sembra, dal documentation on migration, che lo schema XML/DTD sia stato eliminato.

Sembra un passo indietro. Sicuramente dovrebbe essere possibile associare uno schema XML o un DTD con il mio log4j2.xml per facilitare la scrittura e la convalida. Non sono stato in grado di trovare nulla di utile nella documentazione, né ho trovato lo schema XML o DTD stesso.

Quindi: in Log4j2, come dovrei associare uno schema XML con log4j2.xml?

Answer 1

Non penso sia possibile avere uno schema/DTD con log4j2. Recentemente ho scritto un appender personalizzato, e per sostenere l'appender miei log4j2.xml si presenta così:

<?xml version="1.0" encoding="UTF-8"?> 
<configuration status="ERROR" packages="package.same.as.custom.appender"> 
    <appenders> 
    <CyclicBuffer name="CyclicBuffer" bufferSize="200"> 
     <PatternLayout pattern="%d{yyyy-MM-dd HH:mm:ss.SSS} %-5level [%t] %c{1.} - %msg%n"/> 
    </CyclicBuffer> 
    </appenders> 
    <loggers> 
    <root level="info"> 
     <appender-ref ref="CyclicBuffer"/> 
    </root> 
    </loggers> 
</configuration> 

Le cose importanti da notare sono che ho un elemento completamente personalizzato CyclicBuffer, e che ha un completamente attributo personalizzato bufferSize. Dai un'occhiata alla documentazione che circonda @PluginFactory e @Plugin per maggiori dettagli.

A causa di questa personalizzazione, non penso che l'XML possa essere convalidato tramite un comune XSD/DTD comune. Invece, penso che dovrai creare il tuo XSD se vuoi convalidare l'XML.

Una cosa importante da notare, è che nel mio XML ho: <configuration status="ERROR". Quando questo è presente, log4j2 genererà tutti gli errori associati alla configurazione errata in fase di esecuzione. Anche se non è conveniente come la convalida XML, è anche molto utile!

Spero che questo sia di qualche aiuto, Muel.

Answer 2

Non riesco a trovare un riferimento a XSD sul sito Web Log4J2, ma se scarichi il 2.0 beta 5, troverai che contiene uno schema Log4J 2 (Log4J-V2.0.xsd) nel percorso core/src/main/resources.

Come affermato da Muel, è possibile avere degli appendici personalizzati. Per questo motivo, credo che funzionerebbe solo se si utilizza strict = "true" nel nodo di configurazione principale.

See: http://logging.apache.org/log4j/2.x/manual/configuration.html#ConfigurationSyntax

Ho usato l'attributo dello schema di aggiungere questo per la configurazione e sembra funzionare per lo più.

Ecco un esempio:

<configuration name="testConfiguration" 
    status="debug" 
    strict="true" 
    monitorInterval="30" 
    schema="Log4J-V2.0.xsd"> 

Dico "per lo più", perché uno dei problemi che ho trovato che anche alcuni attributi validi documentati (per esempio monitorInterval) mancano dal XSD.

Speriamo che con le versioni future sia disponibile un XSD accurato del formato rigoroso.

Spero che questo sia di qualche aiuto.

-Steve

Aggiornato: Vedi LOG4J2-170 concernete una questione con la convalida XSD

Answer 3

Si prega di rileggere la documentazione Log4J2 circa XML configuration e troverete questi 2 posti:

Log4j può essere configurato utilizzando due sapori XML; conciso e rigoroso. Il formato conciso semplifica la configurazione poiché i nomi degli elementi corrispondono ai componenti che rappresentano ma non possono essere convalidati con uno schema XML. Ad esempio, ConsoleAppender viene configurato dichiarando un elemento XML denominato Console sotto l'elemento appendici principale. Tuttavia, i nomi di elementi e attributi non sono case sensitive. Inoltre, gli attributi possono essere specificati come un attributo XML o come un elemento XML che non ha attributi e ha un valore di testo.

e un po 'più avanti:

XML Strict. Oltre al formato XML conciso sopra, Log4j consente di specificare le configurazioni in un modo XML più "normale" che può essere convalidato con uno schema XML utilizzando uno schema XML. Questo si ottiene rimpiazzando i nomi degli elementi amici sopra con il loro tipo di oggetto come mostrato sotto. Ad esempio, invece che ConsoleAppender viene configurato utilizzando un elemento denominato Console, viene configurato come elemento di un appender con un attributo type che contiene "Console".

Quindi , se si desidera utilizzare la convalida dello schema XML per Log4j2 quindi utilizzare solo il formato XML Strict.

Answer 4

funziona per me con Eclipse:

<Configuration strict="true" 
      xmlns="http://logging.apache.org/log4j/2.0/config" 
      xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
      xsi:schemaLocation="http://logging.apache.org/log4j/2.0/config 
      https://raw.githubusercontent.com/apache/logging-log4j2/master/log4j-core/src/main/resources/Log4j-config.xsd"> 

o contro versione tag:

<Configuration strict="true" 
      xmlns="http://logging.apache.org/log4j/2.0/config" 
      xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
      xsi:schemaLocation="http://logging.apache.org/log4j/2.0/config 
      https://raw.githubusercontent.com/apache/logging-log4j2/log4j-2.8.2/log4j-core/src/main/resources/Log4j-config.xsd">